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 ezio.melotti
Recipients StMark, eric.araujo, ezio.melotti, georg.brandl, ggenellina, terry.reedy
Date 2011-11-09.01:53:10
SpamBayes Score 6.26497e-07
Marked as misclassified No
Message-id <1320803591.67.0.494301646711.issue6570@psf.upfronthosting.co.za>
In-reply-to
Content
> +accepts one :term:`positional argument` (``voltage``) and three
> +:term:`keyword arguments <keyword argument>` (``state``, ``action``,
> +and ``type``).  
>
> This is simply false. An argument for voltage is required, the other
> three are optional. I suggest something like the followinga:

That part refers to the function signature, not the function call.  I tried to avoid using the term "function signature" to avoid introducing yet another term, but maybe the two things should be separated a bit more.

I also tried to avoid the use of 'parameters' (the 'names' in the function signature) and 'arguments' (the actual values passed to the function when it's called) to keep the things simple and also because not everyone agrees on this terminology.

Would adding 'required' before 'positional' and 'optional' before 'keyword arguments' be ok?
History
Date User Action Args
2011-11-09 01:53:11ezio.melottisetrecipients: + ezio.melotti, georg.brandl, terry.reedy, ggenellina, eric.araujo, StMark
2011-11-09 01:53:11ezio.melottisetmessageid: <1320803591.67.0.494301646711.issue6570@psf.upfronthosting.co.za>
2011-11-09 01:53:11ezio.melottilinkissue6570 messages
2011-11-09 01:53:10ezio.melotticreate