From 8ba2808bb6fd49fea9db521aaab4b588a56a46dd Mon Sep 17 00:00:00 2001 From: Stefan Monnier Date: Thu, 30 Oct 2003 22:15:20 +0000 Subject: [PATCH] Document the existance of font-lock-syntactic-face-function and font-lock-multiline. --- lispref/modes.texi | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/lispref/modes.texi b/lispref/modes.texi index 0668e04c172..7c32b713261 100644 --- a/lispref/modes.texi +++ b/lispref/modes.texi @@ -2161,7 +2161,11 @@ Its value should have one of the forms described in this table. to match text which spans lines; this does not work reliably. While @code{font-lock-fontify-buffer} handles multi-line patterns correctly, updating when you edit the buffer does not, since it considers text one -line at a time. +line at a time. If you have patterns that typically only span one +line but can occasionally span two or three, such as +@samp{...}, you can ask font-lock to be more careful by +setting @code{font-lock-multiline} to @code{t}. But it still will not +work in all cases. @node Other Font Lock Variables @subsection Other Font Lock Variables @@ -2231,6 +2235,20 @@ well, you must specify them in a @var{facename} in @code{font-lock-keywords} as well as adding them to this list. @end defvar +@defvar font-lock-syntactic-face-function +A function to determine which face to use for a given syntactic +element (a string or a comment). The function is called with one +argument, the parse state at point returned by +@code{parse-partial-sexp}, and should return a face. The default +value returns @code{font-lock-comment-face} for comments and +@code{font-lock-string-face} for strings. + +This can be used to highlighting different kinds of strings or +comments differently. It is also sometimes abused together with +@code{font-lock-syntactic-keywords} to highlight elements that span +multiple lines, but this is too obscure to document in this manual. +@end defvar + @node Levels of Font Lock @subsection Levels of Font Lock -- 2.39.2