comparison lispref/modes.texi @ 62652:e89d01c0c1c4

(Font Lock Basics, Syntactic Font Lock): Recommend syntax-begin-function over font-lock-beginning-of-syntax-function.

62651:8d965863dd8c

. @var{string})}.  These are used to set up a syntax table for
syntactic fontification (@pxref{Syntax Table Functions}).  The
resulting syntax table is stored in @code{font-lock-syntax-table}.

The fifth element, @var{syntax-begin}, specifies the value of
@code{font-lock-beginning-of-syntax-function}.

All the remaining elements (if any) are collectively called
@var{other-vars}.  Each of these elements should have the form
@code{(@var{variable} . @var{value})}---which means, make
@var{variable} buffer-local and then set it to @var{value}.  You can

This variable holds the syntax table to use for fontification of
comments and strings.  Specify it using @var{syntax-alist} in
@code{font-lock-defaults}.
@end defvar

@c ???
@c The docstring says that font-lock-syntax-table is semi-obsolete.
@c How the alternative should be used is not clear.  --lute

@defvar font-lock-beginning-of-syntax-function
If this variable is non-@code{nil}, it should be a function to move
point back to a position that is syntactically at ``top level'' and
outside of strings or comments.  Font Lock uses this when necessary
to get the right results for syntactic fontification.

the beginning of any enclosing syntactic block.  Typical values are
@code{beginning-of-line} (used when the start of the line is known to
be outside a syntactic block), or @code{beginning-of-defun} for
programming modes, or @code{backward-paragraph} for textual modes.

If the value is @code{nil}, the beginning of the buffer is used as a
position outside of a syntactic block.  This cannot be wrong, but it
can be slow.

Specify this variable using @var{syntax-begin} in
@code{font-lock-defaults}.
@end defvar

62652:e89d01c0c1c4

. @var{string})}.  These are used to set up a syntax table for
syntactic fontification (@pxref{Syntax Table Functions}).  The
resulting syntax table is stored in @code{font-lock-syntax-table}.

The fifth element, @var{syntax-begin}, specifies the value of
@code{font-lock-beginning-of-syntax-function}.  We recommend setting
this variable to @code{nil} and using @code{syntax-begin-function}
instead.

All the remaining elements (if any) are collectively called
@var{other-vars}.  Each of these elements should have the form
@code{(@var{variable} . @var{value})}---which means, make
@var{variable} buffer-local and then set it to @var{value}.  You can

This variable holds the syntax table to use for fontification of
comments and strings.  Specify it using @var{syntax-alist} in
@code{font-lock-defaults}.
@end defvar

@defvar font-lock-beginning-of-syntax-function
If this variable is non-@code{nil}, it should be a function to move
point back to a position that is syntactically at ``top level'' and
outside of strings or comments.  Font Lock uses this when necessary
to get the right results for syntactic fontification.

the beginning of any enclosing syntactic block.  Typical values are
@code{beginning-of-line} (used when the start of the line is known to
be outside a syntactic block), or @code{beginning-of-defun} for
programming modes, or @code{backward-paragraph} for textual modes.

If the value is @code{nil}, Font Lock uses
@code{syntax-begin-function} to move back outside of any comment,
string, or sexp.  This variable is semi-obsolete; we recommend setting
@code{syntax-begin-function} instead.

Specify this variable using @var{syntax-begin} in
@code{font-lock-defaults}.
@end defvar