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

Fixes: debbugs:10294

1 files changed, 4 insertions, 3 deletions

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';