Skip to content

Commit 60f2a68

Browse files
committed
Resolve reference warnings in using/windows.rst
1 parent 98b4cd6 commit 60f2a68

File tree

2 files changed

+18
-4
lines changed

2 files changed

+18
-4
lines changed

Doc/tools/.nitignore

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,6 @@ Doc/library/xmlrpc.server.rst
5858
Doc/library/zlib.rst
5959
Doc/reference/compound_stmts.rst
6060
Doc/reference/datamodel.rst
61-
Doc/using/windows.rst
6261
Doc/whatsnew/2.4.rst
6362
Doc/whatsnew/2.5.rst
6463
Doc/whatsnew/2.6.rst

Doc/using/windows.rst

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -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.
18021802
If an executable matching the first argument after the ``env`` command cannot
18031803
be found, but the argument starts with ``python``, it will be handled as
18041804
described 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

18081808
Shebang 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".
18681868
For 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+
18711874
If no version qualifiers are found in a command, the environment
18721875
variable :envvar:`PY_PYTHON` can be set to specify the default version
18731876
qualifier. 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+
19451951
If an environment variable :envvar:`PYLAUNCHER_DEBUG` is set (to any value), the
19461952
launcher will print diagnostic information to stderr (i.e. to the console).
19471953
While this information manages to be simultaneously verbose *and* terse, it
@@ -1952,6 +1958,9 @@ target Python. It is primarily intended for testing and debugging.
19521958
Dry Run
19531959
-------
19541960

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

1974+
.. envvar:: PYLAUNCHER_ALLOW_INSTALL
1975+
:no-typesetting:
1976+
19651977
If an environment variable :envvar:`PYLAUNCHER_ALLOW_INSTALL` is set (to any
19661978
value), and the requested Python version is not installed but is available on
19671979
the Microsoft Store, the launcher will attempt to install it. This may require
19681980
user interaction to complete, and you may need to run the command again.
19691981

1982+
.. envvar:: PYLAUNCHER_ALWAYS_INSTALL
1983+
:no-typesetting:
1984+
19701985
An additional :envvar:`PYLAUNCHER_ALWAYS_INSTALL` variable causes the launcher
19711986
to always try to install Python, even if it is detected. This is mainly intended
19721987
for testing (and should be used with :envvar:`PYLAUNCHER_DRYRUN`).

0 commit comments

Comments
 (0)