From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Doc patch for `fontification-functions': [was: Is there something like `on-display-functions'?] Date: Thu, 28 Jan 2010 20:38:39 +0200 Message-ID: <83636m3wi8.fsf@gnu.org> References: <20100127135716.GA3432@muc.de> <20100127153733.GD3432@muc.de> <20100128113056.GE2285@muc.de> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org X-Trace: ger.gmane.org 1264703957 22772 80.91.229.12 (28 Jan 2010 18:39:17 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 28 Jan 2010 18:39:17 +0000 (UTC) Cc: lennart.borgman@gmail.com, monnier@iro.umontreal.ca, emacs-devel@gnu.org To: Alan Mackenzie Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 28 19:39:13 2010 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1NaZGq-0002SS-QC for ged-emacs-devel@m.gmane.org; Thu, 28 Jan 2010 19:39:13 +0100 Original-Received: from localhost ([127.0.0.1]:54040 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NaZGp-00011P-OQ for ged-emacs-devel@m.gmane.org; Thu, 28 Jan 2010 13:39:11 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NaZGl-00010g-HM for emacs-devel@gnu.org; Thu, 28 Jan 2010 13:39:07 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NaZGg-00010E-U3 for emacs-devel@gnu.org; Thu, 28 Jan 2010 13:39:07 -0500 Original-Received: from [199.232.76.173] (port=47405 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NaZGg-00010A-Qt for emacs-devel@gnu.org; Thu, 28 Jan 2010 13:39:02 -0500 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:45881) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1NaZGg-0004mi-Bf for emacs-devel@gnu.org; Thu, 28 Jan 2010 13:39:02 -0500 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0KWY00B00Z5MNG00@a-mtaout22.012.net.il> for emacs-devel@gnu.org; Thu, 28 Jan 2010 20:38:35 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([77.127.180.161]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0KWY002B1ZS8H7P0@a-mtaout22.012.net.il>; Thu, 28 Jan 2010 20:38:34 +0200 (IST) In-reply-to: <20100128113056.GE2285@muc.de> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by monty-python.gnu.org: Solaris 10 (beta) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:120596 Archived-At: > Date: Thu, 28 Jan 2010 11:30:56 +0000 > From: Alan Mackenzie > Cc: Lennart Borgman , 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.