mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2025-12-19 04:10:18 -08:00
Code Issues Projects Releases Wiki Activity

Recommend using font-lock-face over face (Bug#35044)

Browse source 
* doc/lispref/modes.texi (Precalculated Fontification): Explain
advantages of using font-lock-face over face.
This commit is contained in:
Noam Postavsky 2019-04-19 00:55:14 -04:00
parent 7cb5364ef5
commit 140e7f890f
1 changed files with 6 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

7
doc/lispref/modes.texi
View file

@ -3201,7 +3201,12 @@ is disabled, @code{font-lock-face} has no effect on the display.
It is ok for a mode to use @code{font-lock-face} for some text and It is ok for a mode to use @code{font-lock-face} for some text and
also use the normal Font Lock machinery. But if the mode does not use also use the normal Font Lock machinery. But if the mode does not use
the normal Font Lock machinery, it should not set the variable the normal Font Lock machinery, it should not set the variable
@code{font-lock-defaults}. @code{font-lock-defaults}. In this case the @code{face} property will
not be overriden, so using the @code{face} property could work too.
However, using @code{font-lock-face} is generally preferable as it
allows the user to control the fontification by toggling
@code{font-lock-mode}, and lets the code work regardless of whether
the mode uses Font Lock machinery or not.
@node Faces for Font Lock @node Faces for Font Lock
@subsection Faces for Font Lock @subsection Faces for Font Lock