[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#36647: 26.1; Please align examples of search-based fontification wit
From: |
Basil L. Contovounesios |
Subject: |
bug#36647: 26.1; Please align examples of search-based fontification with recommendations |
Date: |
Wed, 17 Jul 2019 12:02:12 +0100 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) |
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