@@ -77,15 +77,10 @@ To install the file downloaded from python.org, either double-click and select
77
77
"Install", or run ``Add-AppxPackage <path to MSIX> `` in Windows Powershell.
78
78
79
79
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.
89
84
90
85
When you first install a runtime, you will likely be prompted to add a directory
91
86
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):
150
145
$> py -m this
151
146
...
152
147
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
+
153
152
To launch a specific runtime, the ``py `` command accepts a ``-V:<TAG> `` option.
154
153
This option must be specified before any others. The tag is part or all of the
155
154
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)
472
471
can be used in a shebang, even if it is not on your :envvar: `PATH `. This allows
473
472
the use of shebangs like ``/usr/bin/python3.12 `` to select a particular runtime.
474
473
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
+
475
478
The ``/usr/bin/env `` form of shebang line will also search the :envvar: `PATH `
476
479
environment variable for unrecognized commands. This corresponds to the
477
480
behaviour of the Unix ``env `` program, which performs the same search, but
0 commit comments