[issue11553] Docs for: import, packages, site.py, .pth files

[Nick Coghlan]

Nick Coghlan <ncoghlan at gmail.com> added the comment:

Ah, now I get your point re .pkg vs .pth. I naturally read that as ".pth entries are to sys.path entries as .pkg entries are to pkg.__path__ entries", without any hint that those are the same *kind* of thing. However, I already know that sys.path and pkg.__path__ entries are different, and now I see how it could be misleading for anyone that wasn't as familiar with the distinction.

(This has actually been one of the historic problems with the import documentation - we *don't always know* when something is unclear, because we unconsciously fill in the missing pieces)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11553>
_______________________________________