diff options
author | Eli Zaretskii <eliz@gnu.org> | 2022-07-03 12:30:24 +0300 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2022-07-03 12:30:24 +0300 |
commit | 45badeceecab5e5975d2e1700fce819acd34a964 (patch) | |
tree | 8d98c493e4b4b8a59f125a654023a792844e3667 /doc | |
parent | 94d43f4942feff16a85786bcee67f551ccbbbe40 (diff) | |
download | emacs-45badeceecab5e5975d2e1700fce819acd34a964.tar.gz |
Implement pseudo-value 'reset' of face attrributes
* doc/lispref/display.texi (Face Attributes):
* etc/NEWS: Document the new pseudo-value 'reset'.
* src/xfaces.c (realize_named_face, lookup_derived_face)
(gui_supports_face_attributes_p, lookup_named_face)
(Finternal_merge_in_global_face, merge_named_face, merge_faces):
Handle the 'reset' pseudo-value of a face's attribute.
(syms_of_xfaces): New symbol 'reset'.
(RESET_P): New macro.
(check_lface_attrs, Finternal_set_lisp_face_attribute): Allow
'reset' as a value of any attribute except ':inherit'.
(Bug#38771)
Diffstat (limited to 'doc')
-rw-r--r-- | doc/lispref/display.texi | 9 |
1 files changed, 8 insertions, 1 deletions
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 81799a2a577..08bf7441df0 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -2474,6 +2474,7 @@ Otherwise, it returns @code{nil}. The following table lists all the face attributes, their possible values, and their effects. +@cindex unspecified, face attribute value Apart from the values given below, each face attribute can have the value @code{unspecified}. This special value means that the face doesn't specify that attribute directly. An @code{unspecified} @@ -2482,7 +2483,13 @@ description @code{:inherit} attribute below); or, failing that, to an underlying face (@pxref{Displaying Faces}). (However, @code{unspecified} is not a valid value in @code{defface}.) - The @code{default} face must specify all attributes. +@cindex reset, face attribute value + A face attribute can also have the value @code{reset}. This special +value stands for the value of the corresponding attribute of the +@code{default} face. + + The @code{default} face must explicitly specify all attributes, and +cannot use the special value @code{reset}. Some of these attributes are meaningful only on certain kinds of displays. If your display cannot handle a certain attribute, the |