* syntax.texi (Position Parse): Document rationale for ignored
[bpt/emacs.git] / doc / lispref / syntax.texi
index 38e50e2..5b7be7c 100644 (file)
@@ -728,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