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 techtonik
Recipients docs@python, techtonik
Date 2013-09-15.13:18:38
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1379251118.66.0.684713404389.issue19024@psf.upfronthosting.co.za>
In-reply-to
Content
I'd say this is a critical documentation bug that leads to head bang when you try to figure out what does '*' in code means.

This bug is two fold:
1. Define a dedicated place in documentation for '*' operator with examples. I propose http://docs.python.org/3/library/stdtypes.html chapter with a name like "Special Operations" or "Function Argument Operations" or "Function Argument Operators"
 
2. Make '*', 'asterisk', 'splat', 'star' operator searchable
http://docs.python.org/3/search.html?q=*
http://docs.python.org/3/search.html?q=asterisk
http://docs.python.org/3/search.html?q=splat
http://docs.python.org/3/search.html?q=star+operator

Good?

References:
http://stackoverflow.com/questions/2322355/proper-name-for-python-operator
http://stackoverflow.com/questions/5239856/foggy-on-asterisk-in-python
http://stackoverflow.com/questions/2921847/python-once-and-for-all-what-does-the-star-operator-mean-in-python
http://stackoverflow.com/questions/287085/what-do-args-and-kwargs-mean
http://stackoverflow.com/search?q=[python]+%2Bkwargs+is%3Aquestion
History
Date User Action Args
2013-09-15 13:18:38techtoniksetrecipients: + techtonik, docs@python
2013-09-15 13:18:38techtoniksetmessageid: <1379251118.66.0.684713404389.issue19024@psf.upfronthosting.co.za>
2013-09-15 13:18:38techtoniklinkissue19024 messages
2013-09-15 13:18:38techtonikcreate