Skip to content

Commit df9e348

Browse files
AA-Turnerlkollar
authored andcommitted
pythonGH-101100: Resolve reference warnings in using/windows.rst (python#138416)
1 parent 8de41f5 commit df9e348

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

@@ -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
@@ -1869,7 +1869,7 @@ 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

18711871
If no version qualifiers are found in a command, the environment
1872-
variable :envvar:`PY_PYTHON` can be set to specify the default version
1872+
variable :envvar:`!PY_PYTHON` can be set to specify the default version
18731873
qualifier. If it is not set, the default is "3". The variable can
18741874
specify any value that may be passed on the command line, such as "3",
18751875
"3.7", "3.7-32" or "3.7-64". (Note that the "-64" option is only
@@ -1942,7 +1942,7 @@ For example:
19421942
Diagnostics
19431943
-----------
19441944

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

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

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

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

19741974
Return codes
19751975
------------

0 commit comments

Comments
 (0)