[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/syntax.texi
From: |
Stefan Monnier |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/syntax.texi |
Date: |
Mon, 13 Jun 2005 10:21:22 -0400 |
Index: emacs/lispref/syntax.texi
diff -c emacs/lispref/syntax.texi:1.42 emacs/lispref/syntax.texi:1.43
*** emacs/lispref/syntax.texi:1.42 Fri Jun 10 22:57:22 2005
--- emacs/lispref/syntax.texi Mon Jun 13 14:21:21 2005
***************
*** 740,745 ****
--- 740,765 ----
parenthesis depth) of the returned state are not meaningful.
@end defun
+ @defun syntax-ppss-flush-cache beg
+ This function flushes the cache used by @code{syntax-ppss}, starting at
+ position @var{beg}.
+
+ When @code{syntax-ppss} is called, it automatically hooks itself
+ to @code{before-change-functions} to keep its cache consistent.
+ But this can fail if @code{syntax-ppss} is called while
+ @code{before-change-functions} is temporarily let-bound, or if the
+ 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.
+ @end defun
+
+ @defvar syntax-begin-function
+ If this is non-nil, it should be a function that moves to an earlier
+ buffer position where the parser state is equivalent to @code{nil},
+ i.e., a position outside of any comment, string, or parenthesis.
+ @code{syntax-ppss} uses it to supplement its cache.
+ @end defvar
+
@defun scan-lists from count depth
This function scans forward @var{count} balanced parenthetical groupings
from position @var{from}. It returns the position where the scan stops.