comparison lispref/syntax.texi @ 70831:4562eb4cf352

(Parsing Expressions): Update info on which STATE elements are ignored.
author Richard M. Stallman <rms@gnu.org>
date Sun, 21 May 2006 23:34:13 +0000
parents ed8e2704c862
children aebf3aeddf8c a8190f7e546e
comparison
equal deleted inserted replaced
70830:ddf34252d553 70831:4562eb4cf352
660 @code{syntax-table}, parsing stops after the start of a comment or a 660 @code{syntax-table}, parsing stops after the start of a comment or a
661 string, or the end of a comment or a string, whichever comes first. 661 string, or the end of a comment or a string, whichever comes first.
662 662
663 @cindex parse state 663 @cindex parse state
664 The fifth argument @var{state} is a ten-element list of the same form 664 The fifth argument @var{state} is a ten-element list of the same form
665 as the value of this function, described below. (It is OK to omit the 665 as the value of this function, described below. The return value of
666 last two elements of this list.) The return value of one call may be 666 one call may be used to initialize the state of the parse on another
667 used to initialize the state of the parse on another call to 667 call to @code{parse-partial-sexp}.
668 @code{parse-partial-sexp}.
669 668
670 The result is a list of ten elements describing the final state of 669 The result is a list of ten elements describing the final state of
671 the parse: 670 the parse:
672 671
673 @enumerate 0 672 @enumerate 0
719 718
720 @item 719 @item
721 Internal data for continuing the parsing. The meaning of this 720 Internal data for continuing the parsing. The meaning of this
722 data is subject to change; it is used if you pass this list 721 data is subject to change; it is used if you pass this list
723 as the @var{state} argument to another call. 722 as the @var{state} argument to another call.
724
725 @end enumerate 723 @end enumerate
726 724
727 Elements 0, 3, 4, 5, 7 and 9 are significant in the argument 725 Elements 1, 2, and 6 are ignored in the argument @var{state}. Element
728 @var{state}. 726 8 is used only to set the corresponding element of the return value,
727 in certain simple cases. Element 9 is used only to set element 1 of
728 the return value, in trivial cases where parsing starts and stops
729 within the same pair of parentheses.
729 730
730 @cindex indenting with parentheses 731 @cindex indenting with parentheses
731 This function is most often used to compute indentation for languages 732 This function is most often used to compute indentation for languages
732 that have nested parentheses. 733 that have nested parentheses.
733 @end defun 734 @end defun