You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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 <[email protected]>
Co-authored-by: Ezio Melotti <[email protected]>
(cherry picked from commit 9859581)
Co-authored-by: C.A.M. Gerlach <[email protected]>
Copy file name to clipboardExpand all lines: Doc/whatsnew/3.11.rst
+26-24Lines changed: 26 additions & 24 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -202,6 +202,32 @@ default traceback. See :pep:`678` for more details. (Contributed by
202
202
Irit Katriel in :issue:`45607`.)
203
203
204
204
205
+
.. _whatsnew311-windows-launcher:
206
+
207
+
Windows ``py.exe`` launcher improvements
208
+
----------------------------------------
209
+
210
+
The copy of the :ref:`launcher` included with Python 3.11 has been significantly
211
+
updated. It now supports company/tag syntax as defined in :pep:`514` using the
212
+
``-V:<company>/<tag>`` argument instead of the limited ``-<major>.<minor>``.
213
+
This allows launching distributions other than ``PythonCore``,
214
+
the one hosted on `python.org <https://python.org>`_.
215
+
216
+
When using ``-V:`` selectors, either company or tag can be omitted, but all
217
+
installs will be searched. For example, ``-V:OtherPython/`` will select the
218
+
"best" tag registered for ``OtherPython``, while ``-V:3.11`` or ``-V:/3.11``
219
+
will select the "best" distribution with tag ``3.11``.
220
+
221
+
When using the legacy ``-<major>``, ``-<major>.<minor>``,
222
+
``-<major>-<bitness>`` or ``-<major>.<minor>-<bitness>`` arguments,
223
+
all existing behaviour should be preserved from past versions,
224
+
and only releases from ``PythonCore`` will be selected.
225
+
However, the ``-64`` suffix now implies "not 32-bit" (not necessarily x86-64),
226
+
as there are multiple supported 64-bit platforms.
227
+
32-bit runtimes are detected by checking the runtime's tag for a ``-32`` suffix.
228
+
All releases of Python since 3.5 have included this in their 32-bit builds.
229
+
230
+
205
231
.. _new-feat-related-type-hints-311:
206
232
207
233
New Features Related to Type Hints
@@ -369,30 +395,6 @@ PEP 563 May Not Be the Future
369
395
that was planned for this release has been indefinitely postponed.
370
396
See `this message <https://mail.python.org/archives/list/[email protected]/message/VIZEBX5EYMSYIJNDBF6DMUMZOCWHARSO/>`_ for more information.
371
397
372
-
Windows py.exe launcher improvements
373
-
------------------------------------
374
-
375
-
The copy of :ref:`launcher` included with Python 3.11 has been significantly
376
-
updated. It now supports company/tag syntax as defined in :pep:`514` using the
377
-
``-V:<company>/<tag>`` argument instead of the limited ``-x.y`` argument. This
378
-
allows launching distributions other than ``PythonCore``, which is the one
379
-
obtained from `python.org <https://python.org>`_.
380
-
381
-
When using ``-V:`` selectors, either company or tag can be omitted, but all
382
-
installs will be searched. For example, ``-V:OtherPython/`` will select the
383
-
"best" tag registered for ``OtherPython``, while ``-V:3.11`` or ``-V:/3.11``
384
-
will select the "best" distribution with tag ``3.11``.
385
-
386
-
When using legacy ``-x``, ``-x.y``, ``-x-ZZ`` or ``-x.y-ZZ`` arguments, all
387
-
existing behaviour should be preserved from past versions. Only releases from
388
-
``PythonCore`` will be selected. However, the ``-64`` suffix now implies "not
389
-
32-bit", as there are multiple supported 64-bit platforms. 32-bit runtimes are
390
-
detected by checking its tag for a ``-32`` suffix. All releases of Python
391
-
since 3.5 have included this in their 32-bit builds.
0 commit comments