Message 241590 - Python tracker

Message241590

Author martin.panter
Recipients baptiste.carvello, chris.jerdonek, docs@python, eric.araujo, eric.smith, eric.snow, ezio.melotti, georg.brandl, martin.panter, petri.lehtinen, terry.reedy
Date 2015-04-20.02:25:31
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1429496731.21.0.238462293514.issue13386@psf.upfronthosting.co.za>
In-reply-to
Content
When a parameter is optional but does not have a simple default value, I suggest using some obviously invalid pseudocode, such as

function(arg1, arg2=<automatic, see text>)

See Issue 8706 about adding more support for keyword arguments. See also Issue 23738 for signatures that incorrectly appear to accept keywords due to including default values, and PEP 457’s slash (/) indicator for documenting positional-only parameters.
History
Date User Action Args
2015-04-20 02:25:31martin.pantersetrecipients: + martin.panter, georg.brandl, terry.reedy, eric.smith, ezio.melotti, eric.araujo, chris.jerdonek, docs@python, eric.snow, baptiste.carvello, petri.lehtinen
2015-04-20 02:25:31martin.pantersetmessageid: <1429496731.21.0.238462293514.issue13386@psf.upfronthosting.co.za>
2015-04-20 02:25:31martin.panterlinkissue13386 messages
2015-04-20 02:25:31martin.pantercreate