@@ -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
7979After 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
9085When you first install a runtime, you will likely be prompted to add a directory
9186to 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+
153152To launch a specific runtime, the ``py `` command accepts a ``-V:<TAG> `` option.
154153This option must be specified before any others. The tag is part or all of the
155154identifier 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)
472471can be used in a shebang, even if it is not on your :envvar: `PATH `. This allows
473472the 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+
475478The ``/usr/bin/env `` form of shebang line will also search the :envvar: `PATH `
476479environment variable for unrecognized commands. This corresponds to the
477480behaviour of the Unix ``env `` program, which performs the same search, but
0 commit comments