diff options
author | Eli Zaretskii <eliz@gnu.org> | 2019-05-04 09:52:11 +0300 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2019-05-04 09:52:11 +0300 |
commit | e93d651b492bdf4432d5ea8b885de93a171c8dd5 (patch) | |
tree | 484369d583e71afba0ff49e3306909101f70eb53 /src/xfaces.c | |
parent | b5376e0ebd7b62f00c1b64aef87cd8d96cfbc71a (diff) | |
download | emacs-e93d651b492bdf4432d5ea8b885de93a171c8dd5.tar.gz |
; * src/xfaces.c (merge_face_ref): Improve commentary.
Diffstat (limited to 'src/xfaces.c')
-rw-r--r-- | src/xfaces.c | 18 |
1 files changed, 10 insertions, 8 deletions
diff --git a/src/xfaces.c b/src/xfaces.c index 7e04c0e9953..5c2414b7b0e 100644 --- a/src/xfaces.c +++ b/src/xfaces.c @@ -2265,11 +2265,12 @@ filter_face_ref (Lisp_Object face_ref, } /* Merge face attributes from the lisp `face reference' FACE_REF on - frame F into the face attribute vector TO. If ERR_MSGS, - problems with FACE_REF cause an error message to be shown. Return - true if no errors occurred (regardless of the value of ERR_MSGS). - Use NAMED_MERGE_POINTS to detect loops in face inheritance or - list structure; it may be 0 for most callers. + frame F into the face attribute vector TO as appropriate for + window W; W is used only for filtering face specs. If ERR_MSGS + is non-zero, problems with FACE_REF cause an error message to be + shown. Return true if no errors occurred (regardless of the value + of ERR_MSGS). Use NAMED_MERGE_POINTS to detect loops in face + inheritance or list structure; it may be 0 for most callers. FACE_REF may be a single face specification or a list of such specifications. Each face specification can be: @@ -2286,9 +2287,10 @@ filter_face_ref (Lisp_Object face_ref, 4. Conses of the form (:filtered (:window PARAMETER VALUE) FACE-SPECIFICATION), - which applies FACE-SPECIFICATION only if the - given face attributes are being evaluated in the context of a - window with a parameter named PARAMETER being EQ VALUE. + which applies FACE-SPECIFICATION only if the given face attributes + are being evaluated in the context of a window with a parameter + named PARAMETER being EQ VALUE. In this case, W specifies the window + for which the filtered face spec is to be evaluated. 5. nil, which means to merge nothing. |