Skip to content

Commit 460265f

Browse files
[3.14] GH-101100: Resolve reference warnings in using/windows.rst (GH-138416) (#138461)
Co-authored-by: Adam Turner <[email protected]>
1 parent 8e1c2fe commit 460265f

File tree

2 files changed

+9
-10
lines changed

2 files changed

+9
-10
lines changed

Doc/tools/.nitignore

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,6 @@ Doc/library/xmlrpc.server.rst
5656
Doc/library/zlib.rst
5757
Doc/reference/compound_stmts.rst
5858
Doc/reference/datamodel.rst
59-
Doc/using/windows.rst
6059
Doc/whatsnew/2.4.rst
6160
Doc/whatsnew/2.5.rst
6261
Doc/whatsnew/2.6.rst

Doc/using/windows.rst

Lines changed: 9 additions & 9 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

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

18031803
Shebang lines that do not match any of these patterns are looked up in the
@@ -1864,7 +1864,7 @@ For example, a shebang line of ``#!python`` has no version qualifier, while
18641864
``#!python3`` has a version qualifier which specifies only a major version.
18651865

18661866
If no version qualifiers are found in a command, the environment
1867-
variable :envvar:`PY_PYTHON` can be set to specify the default version
1867+
variable :envvar:`!PY_PYTHON` can be set to specify the default version
18681868
qualifier. If it is not set, the default is "3". The variable can
18691869
specify any value that may be passed on the command line, such as "3",
18701870
"3.7", "3.7-32" or "3.7-64". (Note that the "-64" option is only
@@ -1937,7 +1937,7 @@ For example:
19371937
Diagnostics
19381938
-----------
19391939

1940-
If an environment variable :envvar:`PYLAUNCHER_DEBUG` is set (to any value), the
1940+
If an environment variable :envvar:`!PYLAUNCHER_DEBUG` is set (to any value), the
19411941
launcher will print diagnostic information to stderr (i.e. to the console).
19421942
While this information manages to be simultaneously verbose *and* terse, it
19431943
should allow you to see what versions of Python were located, why a
@@ -1947,7 +1947,7 @@ target Python. It is primarily intended for testing and debugging.
19471947
Dry Run
19481948
-------
19491949

1950-
If an environment variable :envvar:`PYLAUNCHER_DRYRUN` is set (to any value),
1950+
If an environment variable :envvar:`!PYLAUNCHER_DRYRUN` is set (to any value),
19511951
the launcher will output the command it would have run, but will not actually
19521952
launch Python. This may be useful for tools that want to use the launcher to
19531953
detect and then launch Python directly. Note that the command written to
@@ -1957,14 +1957,14 @@ the console.
19571957
Install on demand
19581958
-----------------
19591959

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

1965-
An additional :envvar:`PYLAUNCHER_ALWAYS_INSTALL` variable causes the launcher
1965+
An additional :envvar:`!PYLAUNCHER_ALWAYS_INSTALL` variable causes the launcher
19661966
to always try to install Python, even if it is detected. This is mainly intended
1967-
for testing (and should be used with :envvar:`PYLAUNCHER_DRYRUN`).
1967+
for testing (and should be used with :envvar:`!PYLAUNCHER_DRYRUN`).
19681968

19691969
Return codes
19701970
------------

0 commit comments

Comments
 (0)