From: Xue Fuqiao <xfq.free@gmail.com>
Date: Fri, 4 Oct 2013 14:46:31 +0000 (+0800)
Subject: * lisp/emacs-lisp/syntax.el (syntax-ppss): Doc fix.
X-Git-Tag: emacs-24.3.90~173^2^2~42^2~45^2~387^2~1388
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=63bd7f352faa51c6da920d0e41d0e4afc4768f77;p=emacs.git

* lisp/emacs-lisp/syntax.el (syntax-ppss): Doc fix.
---

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index bb4b89adea2..ecf943eac56 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2013-10-04  Xue Fuqiao  <xfq.free@gmail.com>
+
+	* emacs-lisp/syntax.el (syntax-ppss): Doc fix.
+
 2013-10-04  Michael Albinus  <michael.albinus@gmx.de>
 
 	* net/secrets.el (secrets-create-collection): Add optional
diff --git a/lisp/emacs-lisp/syntax.el b/lisp/emacs-lisp/syntax.el
index 3e850320133..6b169d3a18c 100644
--- a/lisp/emacs-lisp/syntax.el
+++ b/lisp/emacs-lisp/syntax.el
@@ -405,9 +405,14 @@ point (where the PPSS is equivalent to nil).")
 (defun syntax-ppss (&optional pos)
   "Parse-Partial-Sexp State at POS, defaulting to point.
 The returned value is the same as that of `parse-partial-sexp'
-run from point-min to POS except that values at positions 2 and 6
+run from `point-min' to POS except that values at positions 2 and 6
 in the returned list (counting from 0) cannot be relied upon.
-Point is at POS when this function returns."
+Point is at POS when this function returns.
+
+It is necessary to call `syntax-ppss-flush-cache' explicitly if
+this function is called while `before-change-functions' is
+temporarily let-bound, or if the buffer is modified without
+running the hook."
   ;; Default values.
   (unless pos (setq pos (point)))
   (syntax-propertize pos)