Skip to content

Commit 818e8f6

Browse files
committed
More notes about auto install
1 parent 1090e98 commit 818e8f6

File tree

1 file changed

+13
-3
lines changed

1 file changed

+13
-3
lines changed

Doc/using/windows.rst

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -299,6 +299,14 @@ To launch the runtime, directly execute the main executable (typically
299299
300300
$> py install ... [-t=|--target=<PATH>] <TAG>
301301
302+
The ``py exec`` command will install the requested runtime if it is not already
303+
present. This is controlled by the ``automatic_install`` configuration
304+
(:envvar:`PYTHON_MANAGER_AUTOMATIC_INSTALL`), and is enabled by default.
305+
If no runtimes are available at all, all launch commands will do an automatic
306+
install if the configuration setting allows. This is to ensure a good experience
307+
for new users, but should not generally be relied on rather than using the
308+
``py exec`` command or explicit install commands.
309+
302310

303311
.. _pymanager-offline:
304312

@@ -424,9 +432,11 @@ customization.
424432
By default, :file:`%TEMP%`.
425433

426434
* - ``automatic_install``
427-
- ``PYTHON_MANAGER_AUTOMATIC_INSTALL``
428-
- True to allow automatic installs when using ``py exec`` to launch.
429-
Other commands will not automatically install.
435+
- .. envvar:: PYTHON_MANAGER_AUTOMATIC_INSTALL
436+
- True to allow automatic installs when using ``py exec`` to launch (or
437+
``py`` when no runtimes are installed yet).
438+
Other commands will not automatically install, regardless of this
439+
setting.
430440
By default, true.
431441

432442
* - ``include_unmanaged``

0 commit comments

Comments
 (0)