From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 11 Nov 2025 20:08:52 +0000 (+0100)
Subject: Add documentation for Python install manager's install_dir, global_dir and download_d... 
X-Git-Tag: v3.14.1~148
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=03fca07f839fe6c454dfbed37d91c49ee640b38d;p=thirdparty%2FPython%2Fcpython.git

Add documentation for Python install manager's install_dir, global_dir and download_dir (GH-140223)

(cherry picked from commit 336154f4b0dbcf1d9dbb461ae962d558ba60f452)

Co-authored-by: Steve Dower <steve.dower@python.org>
---

diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
index ab0ed3fb110f..52212c394cff 100644
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -457,6 +457,25 @@ customization.
      - Specify the default format used by the ``py list`` command.
        By default, ``table``.
 
+   * - ``install_dir``
+     - (none)
+     - Specify the root directory that runtimes will be installed into.
+       If you change this setting, previously installed runtimes will not be
+       usable unless you move them to the new location.
+
+   * - ``global_dir``
+     - (none)
+     - Specify the directory where global commands (such as ``python3.14.exe``)
+       are stored.
+       This directory should be added to your :envvar:`PATH` to make the
+       commands available from your terminal.
+
+   * - ``download_dir``
+     - (none)
+     - Specify the directory where downloaded files are stored.
+       This directory is a temporary cache, and can be cleaned up from time to
+       time.
+
 Dotted names should be nested inside JSON objects, for example, ``list.format``
 would be specified as ``{"list": {"format": "table"}}``.