bug#36647: 26.1; Please align examples of search-based fontification with recommendations

[Basil L. Contovounesios]

tags 36647 notabug
close 36647
quit

Glenn Morris <rgm@gnu.org> 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.

Thanks,

-- 
Basil