# HG changeset patch # User Stefan Monnier # Date 1164306982 0 # Node ID cedd7f65342654df8180c2f21e791d694de43531 # Parent f61bc15684bb99d4ca9d92bcf25e11a44ec9214d (Multiline Font Lock): Rephrase some parts for clarity. diff -r f61bc15684bb -r cedd7f653426 lispref/ChangeLog --- 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 + + * modes.texi (Multiline Font Lock): Rephrase some parts for clarity. + 2006-11-10 Jan Dj,Ad(Brv * frames.texi (Window System Selections): Remove clipboard from diff -r f61bc15684bb -r cedd7f653426 lispref/modes.texi --- 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.