Skip to content

gh-95913: Move py.exe to appropriate What's New section & refine text #97718

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
merged 5 commits into from
Oct 4, 2022
Merged

gh-95913: Move py.exe to appropriate What's New section & refine text #97718

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
aea1a8b
Move Windows py.exe improvements from Typing section to New Features
CAM-Gerlach Oct 2, 2022
80538dd
Add ref target label and use literal for py.exe
CAM-Gerlach Oct 2, 2022
55c2d5b
Be clearer/explict about what legacy version arg components reprisent
CAM-Gerlach Oct 2, 2022
cd71489
Apply other minor clarity and textual fixes to py.exe launcher text
CAM-Gerlach Oct 2, 2022
ec51650
Refine phrasing of legacy sentence of py.exe desc
CAM-Gerlach Oct 4, 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
48 changes: 26 additions & 22 deletions Doc/whatsnew/3.11.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -207,6 +207,32 @@ See :pep:`678` for more details.
PEP written by Zac Hatfield-Dodds.)


.. _whatsnew311-windows-launcher:

Windows ``py.exe`` launcher improvements
----------------------------------------

The copy of the :ref:`launcher` included with Python 3.11 has been significantly
updated. It now supports company/tag syntax as defined in :pep:`514` using the
``-V:<company>/<tag>`` argument instead of the limited ``-<major>.<minor>``.
This allows launching distributions other than ``PythonCore``,
the one hosted on `python.org <https://python.org>`_.

When using ``-V:`` selectors, either company or tag can be omitted, but all
installs will be searched. For example, ``-V:OtherPython/`` will select the
"best" tag registered for ``OtherPython``, while ``-V:3.11`` or ``-V:/3.11``
will select the "best" distribution with tag ``3.11``.

When using the legacy ``-<major>``, ``-<major>.<minor>``,
``-<major>-<bitness>`` or ``-<major>.<minor>-<bitness>`` arguments,
all existing behaviour should be preserved from past versions,
and only releases from ``PythonCore`` will be selected.
However, the ``-64`` suffix now implies "not 32-bit" (not necessarily x86-64),
as there are multiple supported 64-bit platforms.
32-bit runtimes are detected by checking the runtime's tag for a ``-32`` suffix.
All releases of Python since 3.5 have included this in their 32-bit builds.


.. _new-feat-related-type-hints-311:
.. _whatsnew311-typing-features:

Expand Down Expand Up @@ -401,28 +427,6 @@ See `this message from the Steering Council <https://mail.python.org/archives/li
for more information.


Windows py.exe launcher improvements
------------------------------------

The copy of :ref:`launcher` included with Python 3.11 has been significantly
updated. It now supports company/tag syntax as defined in :pep:`514` using the
``-V:<company>/<tag>`` argument instead of the limited ``-x.y`` argument. This
allows launching distributions other than ``PythonCore``, which is the one
obtained from `python.org <https://python.org>`_.

When using ``-V:`` selectors, either company or tag can be omitted, but all
installs will be searched. For example, ``-V:OtherPython/`` will select the
"best" tag registered for ``OtherPython``, while ``-V:3.11`` or ``-V:/3.11``
will select the "best" distribution with tag ``3.11``.

When using legacy ``-x``, ``-x.y``, ``-x-ZZ`` or ``-x.y-ZZ`` arguments, all
existing behaviour should be preserved from past versions. Only releases from
``PythonCore`` will be selected. However, the ``-64`` suffix now implies "not
32-bit", as there are multiple supported 64-bit platforms. 32-bit runtimes are
detected by checking its tag for a ``-32`` suffix. All releases of Python
since 3.5 have included this in their 32-bit builds.


Other Language Changes
======================

Expand Down