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 chris.jerdonek
Recipients chris.jerdonek, docs@python
Date 2012-07-26.11:37:55
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1343302676.51.0.168761959505.issue15457@psf.upfronthosting.co.za>
In-reply-to
Content
The documentation on generators (outside of PEP 255) does not currently educate the reader on the more specific  "generator function" and "generator iterator" terminology, or at least not in any consistent or systematic way.

For example, the glossary includes only a single entry for "generator," and that entry does not mention the two more specific forms.

I think it would help for general discourse purposes if this distinction were made clearer, while still continuing to allow for the use of the generic word "generator" when the context makes it clear.

There are also cases where index entries can be improved in this regard, and where references to the section containing details about generators can still be added.  I am in the process of completing a proposed patch.
History
Date User Action Args
2012-07-26 11:37:56chris.jerdoneksetrecipients: + chris.jerdonek, docs@python
2012-07-26 11:37:56chris.jerdoneksetmessageid: <1343302676.51.0.168761959505.issue15457@psf.upfronthosting.co.za>
2012-07-26 11:37:55chris.jerdoneklinkissue15457 messages
2012-07-26 11:37:55chris.jerdonekcreate