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.
Created on 2012年07月07日 18:15 by chris.jerdonek, last changed 2022年04月11日 14:57 by admin. This issue is now closed.
| Messages (6) | |||
|---|---|---|---|
| msg164916 - (view) | Author: Chris Jerdonek (chris.jerdonek) * (Python committer) | Date: 2012年07月07日 18:15 | |
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. |
|||
| msg164959 - (view) | Author: Brett Cannon (brett.cannon) * (Python committer) | Date: 2012年07月08日 01:44 | |
Probably linking the term "importers" into the glossary should be enough. |
|||
| msg165096 - (view) | Author: Ronan Lamy (Ronan.Lamy) * | Date: 2012年07月09日 17:08 | |
It seems that most, if not all, uses of "importer" in pkgutil refer to finders, e.g. ImpImporter is a actually only a finder, not an importer. So s/importer/finder/ is needed, and perhaps also a note explaining that ImpImporter isn't in fact an importer, in addition to glossary links. |
|||
| msg165102 - (view) | Author: Roundup Robot (python-dev) (Python triager) | Date: 2012年07月09日 18:10 | |
New changeset 96f7926ea444 by Brett Cannon in branch 'default': Issue #15288: Clarify that pkgutil.walk_packages() and friends will no http://hg.python.org/cpython/rev/96f7926ea444 |
|||
| msg165103 - (view) | Author: Brett Cannon (brett.cannon) * (Python committer) | Date: 2012年07月09日 18:11 | |
I changed to term to "loader" and linked to the glossary. I also added a versionchanged note for Python 3.3 so people are not too surprised that pkgutil no longer does what it did in Python 3.2. |
|||
| msg165106 - (view) | Author: Brett Cannon (brett.cannon) * (Python committer) | Date: 2012年07月09日 18:48 | |
Ronan is right that it is all about finders, not importers per-se. I fixed the docs to not say "loader". |
|||
| History | |||
|---|---|---|---|
| Date | User | Action | Args |
| 2022年04月11日 14:57:32 | admin | set | github: 59493 |
| 2012年07月09日 18:48:42 | brett.cannon | set | messages: + msg165106 |
| 2012年07月09日 18:11:20 | brett.cannon | set | status: open -> closed resolution: fixed messages: + msg165103 |
| 2012年07月09日 18:10:30 | python-dev | set | nosy:
+ python-dev messages: + msg165102 |
| 2012年07月09日 17:08:47 | Ronan.Lamy | set | nosy:
+ Ronan.Lamy messages: + msg165096 |
| 2012年07月08日 01:44:19 | brett.cannon | set | nosy:
+ brett.cannon messages: + msg164959 |
| 2012年07月07日 18:15:57 | chris.jerdonek | create | |