comparison lispref/modes.texi @ 74083:a71f63e8ff3f

Rephrase some font-lock-multiline text.

74082:d34e01c317dc

  There are three ways to ensure correct identification of multiline
constructs:

@itemize
@item
Place a @code{font-lock-multiline}
property on the construct when it is added to the buffer.
@item
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.
@item
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.
@end itemize

  There are three ways to do rehighlighting of multiline constructs:

@itemize
@item
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
@code{font-lock-multiline} variable.
@item
Use @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.

74083:a71f63e8ff3f

  There are three ways to ensure correct identification of multiline
constructs:

@itemize
@item
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.
@item
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.
@item
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:

@itemize
@item
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
@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.