[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: |
Markus Triska |
Subject: |
bug#36647: 26.1; Please align examples of search-based fontification with recommendations |
Date: |
Sun, 14 Jul 2019 11:10:31 +0200 |
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)
The docstring of font-lock-keywords also repeatedly mentions fubar-face
as example:
(\"fubar\" . fubar-face)
Occurrences of \"fubar\" in the value of `fubar-face'.
To ensure exemplary face names and internal consistency of the manual,
it seems appropriate to change the example face names to names that are
in alignment with the manual's recommendations.
For instance, the cited examples could maybe be changed, respectively, to
;; Highlight occurrences of ‘fubar’,
;; using the face which is the value of ‘fubar’.
("fubar" . fubar)
and:
(\"fubar\" . fubar)
Occurrences of \"fubar\" in the value of the face `fubar'.
to follow the recommendations?
Thank you and all the best,
Markus
In GNU Emacs 26.1 (build 1, x86_64-apple-darwin15.3.0, X toolkit, Xaw scroll
bars)
of 2018-09-22 built on laptop
Windowing system distributor 'The X.Org Foundation', version 11.0.11502000
- bug#36647: 26.1; Please align examples of search-based fontification with recommendations,
Markus Triska <=