[issue31582] Add _pth breadcrumb to sys.path documentation

Steve Dower report at bugs.python.org
Thu Jan 27 18:46:09 EST 2022


Steve Dower <steve.dower at python.org> added the comment:

I think we need somewhere in the documentation to explain how the initial import path is calculated, in terms useful for an end user (rather than what's in getpath.py, which is for developers).

Right now, I'm not sure there's a good place for it. There's a Windows-specific page with some detail, but we probably need something more generic. Probably it belongs under Doc/using/cmdline.rst (the environment variables section there is tempting, but I expect those would be updated to point to an easier to follow explanation. We'd also point to it from sys.path.

Without adding the new section, there isn't really anywhere sensible to mention it.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31582>
_______________________________________


More information about the Python-bugs-list mailing list