[Emacs-diffs] Changes to emacs/lispref/syntax.texi

[Stefan Monnier]

Index: emacs/lispref/syntax.texi
diff -c emacs/lispref/syntax.texi:1.40 emacs/lispref/syntax.texi:1.41
*** emacs/lispref/syntax.texi:1.40      Thu Apr 28 11:33:59 2005
--- emacs/lispref/syntax.texi   Fri Jun 10 22:20:25 2005
***************
*** 256,262 ****
  @deffn {Syntax class} @w{inherit}
  This syntax class does not specify a particular syntax.  It says to look
  in the standard syntax table to find the syntax of this character.  The
! designator for this syntax code is @samp{@@}.
  @end deffn
  
  @deffn {Syntax class} @w{generic comment delimiter}
--- 256,262 ----
  @deffn {Syntax class} @w{inherit}
  This syntax class does not specify a particular syntax.  It says to look
  in the standard syntax table to find the syntax of this character.  The
! designator for this syntax class is @samp{@@}.
  @end deffn
  
  @deffn {Syntax class} @w{generic comment delimiter}
***************
*** 385,391 ****
  @samp{p} identifies an additional ``prefix character'' for Lisp syntax.
  These characters are treated as whitespace when they appear between
  expressions.  When they appear within an expression, they are handled
! according to their usual syntax codes.
  
  The function @code{backward-prefix-chars} moves back over these
  characters, as well as over characters whose primary syntax class is
--- 385,391 ----
  @samp{p} identifies an additional ``prefix character'' for Lisp syntax.
  These characters are treated as whitespace when they appear between
  expressions.  When they appear within an expression, they are handled
! according to their usual syntax classes.
  
  The function @code{backward-prefix-chars} moves back over these
  characters, as well as over characters whose primary syntax class is
***************
*** 566,572 ****
  
  @defun skip-syntax-forward syntaxes &optional limit
  This function moves point forward across characters having syntax
! classes mentioned in @var{syntaxes} (a string of syntax code
  characters).  It stops when it encounters the end of the buffer, or
  position @var{limit} (if specified), or a character it is not supposed
  to skip.
--- 566,572 ----
  
  @defun skip-syntax-forward syntaxes &optional limit
  This function moves point forward across characters having syntax
! classes mentioned in @var{syntaxes} (a string of syntax class
  characters).  It stops when it encounters the end of the buffer, or
  position @var{limit} (if specified), or a character it is not supposed
  to skip.
***************
*** 730,735 ****
--- 730,745 ----
  that have nested parentheses.
  @end defun
  
+ @defun syntax-ppss &optional pos
+ This function returns the state that the parser would have at position
+ @var{pos}, if it were started with a default start state at the
+ beginning of the buffer.  Thus, it is equivalent to
+ @code(parse-partial-sexp (point-min) @var{pos}), except that
+ @code{syntax-ppss} uses a cache to speed up the computation.  Also,
+ the 2nd value (previous complete subexpression) and 6th value (minimum
+ parenthesis depth) of the returned state are not meaningful.
+ @end defun
+ 
  @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.