diff options
| author | Steve Dower <steve.dower@microsoft.com> | 2018-01-29 10:34:09 +1100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2018-01-29 10:34:09 +1100 |
| commit | 15ea3a6a320623328530e5d8da5b83c75766180b (patch) | |
| tree | 375351d7a8d0cf4391867536bc08b0f18f67b1c0 /Doc/using | |
| parent | f11b460d8717fc3a5810684713b8b818f68789e8 (diff) | |
| download | cpython-git-15ea3a6a320623328530e5d8da5b83c75766180b.tar.gz | |
bpo-32699: Improves doc for .pth files in presense of a ._pth file (#5399)
Diffstat (limited to 'Doc/using')
| -rw-r--r-- | Doc/using/windows.rst | 8 |
1 files changed, 4 insertions, 4 deletions
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. |