changeset 74140:cedd7f653426

(Multiline Font Lock): Rephrase some parts for clarity.
author Stefan Monnier <monnier@iro.umontreal.ca>
date Thu, 23 Nov 2006 18:36:22 +0000
parents f61bc15684bb
children e10391aa221e
files lispref/ChangeLog lispref/modes.texi
diffstat 2 files changed, 16 insertions(+), 9 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/ChangeLog	Thu Nov 23 18:34:44 2006 +0000
+++ b/lispref/ChangeLog	Thu Nov 23 18:36:22 2006 +0000
@@ -1,3 +1,7 @@
+2006-11-23  Stefan Monnier  <monnier@iro.umontreal.ca>
+
+	* modes.texi (Multiline Font Lock): Rephrase some parts for clarity.
+
 2006-11-10  Jan Dj,Ad(Brv  <jan.h.d@swipnet.se>
 
 	* frames.texi (Window System Selections): Remove clipboard from
--- a/lispref/modes.texi	Thu Nov 23 18:34:44 2006 +0000
+++ b/lispref/modes.texi	Thu Nov 23 18:36:22 2006 +0000
@@ -3067,16 +3067,19 @@
 some cases you can do this automatically by setting the
 @code{font-lock-multiline} variable, which see.
 @item
-Rely on @code{jit-lock-contextually}.  This will only rehighlight the part
-of the construct that follows the actual change, and will do it after
-a short delay.  This only works if the highlighting of the various
-parts of your multiline construct never depends on text in subsequent
-lines.  Since @code{jit-lock-contextually} is activated by default,
-this can be an attractive solution.
+Make sure @code{jit-lock-contextually} is set and rely on it doing its
+job.  This will only rehighlight the part of the construct that
+follows the actual change, and will do it after a short delay.
+This only works if the highlighting of the various parts of your
+multiline construct never depends on text in subsequent lines.
+Since @code{jit-lock-contextually} is activated by default, this can
+be an attractive solution.
 @item
 Place a @code{jit-lock-defer-multiline} property on the construct.
-This works only if @code{jit-lock-contextually} is used, but it can
-handle the case where highlighting depends on subsequent lines.
+This works only if @code{jit-lock-contextually} is used, and with the
+same delay before rehighlighting, but like @code{font-lock-multiline},
+it also handles the case where highlighting depends on
+subsequent lines.
 @end itemize
 
 @menu
@@ -3089,7 +3092,7 @@
 @subsubsection Font Lock Multiline
 
   One way to ensure reliable rehighlighting of multiline Font Lock
-constructs is to put on the text property @code{font-lock-multiline}.
+constructs is to put on them the text property @code{font-lock-multiline}.
 It should be present and non-@code{nil} for text that is part of a
 multiline construct.