From: Lars Ingebrigtsen Date: Thu, 4 Nov 2021 17:58:21 +0000 (+0100) Subject: Document that `unspecified' isn't valid in defface X-Git-Tag: emacs-29.0.90~3671^2~250 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=824a139434855919073d6ea3c93d57ebd24fc75c;p=emacs.git Document that `unspecified' isn't valid in defface * doc/lispref/display.texi (Face Attributes): Mention that unspecified isn't valid in defface (bug#51595). --- diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index aacbcaf6c3b..279b79a5b5d 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -2428,8 +2428,10 @@ value @code{unspecified}. This special value means that the face doesn't specify that attribute directly. An @code{unspecified} attribute tells Emacs to refer instead to a parent face (see the description @code{:inherit} attribute below); or, failing that, to an -underlying face (@pxref{Displaying Faces}). The @code{default} face -must specify all attributes. +underlying face (@pxref{Displaying Faces}). (However, +@code{unspecified} is not a valid value in @code{defface}.) + + The @code{default} face must specify all attributes. Some of these attributes are meaningful only on certain kinds of displays. If your display cannot handle a certain attribute, the