mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-10-03 13:45:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

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

Browse source 
* Move Windows py.exe improvements from Typing section to New Features

* Add ref target label and use literal for py.exe

* Be clearer/explict about what legacy version arg components reprisent

* Apply other minor clarity and textual fixes to py.exe launcher text

* Refine phrasing of legacy sentence of py.exe desc

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>

Co-authored-by: Ezio Melotti <ezio.melotti@gmail.com>
(cherry picked from commit 985958187d)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
This commit is contained in:
Miss Islington (bot) 2022-10-04 15:58:59 -07:00 • committed by Pablo Galindo
parent 52709b2099
commit 028e7d47cd
No known key found for this signature in database
GPG key ID: FFE87404168BD847
1 changed files with 26 additions and 24 deletions
Download patch file Download diff file Expand all files Collapse all files

50
Doc/whatsnew/3.11.rst
View file

@ -202,6 +202,32 @@ default traceback. See :pep:`678` for more details. (Contributed by
Irit Katriel in :issue:`45607`.) Irit Katriel in :issue:`45607`.)
.. _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: .. _new-feat-related-type-hints-311:
New Features Related to Type Hints New Features Related to Type Hints
@ -369,30 +395,6 @@ PEP 563 May Not Be the Future
that was planned for this release has been indefinitely postponed. that was planned for this release has been indefinitely postponed.
See `this message <https://mail.python.org/archives/list/python-dev@python.org/message/VIZEBX5EYMSYIJNDBF6DMUMZOCWHARSO/>`_ for more information. See `this message <https://mail.python.org/archives/list/python-dev@python.org/message/VIZEBX5EYMSYIJNDBF6DMUMZOCWHARSO/>`_ 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.
.. _whatsnew311-other-lang-changes:
Other Language Changes Other Language Changes
====================== ======================