Message 164916 - Python tracker

➜

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.

In-reply-to
Author	chris.jerdonek
Recipients	chris.jerdonek, docs@python
Date	2012年07月07日.18:15:57
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1341684957.85.0.27089826728.issue15288@psf.upfronthosting.co.za>

Content
The note at the end of the pkgutil.walk_packages() (and iter_modules()) documentation can be improved somewhat: http://docs.python.org/dev/library/pkgutil.html#pkgutil.walk_packages For example, "importers" aren't referenced earlier in the documentation of the function, so it's not immediately clear what they are referring to. I also think that enough information should be given so that one can run the examples given and have them work. They currently don't. I can put together proposed wording. See the issue 14982 discussion for background.

Content

The note at the end of the pkgutil.walk_packages() (and iter_modules()) documentation can be improved somewhat:
http://docs.python.org/dev/library/pkgutil.html#pkgutil.walk_packages
For example, "importers" aren't referenced earlier in the documentation of the function, so it's not immediately clear what they are referring to. I also think that enough information should be given so that one can run the examples given and have them work. They currently don't.
I can put together proposed wording. See the issue 14982 discussion for background.

History
Date	User	Action	Args
2012年07月07日 18:15:57	chris.jerdonek	set	recipients: + chris.jerdonek, docs@python
2012年07月07日 18:15:57	chris.jerdonek	set	messageid: <1341684957.85.0.27089826728.issue15288@psf.upfronthosting.co.za>
2012年07月07日 18:15:57	chris.jerdonek	link	issue15288 messages
2012年07月07日 18:15:57	chris.jerdonek	create

homepage