From: Lars Magne Ingebrigtsen <larsi@gnus.org>
Date: Sat, 7 Jan 2012 06:00:56 +0000 (+0100)
Subject: * faces.el (set-face-attribute): Clarify the meaning of the nil frame.
X-Git-Tag: emacs-pretest-24.0.93~97^2~55^2~7
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=29232a68e057e6fe47508f24e2fe713ae0cfa0c3;p=emacs.git

* faces.el (set-face-attribute): Clarify the meaning of the nil frame.

Fixes: debbugs:10294
---

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index d0ab5d2f2f9..18605c2735c 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,8 @@
 2012-01-07  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
+	* faces.el (set-face-attribute): Clarify the meaning of the nil
+	frame (bug#10294).
+
 	* subr.el (with-selected-frame): Mention that the selected frame
 	is restored (bug#9980).
 
diff --git a/lisp/faces.el b/lisp/faces.el
index 86c9c8a669e..5d406ad7c0b 100644
--- a/lisp/faces.el
+++ b/lisp/faces.el
@@ -557,9 +557,10 @@ If FACE is a face-alias, get the documentation for the target face."
 (defun set-face-attribute (face frame &rest args)
   "Set attributes of FACE on FRAME from ARGS.
 
-FRAME nil means change attributes on all frames.  FRAME t means change
-the default for new frames (this is done automatically each time an
-attribute is changed on all frames).
+If FRAME is nil this function sets the attributes for all
+existing frames, and the default for new frames.  If FRAME is t,
+change the default for new frames (this is done automatically
+each time an attribute is changed on all frames).
 
 ARGS must come in pairs ATTRIBUTE VALUE.  ATTRIBUTE must be a valid
 face attribute name.  All attributes can be set to `unspecified';