[Emacs-diffs] Changes to emacs/lisp/emacs-lisp/syntax.el,v

[Stefan Monnier]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Stefan Monnier <monnier>        06/12/18 14:02:30

Index: syntax.el
===================================================================
RCS file: /sources/emacs/emacs/lisp/emacs-lisp/syntax.el,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -b -r1.19 -r1.20
--- syntax.el   12 Dec 2006 02:36:38 -0000      1.19
+++ syntax.el   18 Dec 2006 14:02:30 -0000      1.20
@@ -53,10 +53,12 @@
   (nth 0 ppss))
 
 (defun syntax-ppss-toplevel-pos (ppss)
-  "Return the last preceding position at toplevel.
-\"At toplevel\" means that it is outside of any syntactic entity:
-outside of any parentheses, or comments, or strings.
-Returns nil iff PPSS itself corresponds to a toplevel position."
+  "Get the latest syntactically outermost position found in a syntactic scan.
+PPSS is a scan state, as returned by `partial-parse-sexp' or `syntax-ppss'.
+An \"outermost position\" means one that it is outside of any syntactic entity:
+outside of any parentheses, comments, or strings encountered in the scan.
+If no such position is recorded in PPSS (because the end of the scan was
+itself at the outermost level), return nil."
   (or (car (nth 9 ppss))
       (nth 8 ppss)))