[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#36647: 26.1; Please align examples of search-based fontification wit
Basil L. Contovounesios
bug#36647: 26.1; Please align examples of search-based fontification with recommendations
Wed, 17 Jul 2019 12:02:12 +0100
Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux)
tags 36647 notabug
Glenn Morris <address@hidden> writes:
> Markus Triska wrote:
>> In 39.12.2 Defining Faces, the documentation of defface includes the text:
>> "You should not quote the symbol FACE, and
>> it should not end in '-face' (that would be redundant)."
>> Yet, 23.6.2 Search-based Fontification repeatedly mentions fubar-face as
>> example face, and its name does end in -face:
>> ;; Highlight occurrences of 'fubar',
>> ;; using the face which is the value of 'fubar-face'.
>> ("fubar" . fubar-face)
> fubar-face is not a face, but a variable whose value is a face.
> Thus, there is no inconsistency here.
Indeed, as the line immediately preceding the citation explains:
‘(MATCHER . FACESPEC)’
In this kind of element, FACESPEC is an expression whose value
specifies the face to use for highlighting. In the simplest case,
FACESPEC is a Lisp variable (a symbol) whose value is a face name.
So I'm closing this report.