--- Begin Message ---
Subject: |
[PATCH] Point out the default value of FRAME in the `set-face-*' functions. |
Date: |
Fri, 4 Nov 2016 13:29:10 -0700 |
---
Feel free to make changes.
doc/lispref/ChangeLog.1 | 5 +++++
doc/lispref/display.texi | 4 ++--
2 files changed, 7 insertions(+), 2 deletions(-)
diff --git a/doc/lispref/ChangeLog.1 b/doc/lispref/ChangeLog.1
index 610e7541e7de..e492a607368d 100644
--- a/doc/lispref/ChangeLog.1
+++ b/doc/lispref/ChangeLog.1
@@ -1,3 +1,8 @@
+2016-11-04 Hong Xu <address@hidden>
+
+ * display.texi (Attribute Functions): Point out the default value
+ of FRAME in the various `set-face-*` functions.
+
2015-03-29 Glenn Morris <address@hidden>
* objects.texi (Equality Predicates): Fix typo in example.
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 2e316f8a532c..b19bfa9ef5c2 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2644,8 +2644,8 @@ Attribute Functions
The following commands and functions mostly provide compatibility
with old versions of Emacs. They work by calling
address@hidden Values of @code{t} and @code{nil} for
-their @var{frame} argument are handled just like
address@hidden Values of @code{t} and @code{nil}
+(default) for their @var{frame} argument are handled just like
@code{set-face-attribute} and @code{face-attribute}. The commands
read their arguments using the minibuffer, if called interactively.
--- End Message ---
--- Begin Message ---
Subject: |
Re: bug#24879: [PATCH] Point out the default value of FRAME in the `set-face-*' functions. |
Date: |
Sat, 05 Nov 2016 10:56:00 +0200 |
> From: Hong Xu <address@hidden>
> Cc: address@hidden
> Date: Sat, 05 Nov 2016 01:17:38 -0700
>
> Despite that, I sort of see some confusion in the doc when mentioning
> optional args: Sometimes we say "omitted or nil" (e.g.,
> face-all-attributes FRAME arg), sometimes we just say "nil" (e.g.,
> face-attribute FRAME arg). Perhaps more consistency is less confusing.
Thanks, I made sure we mention this consistently in that node.
--- End Message ---