Skip to content

Commit 73806a6

Browse files
committed
Suppress xrefs for deprecated environment variables
1 parent 60f2a68 commit 73806a6

File tree

1 file changed

+6
-21
lines changed

1 file changed

+6
-21
lines changed

Doc/using/windows.rst

Lines changed: 6 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1868,11 +1868,8 @@ 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-
18741871
If no version qualifiers are found in a command, the environment
1875-
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
18761873
qualifier. If it is not set, the default is "3". The variable can
18771874
specify any value that may be passed on the command line, such as "3",
18781875
"3.7", "3.7-32" or "3.7-64". (Note that the "-64" option is only
@@ -1945,10 +1942,7 @@ For example:
19451942
Diagnostics
19461943
-----------
19471944

1948-
.. envvar:: PYLAUNCHER_DEBUG
1949-
:no-typesetting:
1950-
1951-
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
19521946
launcher will print diagnostic information to stderr (i.e. to the console).
19531947
While this information manages to be simultaneously verbose *and* terse, it
19541948
should allow you to see what versions of Python were located, why a
@@ -1958,10 +1952,7 @@ target Python. It is primarily intended for testing and debugging.
19581952
Dry Run
19591953
-------
19601954

1961-
.. envvar:: PYLAUNCHER_DRYRUN
1962-
:no-typesetting:
1963-
1964-
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),
19651956
the launcher will output the command it would have run, but will not actually
19661957
launch Python. This may be useful for tools that want to use the launcher to
19671958
detect and then launch Python directly. Note that the command written to
@@ -1971,20 +1962,14 @@ the console.
19711962
Install on demand
19721963
-----------------
19731964

1974-
.. envvar:: PYLAUNCHER_ALLOW_INSTALL
1975-
:no-typesetting:
1976-
1977-
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
19781966
value), and the requested Python version is not installed but is available on
19791967
the Microsoft Store, the launcher will attempt to install it. This may require
19801968
user interaction to complete, and you may need to run the command again.
19811969

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

19891974
Return codes
19901975
------------

0 commit comments

Comments
 (0)