From 16774a2a8d31d60ed07a8f61baecf98f25bc4bf4 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 7c68192ad6e069c..6d82e85a5b4e262 100644 --- a/Doc/using/windows.rst +++ b/Doc/using/windows.rst @@ -281,8 +281,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. @@ -392,8 +392,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