GNU bug report logs - #36647
26.1; Please align examples of search-based fontification with recommendations

Previous Next

Full log

View this message in rfc822 format

From: "Basil L. Contovounesios" <contovob <at> tcd.ie>
To: Glenn Morris <rgm <at> gnu.org>
Cc: 36647-done <at> debbugs.gnu.org, Markus Triska <triska <at> metalevel.at>
Subject: bug#36647: 26.1; Please align examples of search-based fontification with recommendations
Date: Wed, 17 Jul 2019 12:02:12 +0100

tags 36647 notabug
close 36647
quit

Glenn Morris <rgm <at> 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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.