@@ -398,7 +398,7 @@ customization.
398398 - Description
399399
400400 * - ``default_tag ``
401- - `` PYTHON_MANAGER_DEFAULT ``
401+ - .. envvar:: PYTHON_MANAGER_DEFAULT
402402 - The preferred default version to launch or install.
403403 By default, this is interpreted as the most recent non-prerelease version
404404 from the CPython team.
@@ -812,7 +812,7 @@ default).
812812 ``python.exe `` alias is set to "Python (default)"
813813
814814 * - ``python `` and ``py `` don't launch the runtime I expect
815- - Check your `` PYTHON_MANAGER_DEFAULT ` ` environment variable
815+ - Check your :envvar: ` PYTHON_MANAGER_DEFAULT ` environment variable
816816 or ``default_tag `` configuration.
817817 The ``py list `` command will show your default based on these settings.
818818
@@ -1802,7 +1802,7 @@ program, which performs a :envvar:`PATH` search.
18021802If an executable matching the first argument after the ``env `` command cannot
18031803be found, but the argument starts with ``python ``, it will be handled as
18041804described for the other virtual commands.
1805- The environment variable :envvar: `PYLAUNCHER_NO_SEARCH_PATH ` may be set
1805+ The environment variable :envvar: `! PYLAUNCHER_NO_SEARCH_PATH ` may be set
18061806(to any value) to skip this search of :envvar: `PATH `.
18071807
18081808Shebang lines that do not match any of these patterns are looked up in the
@@ -1868,6 +1868,9 @@ if a 32 or 64 bit implementation shall be requested by adding "-32" or "-64".
18681868For example, a shebang line of ``#!python `` has no version qualifier, while
18691869``#!python3 `` has a version qualifier which specifies only a major version.
18701870
1871+ .. envvar :: PY_PYTHON
1872+ :no-typesetting:
1873+
18711874If no version qualifiers are found in a command, the environment
18721875variable :envvar: `PY_PYTHON ` can be set to specify the default version
18731876qualifier. If it is not set, the default is "3". The variable can
@@ -1942,6 +1945,9 @@ For example:
19421945 Diagnostics
19431946-----------
19441947
1948+ .. envvar :: PYLAUNCHER_DEBUG
1949+ :no-typesetting:
1950+
19451951If an environment variable :envvar: `PYLAUNCHER_DEBUG ` is set (to any value), the
19461952launcher will print diagnostic information to stderr (i.e. to the console).
19471953While this information manages to be simultaneously verbose *and * terse, it
@@ -1952,6 +1958,9 @@ target Python. It is primarily intended for testing and debugging.
19521958Dry Run
19531959-------
19541960
1961+ .. envvar :: PYLAUNCHER_DRYRUN
1962+ :no-typesetting:
1963+
19551964If an environment variable :envvar: `PYLAUNCHER_DRYRUN ` is set (to any value),
19561965the launcher will output the command it would have run, but will not actually
19571966launch Python. This may be useful for tools that want to use the launcher to
@@ -1962,11 +1971,17 @@ the console.
19621971Install on demand
19631972-----------------
19641973
1974+ .. envvar :: PYLAUNCHER_ALLOW_INSTALL
1975+ :no-typesetting:
1976+
19651977If an environment variable :envvar: `PYLAUNCHER_ALLOW_INSTALL ` is set (to any
19661978value), and the requested Python version is not installed but is available on
19671979the Microsoft Store, the launcher will attempt to install it. This may require
19681980user interaction to complete, and you may need to run the command again.
19691981
1982+ .. envvar :: PYLAUNCHER_ALWAYS_INSTALL
1983+ :no-typesetting:
1984+
19701985An additional :envvar: `PYLAUNCHER_ALWAYS_INSTALL ` variable causes the launcher
19711986to always try to install Python, even if it is detected. This is mainly intended
19721987for testing (and should be used with :envvar: `PYLAUNCHER_DRYRUN `).
0 commit comments