Skip to content

Commit 24847d0

Browse files
gh-133928: Improvements to using/windows.rst (GH-133952)
(cherry picked from commit fc3cddd) Co-authored-by: Steve Dower <[email protected]>
1 parent 5632e93 commit 24847d0

File tree

1 file changed

+12
-9
lines changed

1 file changed

+12
-9
lines changed

Doc/using/windows.rst

+12-9
Original file line numberDiff line numberDiff line change
@@ -77,15 +77,10 @@ To install the file downloaded from python.org, either double-click and select
7777
"Install", or run ``Add-AppxPackage <path to MSIX>`` in Windows Powershell.
7878

7979
After installation, the ``python``, ``py``, and ``pymanager`` commands should be
80-
available. If they are not, click Start and search for "Manage app execution
81-
aliases". This settings page will let you enable the relevant commands. They
82-
will be labelled "Python (default)", "Python (default windowed)", and "Python
83-
install manager".
84-
85-
If you have existing installations of Python, or you have modified your
86-
:envvar:`PATH` variable, you may need to remove them or undo the modifications
87-
in order for the commands to work. Old versions of Python can be reinstalled
88-
using the Python install manager.
80+
available. If you have existing installations of Python, or you have modified
81+
your :envvar:`PATH` variable, you may need to remove them or undo the
82+
modifications. See :ref:`pymanager-troubleshoot` for more help with fixing
83+
non-working commands.
8984

9085
When you first install a runtime, you will likely be prompted to add a directory
9186
to your :envvar:`PATH`. This is optional, if you prefer to use the ``py``
@@ -150,6 +145,10 @@ want to be passed to the runtime (such as script files or the module to launch):
150145
$> py -m this
151146
...
152147
148+
The default runtime can be overridden with the :envvar:`PYTHON_MANAGER_DEFAULT`
149+
environment variable, or a configuration file. See :ref:`pymanager-config` for
150+
information about configuration settings.
151+
153152
To launch a specific runtime, the ``py`` command accepts a ``-V:<TAG>`` option.
154153
This option must be specified before any others. The tag is part or all of the
155154
identifier for the runtime; for those from the CPython team, it looks like the
@@ -472,6 +471,10 @@ directory (which you may have added to your :envvar:`PATH` environment variable)
472471
can be used in a shebang, even if it is not on your :envvar:`PATH`. This allows
473472
the use of shebangs like ``/usr/bin/python3.12`` to select a particular runtime.
474473

474+
If no runtimes are installed, or if automatic installation is enabled, the
475+
requested runtime will be installed if necessary. See :ref:`pymanager-config`
476+
for information about configuration settings.
477+
475478
The ``/usr/bin/env`` form of shebang line will also search the :envvar:`PATH`
476479
environment variable for unrecognized commands. This corresponds to the
477480
behaviour of the Unix ``env`` program, which performs the same search, but

0 commit comments

Comments
 (0)