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 terry.reedy
Recipients docs@python, eli.bendersky, ezio.melotti, petere, terry.reedy
Date 2011-07-15.19:25:49
SpamBayes Score 1.735932e-10
Marked as misclassified No
Message-id <1310757951.29.0.925939252566.issue12531@psf.upfronthosting.co.za>
In-reply-to
Content
This is just the tip of the iceberg as far as needed symbol index entries goes. Nearly 3 years ago, I wrote a Python 3 symbol glossary "Python3 Syntax Symbol Uses" that was complete as far as I knew then. I think most of the entries there should have a corresponding index entry in the official docs. Link to download/view is

https://code.google.com/p/xploro/downloads/detail?name=PySymbols.html&can=1&q=

That has 7 entries for '*':
  *: In function parameter list, make following unstarred names keyword only.
P *parameter_name: Function parameter bound to a tuple of extra positional arguments, any following unstarred names are keyword only.
P *iterable: In a call, unpack iterable items as arguments.
P *assignment_target: Starred target in assignment statement gets extra items from iterable.
I number1 * number2: Number multiplication operator.
I n * sequence or sequence * n: Operator to concatenate n copies of sequence.
S from module import *: Import all public (non-private) names from the module. 

 /P/I/S == 'nofix', prefix, infix, suffix.

I have been planning to work on a patch 'sometime', but would be happy if someone else grabbed the above and ran with it (and expanded the title of this issue).

I believe existing docs can get additions like this.
History
Date User Action Args
2011-07-15 19:25:51terry.reedysetrecipients: + terry.reedy, ezio.melotti, eli.bendersky, petere, docs@python
2011-07-15 19:25:51terry.reedysetmessageid: <1310757951.29.0.925939252566.issue12531@psf.upfronthosting.co.za>
2011-07-15 19:25:50terry.reedylinkissue12531 messages
2011-07-15 19:25:49terry.reedycreate