On Thu, Sep 20, 2012 at 10:18 AM, Chris Jerdonek chris.jerdonek@gmail.com wrote:
On Thu, Sep 20, 2012 at 8:52 AM, Guido van Rossum guido@python.org wrote:
On Thu, Sep 20, 2012 at 7:12 AM, Benjamin Peterson benjamin@python.org wrote:
I tried to define the error messages in terms of the callee's signature. I call the formals that are not variadic, keyword variadic, or keyword-only, positional. For example, in
Maybe this is also a good time to start distinguishing between arguments (what you pass, call syntax) and parameters (what the function receives, function definition syntax)?
The glossary is one place to start making this distinction. It currently has entries for "argument," "positional argument," and "keyword argument" that could perhaps use a review from this discussion. For example:
http://docs.python.org/dev/glossary.html#term-positional-argument
The entries currently blur the distinction between the calling and definition perspectives. Ideally, the glossary definitions of these terms would match and be consistent with their usage in error messages.
I took the liberty to create an issue in the tracker to settle on and document preferred terminology in the area of positional/keyword arguments/parameters, etc. The issue is here:
http://bugs.python.org/issue15990
--Chris