diff options
author | Eli Zaretskii <eliz@gnu.org> | 2021-03-28 16:26:21 +0300 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2021-03-28 16:26:21 +0300 |
commit | bcc4cc3362fdb0f2b299087af5e7b31b92862fbb (patch) | |
tree | 34d874c4756a5af0d1b506433b4bc32efb9c1d9b | |
parent | bf6442fafddf7228362975bd16286c68ee5ce85b (diff) | |
download | emacs-bcc4cc3362fdb0f2b299087af5e7b31b92862fbb.tar.gz |
Doc fixes for 'face-foreground' and 'face-background'.
* lisp/faces.el (face-foreground, face-background): Clarify how a
face specified in INHERIT arg is used. (Bug#47437)
-rw-r--r-- | lisp/faces.el | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/lisp/faces.el b/lisp/faces.el index 1813f8f7365..794343e88a9 100644 --- a/lisp/faces.el +++ b/lisp/faces.el @@ -503,7 +503,8 @@ If INHERIT is t, and FACE doesn't define a foreground color, then any foreground color that FACE inherits through its `:inherit' attribute is considered as well; however the return value may still be nil. If INHERIT is a face or a list of faces, then it is used to try to - resolve an unspecified foreground color. + resolve an unspecified foreground color, in addition to using any +inherited color. To ensure that a valid color is always returned, use a value of `default' for INHERIT; this will resolve any unspecified values by @@ -523,7 +524,8 @@ If INHERIT is t, and FACE doesn't define a background color, then any background color that FACE inherits through its `:inherit' attribute is considered as well; however the return value may still be nil. If INHERIT is a face or a list of faces, then it is used to try to - resolve an unspecified background color. + resolve an unspecified background color, in addition to using any +inherited color. To ensure that a valid color is always returned, use a value of `default' for INHERIT; this will resolve any unspecified values by |