]> code.delx.au - gnu-emacs/commitdiff
Doc fix for `face-spec-set'.
authorXue Fuqiao <xfq@gnu.org>
Fri, 28 Feb 2014 04:15:21 +0000 (12:15 +0800)
committerXue Fuqiao <xfq@gnu.org>
Fri, 28 Feb 2014 04:15:21 +0000 (12:15 +0800)
* doc/lispref/display.texi (Defining Faces): Doc fix for
  `face-spec-set'.

* etc/NEWS: Copyedit.

doc/lispref/ChangeLog
doc/lispref/display.texi
etc/NEWS

index 650f97375d6122f05df0594080683f48c5e0b679..b7148b921865eb766c86cb2ef89cc9634baed1d2 100644 (file)
@@ -1,5 +1,7 @@
 2014-02-28  Xue Fuqiao  <xfq@gnu.org>
 
+       * display.texi (Defining Faces): Doc fix for `face-spec-set'.
+
        * elisp.texi (Top):
        * commands.texi (Generic Commands):
        (Defining Commands): Document `define-alternatives'.
index 496fbf87041d6ca0ac3dbe1a1dcfc30c96b0d4ba..9aae04ae32a591fd8622015a0cdd1f1d4d3051d9 100644 (file)
@@ -2359,16 +2359,20 @@ This function applies @var{spec} as a face spec for @code{face}.
 @var{spec} should be a face spec, as described in the above
 documentation for @code{defface}.
 
+This function also defines @var{face} as a valid face name if it is
+not already one, and (re)calculates its attributes on existing frames.
+
 @cindex override spec @r{(for a face)}
 The argument @var{spec-type} determines which spec to set.  If it is
 @code{nil} or @code{face-override-spec}, this function sets the
 @dfn{override spec}, which overrides over all other face specs on
-@var{face}.  If it is @code{face-defface-spec}, this function sets the
-default face spec (the same one set by @code{defface}).  If it is
-@code{reset}, this function clears out all customization specs and
-override specs from @var{face} (in this case, the value of @var{spec}
-is ignored).  Any other value of @var{spec-type} is reserved for
-internal use.
+@var{face}.  If it is @code{customized-face} or @code{saved-face},
+this function sets the customized spec or the saved custom spec.  If
+it is @code{face-defface-spec}, this function sets the default face
+spec (the same one set by @code{defface}).  If it is @code{reset},
+this function clears out all customization specs and override specs
+from @var{face} (in this case, the value of @var{spec} is ignored).
+Any other value of @var{spec-type} is reserved for internal use.
 @end defun
 
 @node Attribute Functions
index 3d45dfb8011d2ae26a083def9bd25e8d38ae36ff..befe939a0e02d0fb3c3a8b243bd38f8c2af9a480 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -278,6 +278,13 @@ buffer.
 `display-buffer' choose or make a window at the bottom of the selected
 frame.
 
+*** New display action function `display-buffer-no-window' to not
+display the buffer in a window.
+
+*** New display action alist entry `allow-no-window' to indicate the
+caller of `display-buffer' is ready to handle the case of not
+displaying the buffer in a window.
+
 ** Lisp evaluation changes
 +++
 *** `eval-defun' on an already defined defcustom calls the :set function,
@@ -1224,15 +1231,6 @@ frame.
 *** The hook `term-setup-hook' is obsolete.  It is entirely equivalent
 to `emacs-startup-hook'.  See also the new `tty-setup-hook'.
 
-** Window Handling
-
-*** New display action function `display-buffer-no-window' to not
-display the buffer in a window.
-
-*** New display action alist entry `allow-no-window' to indicate the
-caller of `display-buffer' is ready to handle the case of not
-displaying the buffer in a window.
-
 ** New hook `pre-redisplay-function'.
 
 +++
@@ -1353,6 +1351,7 @@ of remote files when set to non-nil.
 
 ** Face changes
 
++++
 *** The function `face-spec-set' is now like `setq' for face specs.
 Its third arg now accepts values specifying a face spec type (defface,
 custom, or override spec), and the relevant spec is set accordingly.