Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion Doc/tools/.nitignore
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,6 @@ Doc/library/xmlrpc.server.rst
Doc/library/zlib.rst
Doc/reference/compound_stmts.rst
Doc/reference/datamodel.rst
Doc/using/windows.rst
Doc/whatsnew/2.4.rst
Doc/whatsnew/2.5.rst
Doc/whatsnew/2.6.rst
Expand Down
21 changes: 18 additions & 3 deletions Doc/using/windows.rst
Original file line number Diff line number Diff line change
Expand Up @@ -398,7 +398,7 @@ customization.
- Description

* - ``default_tag``
- ``PYTHON_MANAGER_DEFAULT``
- .. envvar:: PYTHON_MANAGER_DEFAULT
- The preferred default version to launch or install.
By default, this is interpreted as the most recent non-prerelease version
from the CPython team.
Expand Down Expand Up @@ -812,7 +812,7 @@ default).
``python.exe`` alias is set to "Python (default)"

* - ``python`` and ``py`` don't launch the runtime I expect
- Check your ``PYTHON_MANAGER_DEFAULT`` environment variable
- Check your :envvar:`PYTHON_MANAGER_DEFAULT` environment variable
or ``default_tag`` configuration.
The ``py list`` command will show your default based on these settings.

Expand Down Expand Up @@ -1802,7 +1802,7 @@ program, which performs a :envvar:`PATH` search.
If an executable matching the first argument after the ``env`` command cannot
be found, but the argument starts with ``python``, it will be handled as
described for the other virtual commands.
The environment variable :envvar:`PYLAUNCHER_NO_SEARCH_PATH` may be set
The environment variable :envvar:`!PYLAUNCHER_NO_SEARCH_PATH` may be set
(to any value) to skip this search of :envvar:`PATH`.

Shebang lines that do not match any of these patterns are looked up in the
Expand Down Expand Up @@ -1868,6 +1868,9 @@ if a 32 or 64 bit implementation shall be requested by adding "-32" or "-64".
For example, a shebang line of ``#!python`` has no version qualifier, while
``#!python3`` has a version qualifier which specifies only a major version.

.. envvar:: PY_PYTHON
:no-typesetting:

If no version qualifiers are found in a command, the environment
variable :envvar:`PY_PYTHON` can be set to specify the default version
qualifier. If it is not set, the default is "3". The variable can
Expand Down Expand Up @@ -1942,6 +1945,9 @@ For example:
Diagnostics
-----------

.. envvar:: PYLAUNCHER_DEBUG
:no-typesetting:

If an environment variable :envvar:`PYLAUNCHER_DEBUG` is set (to any value), the
launcher will print diagnostic information to stderr (i.e. to the console).
While this information manages to be simultaneously verbose *and* terse, it
Expand All @@ -1952,6 +1958,9 @@ target Python. It is primarily intended for testing and debugging.
Dry Run
-------

.. envvar:: PYLAUNCHER_DRYRUN
:no-typesetting:

If an environment variable :envvar:`PYLAUNCHER_DRYRUN` is set (to any value),
the launcher will output the command it would have run, but will not actually
launch Python. This may be useful for tools that want to use the launcher to
Expand All @@ -1962,11 +1971,17 @@ the console.
Install on demand
-----------------

.. envvar:: PYLAUNCHER_ALLOW_INSTALL
:no-typesetting:

If an environment variable :envvar:`PYLAUNCHER_ALLOW_INSTALL` is set (to any
value), and the requested Python version is not installed but is available on
the Microsoft Store, the launcher will attempt to install it. This may require
user interaction to complete, and you may need to run the command again.

.. envvar:: PYLAUNCHER_ALWAYS_INSTALL
:no-typesetting:

An additional :envvar:`PYLAUNCHER_ALWAYS_INSTALL` variable causes the launcher
to always try to install Python, even if it is detected. This is mainly intended
for testing (and should be used with :envvar:`PYLAUNCHER_DRYRUN`).
Expand Down
Loading