This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author Dennis Sweeney
Recipients Dennis Sweeney, docs@python, mark-gluzman
Date 2021-07-28.01:02:04
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1627434125.36.0.919281906067.issue44754@roundup.psfhosted.org>
In-reply-to
Content
The [square brackets] are used to denote *optional* arguments throughout the documentation. A tutorial page (https://docs.python.org/3/tutorial/controlflow.html#id1) has this to say:

    list.pop([i])

    Remove the item at the given position in the list, and return it. If no index is specified, a.pop() removes and returns the last item in the list. (The square brackets around the i in the method signature denote that the parameter is optional, not that you should type square brackets at that position. You will see this notation frequently in the Python Library Reference.)

I can open a PR to try to make the "Built-in Types" page you looked at a little clearer.
History
Date User Action Args
2021-07-28 01:02:05Dennis Sweeneysetrecipients: + Dennis Sweeney, docs@python, mark-gluzman
2021-07-28 01:02:05Dennis Sweeneysetmessageid: <1627434125.36.0.919281906067.issue44754@roundup.psfhosted.org>
2021-07-28 01:02:05Dennis Sweeneylinkissue44754 messages
2021-07-28 01:02:04Dennis Sweeneycreate