]> code.delx.au - gnu-emacs/blobdiff - doc/lispref/syntax.texi
Add 2010 to copyright years.
[gnu-emacs] / doc / lispref / syntax.texi
index 36907dd6d28705597d86a37c0f845aa2b249acc7..a3d5631baf8fc7e0265f1725ff57a0ee78f40fa5 100644 (file)
@@ -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, 2010  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