X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/ac3232837188f7e1c4ffe34b76edede0ccb54f5e..62e8099cd382e50cd83c20cf56cadd17bc536ede:/doc/lispref/syntax.texi diff --git a/doc/lispref/syntax.texi b/doc/lispref/syntax.texi index 36907dd6d2..5b7be7c8ff 100644 --- a/doc/lispref/syntax.texi +++ b/doc/lispref/syntax.texi @@ -1,7 +1,7 @@ @c -*-texinfo-*- @c This is part of the GNU Emacs Lisp Reference Manual. @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2001, -@c 2002, 2003, 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc. +@c 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, Inc. @c See the file elisp.texi for copying conditions. @setfilename ../../info/syntax @node Syntax Tables, Abbrevs, Searching and Matching, Top @@ -418,12 +418,17 @@ not a syntax table. @deffn Command modify-syntax-entry char syntax-descriptor &optional table This function sets the syntax entry for @var{char} according to -@var{syntax-descriptor}. The syntax is changed only for @var{table}, -which defaults to the current buffer's syntax table, and not in any -other syntax table. The argument @var{syntax-descriptor} specifies the -desired syntax; this is a string beginning with a class designator -character, and optionally containing a matching character and flags as -well. @xref{Syntax Descriptors}. +@var{syntax-descriptor}. @var{char} can be a character, or a cons +cell of the form @code{(@var{min} . @var{max})}; in the latter case, +the function sets the syntax entries for all characters in the range +between @var{min} and @var{max}, inclusive. + +The syntax is changed only for @var{table}, which defaults to the +current buffer's syntax table, and not in any other syntax table. The +argument @var{syntax-descriptor} specifies the desired syntax; this is +a string beginning with a class designator character, and optionally +containing a matching character and flags as well. @xref{Syntax +Descriptors}. This function always returns @code{nil}. The old syntax information in the table for this character is discarded. @@ -723,9 +728,12 @@ buffer is modified without obeying the hook, such as when using @code{inhibit-modification-hooks}. For this reason, it is sometimes necessary to flush the cache manually. -@defun syntax-ppss-flush-cache beg -This function flushes the cache used by @code{syntax-ppss}, starting at -position @var{beg}. +@defun syntax-ppss-flush-cache beg &rest ignored-args +This function flushes the cache used by @code{syntax-ppss}, starting +at position @var{beg}. The remaining arguments, @var{ignored-args}, +are ignored; this function accepts them so that it can be directly +used on hooks such as @code{before-change-functions} (@pxref{Change +Hooks}). @end defun Major modes can make @code{syntax-ppss} run faster by specifying @@ -1163,12 +1171,15 @@ of the set. @end example @end defun -@defun modify-category-entry character category &optional table reset -This function modifies the category set of @var{character} in category +@defun modify-category-entry char category &optional table reset +This function modifies the category set of @var{char} in category table @var{table} (which defaults to the current buffer's category -table). +table). @var{char} can be a character, or a cons cell of the form +@code{(@var{min} . @var{max})}; in the latter case, the function +modifies the category sets of all characters in the range between +@var{min} and @var{max}, inclusive. -Normally, it modifies the category set by adding @var{category} to it. +Normally, it modifies a category set by adding @var{category} to it. But if @var{reset} is non-@code{nil}, then it deletes @var{category} instead. @end defun