mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-30 19:53:09 +00:00
Code Issues Releases Activity

; * src/xfaces.c (merge_face_ref): Improve commentary.

Browse Source
This commit is contained in:
Eli Zaretskii 2019-05-04 09:52:11 +03:00
parent b5376e0ebd
commit e93d651b49
1 changed files with 10 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
src/xfaces.c
View File

@ -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.