From: Alan Mackenzie Date: Thu, 28 Jan 2010 16:24:50 +0000 (+0000) Subject: display.texi (Auto Faces): Say fontification-functions is called X-Git-Tag: emacs-pretest-23.1.92~17 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c02f8fe2f1761e6d432fe5716959ce3b27feaff2;p=emacs.git display.texi (Auto Faces): Say fontification-functions is called whether or not Font Lock is enabled. Tidy up the wording a bit. --- diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 2f5923fb8f1..58c801f5cae 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog @@ -1,3 +1,8 @@ +2010-01-28 Alan Mackenzie + + * 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 * elisp.texi: Remove duplicate edition information (Bug#5407). diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 9c1db3d276f..5f2e4f874a8 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi @@ -2654,23 +2654,25 @@ Font-Lock. @defvar fontification-functions 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 -buffer position @var{pos}. Each function should attempt to assign faces -to the text in the current buffer starting at @var{pos}. +buffer position @var{pos}. Collectively they should attempt to assign +faces to the text in the current buffer starting at @var{pos}. -Each function should record the faces they assign by setting the -@code{face} property. It should also add a non-@code{nil} -@code{fontified} property for all the text it has assigned faces to. +The functions should record the faces they assign by setting the +@code{face} property. They should also add a non-@code{nil} +@code{fontified} property to all the text they have assigned faces to. That property tells redisplay that faces have been assigned to that text 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} property, but this is not required. If one function overrides the -assignments made by a previous one, the properties as they are -after the last function finishes are the ones that really matter. +assignments made by a previous one, the properties after the last +function finishes are the ones that really matter. For efficiency, we recommend writing these functions so that they usually assign faces to around 400 to 600 characters at each call.