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.