From bd515fb7465701acc9ea76d815eb2a98ad76e8f1 Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Wed, 14 Oct 2026 19:40:00 -0400 Subject: [PATCH 1/2] Two small changes in using/windows 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. --- 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 637a80f42d4a157..4eeb11fac3fdfff 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 as is. Virtual environments will continue to work. Passing ``--dry-run`` will generate output and logs, but will not modify any installs. @@ -399,8 +399,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 From c849002c4bedba7d240db0348e3bf7adfcac52ac Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Thu, 15 Oct 2026 13:09:23 -0400 Subject: [PATCH 2/2] Update Doc/using/windows.rst Co-authored-by: Steve Dower --- Doc/using/windows.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst index 4eeb11fac3fdfff..a8350980767a448 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 will leave /site-packages and -/Scripts as is. 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.