[Python-bugs-list] [ python-Bugs-567127 ] Syntax typo in Python Tutorial

[noreply@sourceforge.net]

Bugs item #567127, was opened at 2002-06-10 19:15
You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=567127&group_id=5470

Category: Documentation
Group: None
>Status: Closed
>Resolution: Fixed
Priority: 5
Submitted By: Brighten Godfrey (godfreyb)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: Syntax typo in Python Tutorial

Initial Comment:
In the Python Tutorial, Section 5.1, "More on Lists",
the usage for the pop function is given as

    pop([i])

but should of course be just

    pop(i)

You can see this at:

    http://www.python.org/doc/current/tut/node7.html

Thank you all very much for your work on Python.


----------------------------------------------------------------------

>Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2002-06-10 22:59

Message:
Logged In: YES 
user_id=3066

There is a bug there, but not what you describe.  You're
right that the square brackets should not be typed, but
those are actually there to denote an optional parameter. 
This is the first introduction of this notation in the
tutorial, and should be explained.

I've modified the notation to be more clear and precisely
match that used in the Python Library Reference, and added
an explanation of the notation.

This is fixed for all future 2.1.x, 2.2.x, and 2.3 releases.
 The changes are commited at Doc/tut/tut.tex revisions
1.163, 1.156.4.1.2.3, and 1.133.2.7.

----------------------------------------------------------------------

You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=567127&group_id=5470