procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

(Multiline Font Lock): Rephrase some parts for clarity.

Browse source
This commit is contained in:
Stefan Monnier 2006-11-23 18:36:22 +00:00
parent 312d24fbde
commit 6b28caea07
2 changed files with 16 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
lispref/ChangeLog
View file

@ -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

21
lispref/modes.texi
View file

@ -3067,16 +3067,19 @@ will rehighlight the whole construct if any part of it is changed. In
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 @@ handle the case where highlighting depends on subsequent lines.
@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.