From 15ea3a6a320623328530e5d8da5b83c75766180b Mon Sep 17 00:00:00 2001 From: Steve Dower Date: Mon, 29 Jan 2018 10:34:09 +1100 Subject: bpo-32699: Improves doc for .pth files in presense of a ._pth file (#5399) --- Doc/using/windows.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'Doc/using') diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 1c7b8142af..47d423f42d 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -721,7 +721,7 @@ installation directory. So, if you had installed Python to :file:`C:\\Python\\Lib\\site-packages\\`. To completely override :data:`sys.path`, create a ``._pth`` file with the same -name as the DLL (``python36._pth``) or the executable (``python._pth``) and +name as the DLL (``python37._pth``) or the executable (``python._pth``) and specify one line for each path to add to :data:`sys.path`. The file based on the DLL name overrides the one based on the executable, which allows paths to be restricted for any program loading the runtime if desired. @@ -734,7 +734,7 @@ Import statements other than to ``site`` are not permitted, and arbitrary code cannot be specified. Note that ``.pth`` files (without leading underscore) will be processed normally -by the :mod:`site` module. +by the :mod:`site` module when ``import site`` has been specified. When no ``._pth`` file is found, this is how :data:`sys.path` is populated on Windows: @@ -796,7 +796,7 @@ following advice will prevent conflicts with other installations: environment variables, and also ignore :mod:`site` unless ``import site`` is listed. -* If you are loading :file:`python3.dll` or :file:`python36.dll` in your own +* If you are loading :file:`python3.dll` or :file:`python37.dll` in your own executable, explicitly call :c:func:`Py_SetPath` or (at least) :c:func:`Py_SetProgramName` before :c:func:`Py_Initialize`. @@ -930,7 +930,7 @@ directly accessed by end-users. When extracted, the embedded distribution is (almost) fully isolated from the user's system, including environment variables, system registry settings, and installed packages. The standard library is included as pre-compiled and -optimized ``.pyc`` files in a ZIP, and ``python3.dll``, ``python36.dll``, +optimized ``.pyc`` files in a ZIP, and ``python3.dll``, ``python37.dll``, ``python.exe`` and ``pythonw.exe`` are all provided. Tcl/tk (including all dependants, such as Idle), pip and the Python documentation are not included. -- cgit v1.2.1