mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2025-01-17 17:58:46 +00:00
Code Issues Releases Activity

* modes.texi (Precalculated Fontification): Clarify text.

Browse Source
This commit is contained in:
Richard M. Stallman 2009-05-17 16:09:22 +00:00
parent b87661795f
commit eae7d8f84e
2 changed files with 18 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
doc/lispref/ChangeLog
View File

@ -1,3 +1,7 @@
2009-05-17 Richard M Stallman <rms@gnu.org>
* modes.texi (Precalculated Fontification): Clarify text.
2009-05-17 Martin Rudalics <rudalics@gmx.at>
* windows.texi (Selecting Windows): Clarify descriptions of

25
doc/lispref/modes.texi
View File

@ -2864,18 +2864,21 @@ wherever they appear.
@node Precalculated Fontification
@subsection Precalculated Fontification
In addition to using @code{font-lock-defaults} for search-based
fontification, you may use the special character property
@code{font-lock-face} (@pxref{Special Properties}). This property
acts just like the explicit @code{face} property, but its activation
is toggled when the user calls @kbd{M-x font-lock-mode}. Using
@code{font-lock-face} is especially convenient for special modes
which construct their text programmatically, such as
@code{list-buffers} and @code{occur}.
Some major modes such as @code{list-buffers} and @code{occur}
construct the buffer text programmatically. The easiest way for them
to support Font Lock mode is to specify the faces of text when they
insert the text in the buffer.
If your mode does not use any of the other machinery of Font Lock
(i.e. it only uses the @code{font-lock-face} property), it should not
set the variable @code{font-lock-defaults}.
The way to do this is to specify the faces in the text with the
special text property @code{font-lock-face} (@pxref{Special
Properties}). When Font Lock mode is enabled, this property controls
the display, just like the @code{face} property. When Font Lock mode
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
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
@code{font-lock-defaults}.
@node Faces for Font Lock
@subsection Faces for Font Lock