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 ncoghlan
Recipients Greg.Slodkowicz, brett.cannon, docs@python, eric.araujo, gwideman, ncoghlan, pje
Date 2011-06-11.23:53:24
SpamBayes Score 2.3812758e-05
Marked as misclassified No
Message-id <1307836404.85.0.931756146689.issue11553@psf.upfronthosting.co.za>
In-reply-to
Content
"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.
History
Date User Action Args
2011-06-11 23:53:24ncoghlansetrecipients: + ncoghlan, brett.cannon, pje, eric.araujo, docs@python, Greg.Slodkowicz, gwideman
2011-06-11 23:53:24ncoghlansetmessageid: <1307836404.85.0.931756146689.issue11553@psf.upfronthosting.co.za>
2011-06-11 23:53:24ncoghlanlinkissue11553 messages
2011-06-11 23:53:24ncoghlancreate