[issue11553] Docs for: import, packages, site.py, .pth files
report at bugs.python.org
Sun Jun 12 01:53:24 CEST 2011
Nick Coghlan <ncoghlan at gmail.com> added the comment:
"Public name" is a term that describes a convention, not anything enforced by the interpreter. Names starting with underscores typically aren't public either (unless documented otherwise), but that has no effect on the ability to retrieve them as attributes. A glossary entry defining the term may be worthwhile (perhaps with a reference to pydoc.visiblename())
Dirs mentioned in .pkg files *should* be added to "the path". It's just that the path in question is pkg.__path__, not sys.path. That could probably be made clearer, but the docs aren't wrong as they stand.
Python tracker <report at bugs.python.org>
More information about the Python-bugs-list