Skip to content

Commit 23bc77b

Browse files
authored
[3.13] GH-101100: Resolve reference warnings in using/windows.rst (#138416) (#138463)
Co-authored-by: Adam Turner <[email protected]>
1 parent 1ca2a4d commit 23bc77b

File tree

2 files changed

+8
-9
lines changed

2 files changed

+8
-9
lines changed

Doc/tools/.nitignore

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

Doc/using/windows.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -407,7 +407,7 @@ Instead, it will write to a private copy. If your scripts must modify the
407407
shared locations, you will need to install the full installer.
408408

409409
At runtime, Python will use a private copy of well-known Windows folders and the registry.
410-
For example, if the environment variable :envvar:`%APPDATA%` is :file:`c:\\Users\\<user>\\AppData\\`,
410+
For example, if the environment variable :envvar:`!%APPDATA%` is :file:`c:\\Users\\<user>\\AppData\\`,
411411
then when writing to :file:`C:\\Users\\<user>\\AppData\\Local` will write to
412412
:file:`C:\\Users\\<user>\\AppData\\Local\\Packages\\PythonSoftwareFoundation.Python.3.8_qbz5n2kfra8p0\\LocalCache\\Local\\`.
413413

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

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

10361036
If no version qualifiers are found in a command, the environment
1037-
variable :envvar:`PY_PYTHON` can be set to specify the default version
1037+
variable :envvar:`!PY_PYTHON` can be set to specify the default version
10381038
qualifier. If it is not set, the default is "3". The variable can
10391039
specify any value that may be passed on the command line, such as "3",
10401040
"3.7", "3.7-32" or "3.7-64". (Note that the "-64" option is only
@@ -1107,7 +1107,7 @@ For example:
11071107
Diagnostics
11081108
-----------
11091109

1110-
If an environment variable :envvar:`PYLAUNCHER_DEBUG` is set (to any value), the
1110+
If an environment variable :envvar:`!PYLAUNCHER_DEBUG` is set (to any value), the
11111111
launcher will print diagnostic information to stderr (i.e. to the console).
11121112
While this information manages to be simultaneously verbose *and* terse, it
11131113
should allow you to see what versions of Python were located, why a
@@ -1117,7 +1117,7 @@ target Python. It is primarily intended for testing and debugging.
11171117
Dry Run
11181118
-------
11191119

1120-
If an environment variable :envvar:`PYLAUNCHER_DRYRUN` is set (to any value),
1120+
If an environment variable :envvar:`!PYLAUNCHER_DRYRUN` is set (to any value),
11211121
the launcher will output the command it would have run, but will not actually
11221122
launch Python. This may be useful for tools that want to use the launcher to
11231123
detect and then launch Python directly. Note that the command written to
@@ -1127,14 +1127,14 @@ the console.
11271127
Install on demand
11281128
-----------------
11291129

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

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

11391139
Return codes
11401140
------------

0 commit comments

Comments
 (0)