aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/lispref/display.texi24
1 files changed, 14 insertions, 10 deletions
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index aa75dcf5a0a..4a895f74a5d 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -2531,16 +2531,20 @@ This function also defines @var{face} as a valid face name if it is
2531not already one, and (re)calculates its attributes on existing frames. 2531not already one, and (re)calculates its attributes on existing frames.
2532 2532
2533@cindex override spec @r{(for a face)} 2533@cindex override spec @r{(for a face)}
2534The argument @var{spec-type} determines which spec to set. If it is 2534The optional argument @var{spec-type} determines which spec to set.
2535@code{nil} or @code{face-override-spec}, this function sets the 2535If it is omitted or @code{nil} or @code{face-override-spec}, this
2536@dfn{override spec}, which overrides over all other face specs on 2536function sets the @dfn{override spec}, which overrides face specs on
2537@var{face}. If it is @code{customized-face} or @code{saved-face}, 2537@var{face} of all the other types mentioned below. This is useful
2538this function sets the customized spec or the saved custom spec. If 2538when calling this function outside of Custom code. If @var{spec-type}
2539it is @code{face-defface-spec}, this function sets the default face 2539is @code{customized-face} or @code{saved-face}, this function sets the
2540spec (the same one set by @code{defface}). If it is @code{reset}, 2540customized spec or the saved custom spec, respectively. If it is
2541this function clears out all customization specs and override specs 2541@code{face-defface-spec}, this function sets the default face spec
2542from @var{face} (in this case, the value of @var{spec} is ignored). 2542(the same one set by @code{defface}). If it is @code{reset}, this
2543Any other value of @var{spec-type} is reserved for internal use. 2543function clears out all customization specs and override specs from
2544@var{face} (in this case, the value of @var{spec} is ignored). The
2545effect of any other value of @var{spec-type} on the face specs is
2546reserved for internal use, but the function will still define
2547@var{face} itself and recalculate its attributes, as described above.
2544@end defun 2548@end defun
2545 2549
2546@node Attribute Functions 2550@node Attribute Functions