[docs] [issue15831] comma after leading optional argument is after bracket in docs

Ezio Melotti report at bugs.python.org
Tue Sep 4 18:26:15 CEST 2012

Ezio Melotti added the comment:

> So I wasn't sure if this notation was preferred or discouraged.

We are moving toward using the same signatures that we have in the Python code, but that doesn't always work (e.g. when the meaning of values changes depending on the number of args, when there's some trick with *args/**kwargs involved, when there are default placeholders, etc.).
The single * is not so common (yet), and it might be difficult to understand for new users, that's why I said it's OK to leave it out in cases where all the args are keyword args and the [] are used.


Python tracker <report at bugs.python.org>

More information about the docs mailing list