Re: Doc patch for `fontification-functions': [was: Is there something like `on-display-functions'?]

[Eli Zaretskii <eliz@gnu.org>]

> Date: Thu, 28 Jan 2010 11:30:56 +0000
> From: Alan Mackenzie <acm@muc.de>
> Cc: Lennart Borgman <lennart.borgman@gmail.com>, emacs-devel@gnu.org
> 
> On Wed, Jan 27, 2010 at 03:37:33PM +0000, Alan Mackenzie wrote:
> 
> > The documentation (elisp manual) and doc string for this are poor.
> > They only say what you should use the hook for, not when it's called.
> > In particular, they don't say explicitly what happens when font lock
> > isn't enabled, or when a different font-lock-support-mode is active.
> > I take it the hook is called regardless of these things.
> 
> Here's a patch to fix this.

Thanks.

>   @defvar fontification-functions
>   This variable holds a list of functions that are called by Emacs
> ! redisplay as needed, just before doing redisplay.  They are called even

I suggest to rephrase:

 This variable holds a list of functions that Emacs calls as part of
 doing redisplay.

This (a) avoids passive tense, (b) does not use "redisplay" twice in 2
different senses, and (3) is more accurate, because "just before doing
redisplay" is factually incorrect.