Re: State argument of `parse-partial-sexp'

[martin rudalics]

> - don't specify the length of the state argument: just say it's the same as
>   the return value.

The state argument can be the empty list, I'd say "same form" should
suffice here.

> - specify the ignored elements rather than the non-ignored ones.
>   The list of ignored ones is much less likely to change.

Elementary.  I attached a patch.

*** syntax.texi Mon May  1 10:08:56 2006
--- syntax.texi Tue May 16 08:21:20 2006
***************
*** 661,669 ****
  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}.

--- 661,668 ----
  string, or the end of a comment or a string, whichever comes first.

  @cindex parse state
! The fifth argument @var{state} is a list of the same form as the value
! of this function, described below.  The return value of one call may be
  used to initialize the state of the parse on another call to
  @code{parse-partial-sexp}.

***************
*** 724,731 ****

  @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
--- 723,729 ----

  @end enumerate

! Elements 1, 2, and 6 are ignored in the argument @var{state}.

  @cindex indenting with parentheses
  This function is most often used to compute indentation for languages