Subject: bug#6747: closed (Re: bug#6747: Documentation: `syntax-ppss-toplevel-pos' xref typo `partial-parse-sexp' <- `parse-partial-sexp')

From: [email-masked] (GNU bug Tracking System)
Date: Sun, 01 Aug 2010 00:30:04 +0000

Your bug report

#6747: Documentation: `syntax-ppss-toplevel-pos' xref typo  `partial-parse-sexp' <- `parse-partial-sexp'

which was filed against the emacs package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to [email-masked].

-- 
6747: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=6747
GNU Bug Tracking System
Contact [email-masked] with problems

Subject: Re: bug#6747: Documentation: `syntax-ppss-toplevel-pos' xref typo `partial-parse-sexp' <- `parse-partial-sexp'
From: Stefan Monnier <[email-masked]>
To: MON KEY <[email-masked]>
Date: Sun, 01 Aug 2010 02:28:23 +0200
List-Id: <debbugs-submit.debbugs.gnu.org>

>>>>> "MON" == MON KEY <[email-masked]> writes:

> The function `syntax-ppss-toplevel-pos' in emacs-lisp/syntax.el appears to
> have a type:

> ,---- (documentation 'syntax-ppss-toplevel-pos)
> |
> | 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.
> |
> `----

> Is the second line in error? e.g.

> "PPSS is a scan state, as returned by `partial-parse-sexp' or `syntax-ppss'."
>                                        ^^^^^^^^^^^^^^^^^^

> Shouldn't that be `parse-partial-sexp'?

> Appears with docstring current through bzr-100920

Thanks, fixed in the emacs-23 branch,

        Stefan

Subject: Documentation: `syntax-ppss-toplevel-pos' xref typo `partial-parse-sexp' <- `parse-partial-sexp'
From: MON KEY <[email-masked]>
To: [email-masked]
Date: Wed, 28 Jul 2010 11:16:13 -0400
List-Id: <debbugs-submit.debbugs.gnu.org>

The function `syntax-ppss-toplevel-pos' in emacs-lisp/syntax.el appears to
have a type:

,---- (documentation 'syntax-ppss-toplevel-pos)
|
| 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.
|
`----

Is the second line in error? e.g.

"PPSS is a scan state, as returned by `partial-parse-sexp' or `syntax-ppss'."
                                       ^^^^^^^^^^^^^^^^^^

Shouldn't that be `parse-partial-sexp'?

Appears with docstring current through bzr-100920

--
/s_P\