[Emacs-diffs] Changes to emacs/lispref/modes.texi,v

[Stefan Monnier]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Stefan Monnier <monnier>        06/11/19 19:27:29

Index: modes.texi
===================================================================
RCS file: /sources/emacs/emacs/lispref/modes.texi,v
retrieving revision 1.156
retrieving revision 1.157
diff -u -b -r1.156 -r1.157
--- modes.texi  16 Oct 2006 18:54:26 -0000      1.156
+++ modes.texi  19 Nov 2006 19:27:29 -0000      1.157
@@ -3043,16 +3043,19 @@
 
 @itemize
 @item
-Place a @code{font-lock-multiline}
-property on the construct when it is added to the buffer.
address@hidden
-Use @code{font-lock-fontify-region-function} hook to extend the scan
-so that the scanned text never starts or ends in the middle of a
-multiline construct.
address@hidden
 Add a function to @code{font-lock-extend-region-functions} that does
 the @emph{identification} and extends the scan so that the scanned
 text never starts or ends in the middle of a multiline construct.
address@hidden
+Use the @code{font-lock-fontify-region-function} hook similarly to
+extend the scan so that the scanned text never starts or ends in the
+middle of a multiline construct.
address@hidden
+Somehow identify the multiline construct right when it gets inserted
+into the buffer (or at any point after that but before font-lock
+tries to highlight it), and mark it with a @code{font-lock-multiline}
+which will instruct font-lock not to start or end the scan in the
+middle of the construct.
 @end itemize
 
   There are three ways to do rehighlighting of multiline constructs:
@@ -3062,9 +3065,9 @@
 Place a @code{font-lock-multiline} property on the construct.  This
 will rehighlight the whole construct if any part of it is changed.  In
 some cases you can do this automatically by setting the
address@hidden variable.
address@hidden variable, which see.
 @item
-Use @code{jit-lock-contextually}.  This will only rehighlight the part
+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