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 StMark
Recipients StMark, georg.brandl
Date 2009-07-25.08:35:37
SpamBayes Score 0.00034050815
Marked as misclassified No
Message-id <1248510940.46.0.953855607394.issue6570@psf.upfronthosting.co.za>
In-reply-to
Content
Hi

In section 4.7.2 of the tutorial documentation, we suddenly find the
following paragraph:

"In general, an argument list must have any positional arguments
followed by any keyword arguments, where the keywords must be chosen
from the formal parameter names. It’s not important whether a formal
parameter has a default value or not. No argument may receive a value
more than once — formal parameter names corresponding to positional
arguments cannot be used as keywords in the same calls. Here’s an
example that fails due to this restriction:"

To a beginner who is reading a tutorial to learn how to use this
language for the first time, it is completely overwhelming. What is a
"positional argument" vs a "keyword argument" and what is a "formal
parameter name"?

None of these things have been explained up until this point and an
understanding of their meaning is required to make sense of this paragraph.

Please consider revising this section.

Thank you.

Mark
History
Date User Action Args
2009-07-25 08:35:40StMarksetrecipients: + StMark, georg.brandl
2009-07-25 08:35:40StMarksetmessageid: <1248510940.46.0.953855607394.issue6570@psf.upfronthosting.co.za>
2009-07-25 08:35:38StMarklinkissue6570 messages
2009-07-25 08:35:37StMarkcreate