From aea1a8b9dba491eeb8d7b7dcc5ec61f856469f82 Mon Sep 17 00:00:00 2001 From: "C.A.M. Gerlach" Date: Sat, 1 Oct 2022 20:13:05 -0500 Subject: [PATCH 1/5] Move Windows py.exe improvements from Typing section to New Features --- Doc/whatsnew/3.11.rst | 44 +++++++++++++++++++++---------------------- 1 file changed, 22 insertions(+), 22 deletions(-) diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index 0cd281edbe5b17..4ea0fe372b4378 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -207,6 +207,28 @@ See :pep:`678` for more details. PEP written by Zac Hatfield-Dodds.) +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:/`` argument instead of the limited ``-x.y`` argument. This +allows launching distributions other than ``PythonCore``, which is the one +obtained from `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. + + .. _new-feat-related-type-hints-311: .. _whatsnew311-typing-features: @@ -401,28 +423,6 @@ See `this message from the Steering Council /`` argument instead of the limited ``-x.y`` argument. This -allows launching distributions other than ``PythonCore``, which is the one -obtained from `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 ====================== From 80538dd89f9b5602540eab1f0f1d7352d1dcfe5d Mon Sep 17 00:00:00 2001 From: "C.A.M. Gerlach" Date: Sat, 1 Oct 2022 20:32:49 -0500 Subject: [PATCH 2/5] Add ref target label and use literal for py.exe --- Doc/whatsnew/3.11.rst | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index 4ea0fe372b4378..55dbf532ced73e 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -207,8 +207,10 @@ See :pep:`678` for more details. PEP written by Zac Hatfield-Dodds.) -Windows py.exe launcher improvements ------------------------------------- +.. _whatsnew311-windows-launcher: + +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 From 55c2d5b78fd86ec60d5b70bc0b3c1762734eb31c Mon Sep 17 00:00:00 2001 From: "C.A.M. Gerlach" Date: Sat, 1 Oct 2022 20:37:22 -0500 Subject: [PATCH 3/5] Be clearer/explict about what legacy version arg components reprisent --- Doc/whatsnew/3.11.rst | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index 55dbf532ced73e..8bc9099d03815e 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -214,8 +214,8 @@ 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:/`` argument instead of the limited ``-x.y`` argument. This -allows launching distributions other than ``PythonCore``, which is the one +``-V:/`` argument instead of the limited ``-.`` argument. +This allows launching distributions other than ``PythonCore``, which is the one obtained from `python.org `_. When using ``-V:`` selectors, either company or tag can be omitted, but all @@ -223,12 +223,14 @@ 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. +When using legacy ``-``, ``-.``, +``--`` or ``-.-`` 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. .. _new-feat-related-type-hints-311: From cd714893577bc518f1cfc19d84768eeab054d7e1 Mon Sep 17 00:00:00 2001 From: "C.A.M. Gerlach" Date: Sat, 1 Oct 2022 20:46:32 -0500 Subject: [PATCH 4/5] Apply other minor clarity and textual fixes to py.exe launcher text --- Doc/whatsnew/3.11.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index 8bc9099d03815e..d3087ec6b7eadc 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -212,24 +212,24 @@ PEP written by Zac Hatfield-Dodds.) Windows ``py.exe`` launcher improvements ---------------------------------------- -The copy of :ref:`launcher` included with Python 3.11 has been significantly +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:/`` argument instead of the limited ``-.`` argument. -This allows launching distributions other than ``PythonCore``, which is the one -obtained from `python.org `_. +``-V:/`` argument instead of the limited ``-.``. +This allows launching distributions other than ``PythonCore``, +the one hosted on `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 ``-``, ``-.``, +When using the legacy ``-``, ``-.``, ``--`` or ``-.-`` 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", +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 its tag for a ``-32`` suffix. +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. From ec51650e89b655c420482982bb058c6ef87dc209 Mon Sep 17 00:00:00 2001 From: "C.A.M. Gerlach" Date: Tue, 4 Oct 2022 17:26:02 -0500 Subject: [PATCH 5/5] Refine phrasing of legacy sentence of py.exe desc Co-authored-by: Ezio Melotti --- Doc/whatsnew/3.11.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Doc/whatsnew/3.11.rst b/Doc/whatsnew/3.11.rst index d3087ec6b7eadc..611fe42d5f7c77 100644 --- a/Doc/whatsnew/3.11.rst +++ b/Doc/whatsnew/3.11.rst @@ -225,8 +225,8 @@ will select the "best" distribution with tag ``3.11``. When using the legacy ``-``, ``-.``, ``--`` or ``-.-`` arguments, -all existing behaviour should be preserved from past versions. -Only releases from ``PythonCore`` will be selected. +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. pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.

Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy