Skip to content

gh-76773: Update docs mentioning no-longer-supported Windows versions & features #92529

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
serhiy-storchaka merged 8 commits into from
May 10, 2022
Merged

gh-76773: Update docs mentioning no-longer-supported Windows versions & features #92529

Changes from 1 commit
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
12808fb
qh-76773: Update/remove obselete parts of the Windows guide
CAM-Gerlach May 9, 2022
4501df5
qh-76773: Update outdated links in the Python on Windows guide
CAM-Gerlach May 9, 2022
e880a15
qh-76773: Update mentions of obselete Python versions in Windows guide
CAM-Gerlach May 9, 2022
f84fbbf
qh-76773: Update refs to ancient Windows versions in PC/PCBuild READMEs
CAM-Gerlach May 9, 2022
c17f901
qh-76773: Update outdated/broken links in PC/PCBuild READMEs
CAM-Gerlach May 9, 2022
234aa3c
qh-76773: Update misc docs mentioning obselete DOS, WinCE & Borland
CAM-Gerlach May 9, 2022
637ce8e
qh-76773: Elide/use consistant Win/MSVC/Py versions in Win docs
CAM-Gerlach May 9, 2022
34e1254
qh-76773: Revert py ver change 1 place in win doc & clean up code blocks
CAM-Gerlach May 10, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
qh-76773: Update mentions of obselete Python versions in Windows guide
  • Loading branch information
@CAM-Gerlach
CAM-Gerlach committed May 9, 2022
commit e880a15a38d8672494d055f49a3201d1c8c9c83b
46 changes: 23 additions & 23 deletions Doc/using/windows.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -559,9 +559,9 @@ System variables, you need non-restricted access to your machine
Windows will concatenate User variables *after* System variables, which may
cause unexpected results when modifying :envvar:`PATH`.

The :envvar:`PYTHONPATH` variable is used by all versions of Python 2 and
Python 3, so you should not permanently configure this variable unless it
only includes code that is compatible with all of your installed Python
The :envvar:`PYTHONPATH` variable is used by all versions of Python,
so you should not permanently configure it unless the listed paths
only include code that is compatible with all of your installed Python
versions.

.. seealso::
Expand Down Expand Up @@ -682,22 +682,22 @@ You should find that the latest version of Python you have installed is
started - it can be exited as normal, and any additional command-line
arguments specified will be sent directly to Python.

If you have multiple versions of Python installed (e.g., 2.7 and |version|) you
will have noticed that Python |version| was started - to launch Python 2.7, try
If you have multiple versions of Python installed (e.g., 3.7 and |version|) you
will have noticed that Python |version| was started - to launch Python 3.7, try
the command:

::

py -2.7
py -3.7

If you want the latest version of Python 2.x you have installed, try the
If you want the latest version of Python 3 you have installed, try the
command:

::

py -2
py -3
Copy link
Copy Markdown
Member

@serhiy-storchaka serhiy-storchaka May 9, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It looks superfluous. Just py starts the latest Python version, and currently it is the latest Python 3 version.

Copy link
Copy Markdown
Member Author

@CAM-Gerlach CAM-Gerlach May 9, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point, thanks. Would you like me to revert the change to keep py -2, or elide the whole mention as superflous?

Copy link
Copy Markdown
Member

@brettcannon brettcannon May 10, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As long as there is an example of using py you can leave it as it's a feature that is still supported.

Copy link
Copy Markdown
Member

@serhiy-storchaka serhiy-storchaka May 10, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I interpret it as you can leave py -2.

Copy link
Copy Markdown
Member Author

@CAM-Gerlach CAM-Gerlach May 10, 2022

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Okay, thanks. I reverted it to that, and also cleaned up the reST code block syntax on or near the lines I touched.


You should find the latest version of Python 2.x starts.
You should find the latest version of Python 3.x starts.

If you see the following error, you do not have the launcher installed:

Expand Down Expand Up @@ -754,9 +754,9 @@ is printed. Now try changing the first line to be:

Re-executing the command should now print the latest Python 3.x information.
As with the above command-line examples, you can specify a more explicit
version qualifier. Assuming you have Python 2.6 installed, try changing the
first line to ``#! python2.6`` and you should find the 2.6 version
information printed.
version qualifier. Assuming you have Python |version| installed, try changing
Comment thread
CAM-Gerlach marked this conversation as resolved.
Outdated
the first line to "#! python|version|" and you should find the |version|
version information printed.

Note that unlike interactive use, a bare "python" will use the latest
version of Python 2.x that you have installed. This is for backward
Expand Down Expand Up @@ -809,8 +809,8 @@ shebang lines starting with ``/usr``.
Any of the above virtual commands can be suffixed with an explicit version
(either just the major version, or the major and minor version).
Furthermore the 32-bit version can be requested by adding "-32" after the
minor version. I.e. ``/usr/bin/python2.7-32`` will request usage of the
32-bit python 2.7.
minor version. I.e. ``/usr/bin/python3.7-32`` will request usage of the
32-bit python 3.7.

.. versionadded:: 3.7

Expand Down Expand Up @@ -903,19 +903,19 @@ Examples:
``python2`` will use the latest Python 2.x version installed and
the command ``python3`` will use the latest Python 3.x installed.

* The commands ``python3.1`` and ``python2.7`` will not consult any
* The commands ``python3.11`` and ``python3.7`` will not consult any
options at all as the versions are fully specified.

* If ``PY_PYTHON=3``, the commands ``python`` and ``python3`` will both use
the latest installed Python 3 version.

* If ``PY_PYTHON=3.1-32``, the command ``python`` will use the 32-bit
implementation of 3.1 whereas the command ``python3`` will use the latest
* If ``PY_PYTHON=3.11-32``, the command ``python`` will use the 32-bit
implementation of 3.11 whereas the command ``python3`` will use the latest
Comment thread
CAM-Gerlach marked this conversation as resolved.
Outdated
installed Python (PY_PYTHON was not considered at all as a major
version was specified.)

* If ``PY_PYTHON=3`` and ``PY_PYTHON3=3.1``, the commands
``python`` and ``python3`` will both use specifically 3.1
* If ``PY_PYTHON=3`` and ``PY_PYTHON3=3.11``, the commands
``python`` and ``python3`` will both use specifically 3.11
Comment thread
CAM-Gerlach marked this conversation as resolved.
Outdated

In addition to environment variables, the same settings can be configured
in the .INI file used by the launcher. The section in the INI file is
Expand All @@ -926,21 +926,21 @@ an environment variable will override things specified in the INI file.

For example:

* Setting ``PY_PYTHON=3.1`` is equivalent to the INI file containing:
* Setting ``PY_PYTHON=3.11`` is equivalent to the INI file containing:

.. code-block:: ini

[defaults]
python=3.1
python=3.11

* Setting ``PY_PYTHON=3`` and ``PY_PYTHON3=3.1`` is equivalent to the INI file
* Setting ``PY_PYTHON=3`` and ``PY_PYTHON3=3.11`` is equivalent to the INI file
containing:

.. code-block:: ini

[defaults]
python=3
python3=3.1
python3=3.11

Diagnostics
-----------
Expand Down