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

[Richard M . Stallman]

Index: emacs/lispref/syntax.texi
diff -c emacs/lispref/syntax.texi:1.36 emacs/lispref/syntax.texi:1.37
*** emacs/lispref/syntax.texi:1.36      Mon Nov 22 13:17:55 2004
--- emacs/lispref/syntax.texi   Sun Feb 27 00:12:33 2005
***************
*** 155,163 ****
  @dfn{Punctuation characters} (designated by @samp{.}) are those
  characters that are used as punctuation in English, or are used in some
  way in a programming language to separate symbols from one another.
! Most programming language modes, including Emacs Lisp mode, have no
  characters in this class since the few characters that are not symbol or
! word constituents all have other uses.
  @end deffn
  
  @deffn {Syntax class} @w{open parenthesis character}
--- 155,164 ----
  @dfn{Punctuation characters} (designated by @samp{.}) are those
  characters that are used as punctuation in English, or are used in some
  way in a programming language to separate symbols from one another.
! Some programming language modes, such as Emacs Lisp mode, have no
  characters in this class since the few characters that are not symbol or
! word constituents all have other uses.  Other programming language modes,
! such as C mode, use punctuation syntax for operators.
  @end deffn
  
  @deffn {Syntax class} @w{open parenthesis character}
***************
*** 501,512 ****
  @code{char-syntax}.
  @end defun
  
- @defun syntax-after pos
- This function returns a description of the syntax of the character in
- the buffer after position @var{pos}, taking account of syntax
- properties as well as the syntax table.
- @end defun
- 
  @defun set-syntax-table table
  This function makes @var{table} the syntax table for the current buffer.
  It returns @var{table}.
--- 502,507 ----
***************
*** 664,676 ****
  string, or the end of a comment or a string, whichever comes first.
  
  @cindex parse state
! The fifth argument @var{state} is a nine-element list of the same form
  as the value of this function, described below.  (It is OK to omit the
! last element of the nine.)  The return value of one call may be used to
! initialize the state of the parse on another call to
  @code{parse-partial-sexp}.
  
! The result is a list of nine elements describing the final state of
  the parse:
  
  @enumerate 0
--- 659,671 ----
  string, or the end of a comment or a string, whichever comes first.
  
  @cindex parse state
! The fifth argument @var{state} is a ten-element list of the same form
  as the value of this function, described below.  (It is OK to omit the
! last two elements of this list.)  The return value of one call may be
! used to initialize the state of the parse on another call to
  @code{parse-partial-sexp}.
  
! The result is a list of ten elements describing the final state of
  the parse:
  
  @enumerate 0
***************
*** 717,731 ****
  the position where the comment began; while inside a string, this is the
  position where the string began.  When outside of strings and comments,
  this element is @code{nil}.
- @end enumerate
  
! Elements 0, 3, 4, 5 and 7 are significant in the argument @var{state}.
  
! Actually, the return value is currently a list of ten, rather than
! nine, elements and @var{state} is allowed to be a list of ten elements
! as well.  However, the meaning of the tenth element is subject to
! change and only the first eight elements of @var{state} need to be
! specified.
  
  @cindex indenting with parentheses
  This function is most often used to compute indentation for languages
--- 712,727 ----
  the position where the comment began; while inside a string, this is the
  position where the string began.  When outside of strings and comments,
  this element is @code{nil}.
  
! @item
! Internal data for continuing the parsing.  The meaning of this
! data is subject to change; it is used if you pass this list
! as the @var{state} argument to another call.
! 
! @end enumerate
  
! Elements 0, 3, 4, 5, 7 and 9 are significant in the argument
! @var{state}.
  
  @cindex indenting with parentheses
  This function is most often used to compute indentation for languages
***************
*** 941,946 ****
--- 937,948 ----
  @var{matching-char})} corresponding to the syntax descriptor @var{desc}.
  @end defun
  
+ @defun syntax-after pos
+ This function returns the syntax code of the character in the buffer
+ after position @var{pos}, taking account of syntax properties as well
+ as the syntax table.
+ @end defun
+ 
  @node Categories
  @section Categories
  @cindex categories of characters
***************
*** 973,979 ****
  
  @defun define-category char docstring &optional table
  This function defines a new category, with name @var{char} and
! documentation @var{docstring}, for the category table @var{table},
  @end defun
  
  @defun category-docstring category &optional table
--- 975,981 ----
  
  @defun define-category char docstring &optional table
  This function defines a new category, with name @var{char} and
! documentation @var{docstring}, for the category table @var{table}.
  @end defun
  
  @defun category-docstring category &optional table