Commit c02f8fe2 authored by Alan Mackenzie's avatar Alan Mackenzie
Browse files

display.texi (Auto Faces): Say fontification-functions is called

whether or not Font Lock is enabled.  Tidy up the wording a bit.
parent a292592c
2010-01-28 Alan Mackenzie <acm@muc.de>
* display.texi (Auto Faces): Say fontification-functions is called
whether or not Font Lock is enabled. Tidy up the wording a bit.
2010-01-17 Chong Yidong <cyd@stupidchicken.com> 2010-01-17 Chong Yidong <cyd@stupidchicken.com>
* elisp.texi: Remove duplicate edition information (Bug#5407). * elisp.texi: Remove duplicate edition information (Bug#5407).
......
...@@ -2654,23 +2654,25 @@ Font-Lock. ...@@ -2654,23 +2654,25 @@ Font-Lock.
@defvar fontification-functions @defvar fontification-functions
This variable holds a list of functions that are called by Emacs This variable holds a list of functions that are called by Emacs
redisplay as needed to assign faces automatically to text in the buffer. redisplay as needed, just before doing redisplay. They are called even
when Font Lock Mode isn't enabled. When Font Lock Mode is enabled, this
variable usually holds just one function, @code{jit-lock-function}.
The functions are called in the order listed, with one argument, a The functions are called in the order listed, with one argument, a
buffer position @var{pos}. Each function should attempt to assign faces buffer position @var{pos}. Collectively they should attempt to assign
to the text in the current buffer starting at @var{pos}. faces to the text in the current buffer starting at @var{pos}.
Each function should record the faces they assign by setting the The functions should record the faces they assign by setting the
@code{face} property. It should also add a non-@code{nil} @code{face} property. They should also add a non-@code{nil}
@code{fontified} property for all the text it has assigned faces to. @code{fontified} property to all the text they have assigned faces to.
That property tells redisplay that faces have been assigned to that text That property tells redisplay that faces have been assigned to that text
already. already.
It is probably a good idea for each function to do nothing if the It is probably a good idea for the functions to do nothing if the
character after @var{pos} already has a non-@code{nil} @code{fontified} character after @var{pos} already has a non-@code{nil} @code{fontified}
property, but this is not required. If one function overrides the property, but this is not required. If one function overrides the
assignments made by a previous one, the properties as they are assignments made by a previous one, the properties after the last
after the last function finishes are the ones that really matter. function finishes are the ones that really matter.
For efficiency, we recommend writing these functions so that they For efficiency, we recommend writing these functions so that they
usually assign faces to around 400 to 600 characters at each call. usually assign faces to around 400 to 600 characters at each call.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment