From c21f3bed5144b9d1f146ce6374b56d9fd93f8097 Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Thu, 15 Oct 2026 21:50:23 -0400 Subject: [PATCH] Two small changes in using/windows (GH-159438) Thes are based on Steve Dower's answer (to my questions) at https://discuss.python.org/t/python-3-16-0-alpha-1-is-now-available/109466/11. Update sentence about updates to note that site-packages and Scripts directories are left alone. Add a link to the administer configuration section. --------- (cherry picked from commit d52dba352c23249019779bd8c4874e45f9c0a705) Co-authored-by: Terry Jan Reedy Co-authored-by: Steve Dower --- Doc/using/windows.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index e82f931b39d94cf..bfa1ac3bf5f5d89 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -283,8 +283,8 @@ Passing ``--update`` will replace existing installs if the new version is newer. Otherwise, they will be left. If no tags are provided with ``--update``, all installs managed by the Python install manager will be updated if newer versions are available. Updates will remove any modifications made to the install, -including globally installed packages, but virtual environments will continue to -work. +including globally installed packages, but will leave ``site-packages`` and +``Scripts`` directories as is. Virtual environments are also unaffected. Passing ``--dry-run`` will generate output and logs, but will not modify any installs. @@ -394,8 +394,9 @@ override all other settings, but not every option is available. This section will describe the defaults, but be aware that modified or overridden installs may resolve settings differently. -A global configuration file may be configured by an administrator, and would be -read first. The user configuration file is stored at +A global configuration file may be configured by an +:ref:`administrator ` +and would be read first. The user configuration file is stored at :file:`%AppData%\\Python\\pymanager.json` (note that this location is under ``Roaming``, not ``Local``) and is read next, overwriting any settings from earlier files. An additional configuration file