File tree Expand file tree Collapse file tree 1 file changed +13
-3
lines changed
Expand file tree Collapse file tree 1 file changed +13
-3
lines changed Original file line number Diff line number Diff 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 ``
You can’t perform that action at this time.
0 commit comments