Hi,
I will add a link to https://docs.python.org/dev/c-api/init_config.html#python-path-configuration as we're trying to at least mention every way sys.path can be initialised.
I think the audience for the C API docs are likely to be more knowledgeable than those reading the Setup and Usage section, so I don't believe it will be possible to merge the information.
Thanks,
Russel

On Thu, 3 Mar 2022 at 12:27, Victor Stinner <vstinner@python.org> wrote:
Hi,

I tried to document inputs and outputs of Modules/getpath.py in the C
API Initialization API:
https://docs.python.org/dev/c-api/init_config.html#python-path-configuration

I don't know if it would be possible to merge most of these
information at a single place to avoid oudated documentation.

Victor

On Wed, Mar 2, 2022 at 5:40 PM Russel Webber <russel.webber@gmail.com> wrote:
>
> Hi All,
>
> Steve Dower, Eryk Sun and I have been working on improving the documentation around how sys.path is initialised and therefore how Python modules are found.
>
> We're moving the details from https://docs.python.org/3.11/using/windows.html#finding-modules
> to a platform-agnostic new section in https://docs.python.org/3.11/using/cmdline.html
>
> We're aiming to have one place in the documentation where all the ways to customize sys.path (PYTHONPATH, ._pth, site, etc) are at least mentioned.
>
> We'd appreciate further community feedback on the changes before they are merged.
> https://bugs.python.org/issue31582
> https://github.com/python/cpython/pull/31082
>
> Thank you,
> Russel
>
> _______________________________________________
> Python-Dev mailing list -- python-dev@python.org
> To unsubscribe send an email to python-dev-leave@python.org
> https://mail.python.org/mailman3/lists/python-dev.python.org/
> Message archived at https://mail.python.org/archives/list/python-dev@python.org/message/5AZQZH45EUCYN26SVD5DO6O7XTPSTIB5/
> Code of Conduct: http://python.org/psf/codeofconduct/



--
Night gathers, and now my watch begins. It shall not end until my death.