Author r.david.murray
Recipients SilentGhost, aroberge, docs@python, larry, martin.panter, r.david.murray, random832
Date 2015-12-06.18:42:46
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1449427366.63.0.191230891873.issue25810@psf.upfronthosting.co.za>
In-reply-to
Content
As I recall it, in the python2 docs we used the [... notation, sometimes even when the actual arguments were or accepted keywords.  In the python3 docs we converted to always using keyword notation...and then realized that that also caused confusion, in the other direction.  Some things we converted back to [... notation.  Then argument clinic came along, and we kind of postponed worrying about it until we converted as much as practical to argument clinic.

I think we are moving toward using (and documenting in the main docs) the / notation.  Especially since it shows up in the inspect module as well as the docstring help.

Martin, if you don't think you have consensus on your patch, perhaps it is time to ping python-dev.
History
Date User Action Args
2015-12-06 18:42:46r.david.murraysetrecipients: + r.david.murray, larry, aroberge, SilentGhost, docs@python, martin.panter, random832
2015-12-06 18:42:46r.david.murraysetmessageid: <1449427366.63.0.191230891873.issue25810@psf.upfronthosting.co.za>
2015-12-06 18:42:46r.david.murraylinkissue25810 messages
2015-12-06 18:42:46r.david.murraycreate