Dennis Sweeney <sweeney.dennis...@gmail.com> added the comment:

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.

----------
nosy: +Dennis Sweeney

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue44754>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to