Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit a685cc0

Browse filesBrowse files
gh-95913: Move py.exe to appropriate What's New section & refine text (GH-97718)
* 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 9859581) Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>
1 parent 5fdce5d commit a685cc0
Copy full SHA for a685cc0

File tree

Expand file treeCollapse file tree

1 file changed

+26
-22
lines changed
Filter options
Expand file treeCollapse file tree

1 file changed

+26
-22
lines changed

‎Doc/whatsnew/3.11.rst

Copy file name to clipboardExpand all lines: Doc/whatsnew/3.11.rst
+26-22Lines changed: 26 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,32 @@ See :pep:`678` for more details.
207207
PEP written by Zac Hatfield-Dodds.)
208208

209209

210+
.. _whatsnew311-windows-launcher:
211+
212+
Windows ``py.exe`` launcher improvements
213+
----------------------------------------
214+
215+
The copy of the :ref:`launcher` included with Python 3.11 has been significantly
216+
updated. It now supports company/tag syntax as defined in :pep:`514` using the
217+
``-V:<company>/<tag>`` argument instead of the limited ``-<major>.<minor>``.
218+
This allows launching distributions other than ``PythonCore``,
219+
the one hosted on `python.org <https://python.org>`_.
220+
221+
When using ``-V:`` selectors, either company or tag can be omitted, but all
222+
installs will be searched. For example, ``-V:OtherPython/`` will select the
223+
"best" tag registered for ``OtherPython``, while ``-V:3.11`` or ``-V:/3.11``
224+
will select the "best" distribution with tag ``3.11``.
225+
226+
When using the legacy ``-<major>``, ``-<major>.<minor>``,
227+
``-<major>-<bitness>`` or ``-<major>.<minor>-<bitness>`` arguments,
228+
all existing behaviour should be preserved from past versions,
229+
and only releases from ``PythonCore`` will be selected.
230+
However, the ``-64`` suffix now implies "not 32-bit" (not necessarily x86-64),
231+
as there are multiple supported 64-bit platforms.
232+
32-bit runtimes are detected by checking the runtime's tag for a ``-32`` suffix.
233+
All releases of Python since 3.5 have included this in their 32-bit builds.
234+
235+
210236
.. _new-feat-related-type-hints-311:
211237
.. _whatsnew311-typing-features:
212238

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

403429

404-
Windows py.exe launcher improvements
405-
------------------------------------
406-
407-
The copy of :ref:`launcher` included with Python 3.11 has been significantly
408-
updated. It now supports company/tag syntax as defined in :pep:`514` using the
409-
``-V:<company>/<tag>`` argument instead of the limited ``-x.y`` argument. This
410-
allows launching distributions other than ``PythonCore``, which is the one
411-
obtained from `python.org <https://python.org>`_.
412-
413-
When using ``-V:`` selectors, either company or tag can be omitted, but all
414-
installs will be searched. For example, ``-V:OtherPython/`` will select the
415-
"best" tag registered for ``OtherPython``, while ``-V:3.11`` or ``-V:/3.11``
416-
will select the "best" distribution with tag ``3.11``.
417-
418-
When using legacy ``-x``, ``-x.y``, ``-x-ZZ`` or ``-x.y-ZZ`` arguments, all
419-
existing behaviour should be preserved from past versions. Only releases from
420-
``PythonCore`` will be selected. However, the ``-64`` suffix now implies "not
421-
32-bit", as there are multiple supported 64-bit platforms. 32-bit runtimes are
422-
detected by checking its tag for a ``-32`` suffix. All releases of Python
423-
since 3.5 have included this in their 32-bit builds.
424-
425-
426430
Other Language Changes
427431
======================
428432

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.