Next: Levels of Font Lock, Previous: Customizing Keywords, Up: Font Lock Mode
This section describes additional variables that a major mode can
set by means of other-vars in font-lock-defaults
(see Font Lock Basics).
If this variable is non-
nil
, it should be a function that is called with no arguments, to choose an enclosing range of text for refontification for the command M-o M-o (font-lock-fontify-block
).The function should report its choice by placing the region around it. A good choice is a range of text large enough to give proper results, but not too large so that refontification becomes slow. Typical values are
mark-defun
for programming modes ormark-paragraph
for textual modes.
This variable specifies additional properties (other than
font-lock-face
) that are being managed by Font Lock mode. It is used byfont-lock-default-unfontify-region
, which normally only manages thefont-lock-face
property. If you want Font Lock to manage other properties as well, you must specify them in a facespec infont-lock-keywords
as well as add them to this list. See Search-based Fontification.
Function to use for fontifying the buffer. The default value is
font-lock-default-fontify-buffer
.
Function to use for unfontifying the buffer. This is used when turning off Font Lock mode. The default value is
font-lock-default-unfontify-buffer
.
Function to use for fontifying a region. It should take two arguments, the beginning and end of the region, and an optional third argument verbose. If verbose is non-
nil
, the function should print status messages. The default value isfont-lock-default-fontify-region
.
Function to use for unfontifying a region. It should take two arguments, the beginning and end of the region. The default value is
font-lock-default-unfontify-region
.
This function tells Font Lock mode to run the Lisp function function any time it has to fontify or refontify part of the current buffer. It calls function before calling the default fontification functions, and gives it two arguments, start and end, which specify the region to be fontified or refontified.
The optional argument contextual, if non-
nil
, forces Font Lock mode to always refontify a syntactically relevant part of the buffer, and not just the modified lines. This argument can usually be omitted.