[docs] [issue15831] comma after leading optional argument is after bracket in docs
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