Merge branch 'main' into 690v2

* main: (47 commits) PEP 668: Address feedback and mark as accepted (python#2673) PEP-0691 Gramatical changes + `meta` key description under Project List (python#2677) PEP691: Mark Accepted + Grammar Fixes + Small Fix (python#2674) PEP 691: touch up (python#2668) PEP 650: Withdraw and move to Standards Track (python#2665) PEP 561: Mark as final (python#2663) PEP 660: Mark as Final (python#2664) PEP 615: Fix incorrect RFC link (python#2662) Multiple PEPs: Move Packaging PEPs to Standards Track and mark as Final (python#2657) PEP 671: Since it keeps getting asked about, add a para on deferreds (python#2661) Infra: Tweak PEP references to work on topic sub-index pages (python#2658) PEP 632: Remove `Topic: Packaging` header (python#2656) Infra: Make colour theme cycler button accessible (python#2619) PEP 593: Fix citation references (python#2640) PEP 553: Fix citation references (python#2639) PEP 668: Add PEP-Delegate (python#2654) PEP 693: Python 3.12 Release Schedule (python#2648) Add support for topic indices (python#2579) PEP691: Switch to a List for Project, Address more Feedback (python#2653) PEP 671: Add section on evaluation order (python#2652) ...
carljm · Jun 27, 2022 · 98ec76e · 98ec76e
2 parents f19db01 + 6a83493
commit 98ec76e
Show file tree

Hide file tree

Showing 98 changed files with 832 additions and 514 deletions.
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -176,6 +176,13 @@ repos:
         files: '^pep-\d+\.(rst|txt)$'
         types: [text]
 
+      - id: validate-topic
+        name: "'Topic' must be for a valid sub-index"
+        language: pygrep
+        entry: '^Topic:(?:(?! +(Packaging|Typing|Packaging, Typing)$))'
+        files: '^pep-\d+\.(rst|txt)$'
+        types: [text]
+
       - id: validate-content-type
         name: "'Content-Type' must be 'text/x-rst'"
         language: pygrep

diff --git a/contents.rst b/contents.rst
@@ -16,3 +16,4 @@ This is an internal Sphinx page; please go to the :doc:`PEP Index <pep-0000>`.
 
    docs/*
    pep-*
+   topic/*
diff --git a/pep-0011.txt b/pep-0011.txt
@@ -70,7 +70,9 @@ first release candidate, it will be listed as unsupported in this PEP.
 Tier 1
 ------
 
-- `CI failures <https://github.com/python/cpython/actions/workflows/build.yml?query=branch%3Amain+is%3Acompleted>`__ block releases.
+
+- `STATUS <https://github.com/python/cpython/actions/workflows/build.yml?query=branch%3Amain+is%3Acompleted>`__
+- CI failures block releases.
 - Changes which would break the ``main`` branch are not allowed to be merged;
   any breakage should be fixed or reverted immediately.
 - All core developers are responsible to keep ``main``, and thus these
@@ -90,41 +92,43 @@ x86_64-unknown-linux-gnu glibc, gcc
 Tier 2
 ------
 
+- `STATUS <https://buildbot.python.org/all/#/builders?tags=%2B3.x&tags=%2Btier-2>`__
 - Must have a reliable buildbot.
 - At least **two** core developers are signed up to support the platform.
 - Changes which break any of these platforms are to be **fixed or
   reverted within 24 hours**.
 - Failures on these platforms **block a release**.
 
-=========================== ========================== ============================================== ========
-Target Triple               Notes                      Buildbot                                       Contacts
-=========================== ========================== ============================================== ========
-aarch64-apple-darwin        clang                      https://buildbot.python.org/all/#/builders/725 Ned Deily, Ronald Oussoren, Dong-hee Na
-aarch64-unknown-linux-gnu   glibc, gcc                 https://buildbot.python.org/all/#/builders/125 Petr Viktorin, Victor Stinner
+============================= ========================== ========
+Target Triple                 Notes                      Contacts
+============================= ========================== ========
+aarch64-apple-darwin          clang                      Ned Deily, Ronald Oussoren, Dong-hee Na
+aarch64-unknown-linux-gnu     glibc, gcc                 Petr Viktorin, Victor Stinner
 
-                            glibc, clang               https://buildbot.python.org/all/#/builders/234 Victor Stinner, Gregory P. Smith
-powerpcle-unknown-linux-gnu glibc, gcc                 https://buildbot.python.org/all/#/builders/90  Petr Viktorin, Victor Stinner
-x86_64-unknown-linux-gnu    glibc, clang               https://buildbot.python.org/all/#/builders/441 Victor Stinner, Gregory P. Smith
-=========================== ========================== ============================================== ========
+                              glibc, clang               Victor Stinner, Gregory P. Smith
+powerpc64le-unknown-linux-gnu glibc, gcc                 Petr Viktorin, Victor Stinner
+x86_64-unknown-linux-gnu      glibc, clang               Victor Stinner, Gregory P. Smith
+============================= ========================== ========
 
 
 Tier 3
 ------
 
+- `STATUS <https://buildbot.python.org/all/#/builders?tags=%2B3.x&tags=%2Btier-3>`__
 - Must have a reliable buildbot.
 - At least **one** core developer is signed up to support the platform.
 - No response SLA to failures.
 - Failures on these platforms do **not** block a release.
 
-============================== =========================== ============================================== ========
-Target Triple                  Notes                       Buildbot                                       Contacts
-============================== =========================== ============================================== ========
-aarch64-pc-windows-msvc                                    https://buildbot.python.org/all/#/builders/729 Steve Dower
-powerpcle-unknown-linux-gnu    glibc, clang                https://buildbot.python.org/all/#/builders/435 Victor Stinner
-s390x-unknown-linux-gnu        glibc, gcc                  https://buildbot.python.org/all/#/builders/223 Victor Stinner
-x86_64-unknown-freebsd         BSD libc, clang             https://buildbot.python.org/all/#/builders/172 Victor Stinner
-armv7l-unknown-linux-gnueabihf Raspberry Pi OS, glibc, gcc https://buildbot.python.org/all/#/builders/424 Gregory P. Smith
-============================== =========================== ============================================== ========
+================================ =========================== ========
+Target Triple                    Notes                       Contacts
+================================ =========================== ========
+aarch64-pc-windows-msvc                                      Steve Dower
+powerpc64le-unknown-linux-gnu    glibc, clang                Victor Stinner
+s390x-unknown-linux-gnu          glibc, gcc                  Victor Stinner
+x86_64-unknown-freebsd           BSD libc, clang             Victor Stinner
+armv7l-unknown-linux-gnueabihf   Raspberry Pi OS, glibc, gcc Gregory P. Smith
+================================ =========================== ========
 
 
 All other platforms

diff --git a/pep-0205.txt b/pep-0205.txt
@@ -335,7 +335,7 @@ handle on an object that does not increment the object's reference
 count.  This means that holding a vref on an object will not keep
 the object from being destroyed.  This would allow the Python
 programmer, for example, to create the aforementioned tree
-structure tree structure, which is automatically destroyed when it
+structure, which is automatically destroyed when it
 is no longer in use -- by making all of the parent back-references
 into vrefs, they no longer create reference cycles which keep the
 tree from being destroyed.

diff --git a/pep-0241.txt b/pep-0241.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date$
 Author: A.M. Kuchling <[email protected]>
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 12-Mar-2001
 Post-History: 19-Mar-2001

diff --git a/pep-0243.txt b/pep-0243.txt
@@ -6,6 +6,7 @@ Author: [email protected] (Sean Reifschneider)
 Discussions-To: [email protected]
 Status: Withdrawn
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 18-Mar-2001
 Python-Version: 2.1

diff --git a/pep-0257.txt b/pep-0257.txt
@@ -224,14 +224,14 @@ of the algorithm::
         # and split into a list of lines:
         lines = docstring.expandtabs().splitlines()
         # Determine minimum indentation (first line doesn't count):
-        indent = sys.maxint
+        indent = sys.maxsize
         for line in lines[1:]:
             stripped = line.lstrip()
             if stripped:
                 indent = min(indent, len(line) - len(stripped))
         # Remove indentation (first line is special):
         trimmed = [lines[0].strip()]
-        if indent < sys.maxint:
+        if indent < sys.maxsize:
             for line in lines[1:]:
                 trimmed.append(line[indent:].rstrip())
         # Strip off trailing and leading blank lines:

diff --git a/pep-0262.txt b/pep-0262.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date$
 Author: A.M. Kuchling <[email protected]>
 Status: Deferred
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 08-Jul-2001
 Post-History: 27-Mar-2002

diff --git a/pep-0301.txt b/pep-0301.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date$
 Author: Richard Jones <[email protected]>
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 24-Oct-2002
 Python-Version: 2.3

diff --git a/pep-0314.txt b/pep-0314.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date$
 Author: A.M. Kuchling, Richard Jones
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 12-Apr-2003
 Python-Version: 2.5

diff --git a/pep-0345.txt b/pep-0345.txt
@@ -6,6 +6,7 @@ Author: Richard Jones <[email protected]>
 Discussions-To: [email protected]
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 28-Apr-2005
 Python-Version: 2.5

diff --git a/pep-0365.txt b/pep-0365.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date$
 Author: Phillip J. Eby <[email protected]>
 Status: Rejected
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 30-Apr-2007
 Post-History: 30-Apr-2007

diff --git a/pep-0376.txt b/pep-0376.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date$
 Author: Tarek Ziadé <[email protected]>
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 22-Feb-2009
 Python-Version: 2.7, 3.2

diff --git a/pep-0381.txt b/pep-0381.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date$
 Author: Tarek Ziadé <[email protected]>, Martin v. Löwis <[email protected]>
 Status: Withdrawn
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 21-Mar-2009
 Post-History:

diff --git a/pep-0386.txt b/pep-0386.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date$
 Author: Tarek Ziadé <[email protected]>
 Status: Superseded
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 04-Jun-2009
 Superseded-By: 440

diff --git a/pep-0390.txt b/pep-0390.txt
@@ -7,6 +7,7 @@ BDFL-Delegate: Nick Coghlan
 Discussions-To: [email protected]
 Status: Rejected
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 10-Oct-2009
 Python-Version: 2.7, 3.2

diff --git a/pep-0396.txt b/pep-0396.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date: 2008-08-10 09:59:20 -0400 (Sun, 10 Aug 2008) $
 Author: Barry Warsaw <[email protected]>
 Status: Rejected
 Type: Informational
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 16-Mar-2011
 Post-History: 05-Apr-2011

diff --git a/pep-0402.txt b/pep-0402.txt
@@ -5,6 +5,7 @@ Last-Modified: $Date$
 Author: P.J. Eby
 Status: Rejected
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 12-Jul-2011
 Python-Version: 3.3

diff --git a/pep-0405.txt b/pep-0405.txt
@@ -6,6 +6,7 @@ Author: Carl Meyer <[email protected]>
 BDFL-Delegate: Nick Coghlan
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 13-Jun-2011
 Python-Version: 3.3

diff --git a/pep-0423.txt b/pep-0423.txt
@@ -6,6 +6,7 @@ Author: Benoit Bryon <[email protected]>
 Discussions-To: [email protected]
 Status: Deferred
 Type: Informational
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 24-May-2012
 Post-History:

diff --git a/pep-0425.txt b/pep-0425.txt
@@ -6,6 +6,7 @@ Author: Daniel Holth <[email protected]>
 BDFL-Delegate: Nick Coghlan <[email protected]>
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 27-Jul-2012
 Python-Version: 3.4

diff --git a/pep-0426.txt b/pep-0426.txt
@@ -9,6 +9,7 @@ BDFL-Delegate: Donald Stufft <[email protected]>
 Discussions-To: [email protected]
 Status: Withdrawn
 Type: Informational
+Topic: Packaging
 Content-Type: text/x-rst
 Requires: 440, 508, 518
 Created: 30-Aug-2012

diff --git a/pep-0427.txt b/pep-0427.txt
@@ -7,6 +7,7 @@ BDFL-Delegate: Nick Coghlan <[email protected]>
 Discussions-To: [email protected]
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 20-Sep-2012
 Post-History: 18-Oct-2012, 15-Feb-2013

diff --git a/pep-0438.txt b/pep-0438.txt
@@ -7,6 +7,7 @@ BDFL-Delegate: Richard Jones <[email protected]>
 Discussions-To: [email protected]
 Status: Superseded
 Type: Process
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 15-Mar-2013
 Post-History: 19-May-2013

diff --git a/pep-0439.txt b/pep-0439.txt
@@ -7,6 +7,7 @@ BDFL-Delegate:  Nick Coghlan <[email protected]>
 Discussions-To: [email protected]
 Status: Rejected
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 18-Mar-2013
 Python-Version: 3.4

diff --git a/pep-0440.txt b/pep-0440.txt
@@ -6,8 +6,9 @@ Author: Nick Coghlan <[email protected]>,
         Donald Stufft <[email protected]>
 BDFL-Delegate: Nick Coghlan <[email protected]>
 Discussions-To: [email protected]
-Status: Active
-Type: Informational
+Status: Final
+Topic: Packaging
+Type: Standards Track
 Content-Type: text/x-rst
 Created: 18-Mar-2013
 Post-History: 30-Mar-2013, 27-May-2013, 20-Jun-2013,

diff --git a/pep-0449.txt b/pep-0449.txt
@@ -7,6 +7,7 @@ BDFL-Delegate: Richard Jones <[email protected]>
 Discussions-To: [email protected]
 Status: Final
 Type: Process
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 04-Aug-2013
 Post-History: 04-Aug-2013

diff --git a/pep-0453.txt b/pep-0453.txt
@@ -7,6 +7,7 @@ Author: Donald Stufft <[email protected]>,
 BDFL-Delegate: Martin von Löwis
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 10-Aug-2013
 Post-History: 30-Aug-2013, 15-Sep-2013, 18-Sep-2013, 19-Sep-2013,

diff --git a/pep-0458.txt b/pep-0458.txt
@@ -14,6 +14,7 @@ BDFL-Delegate: Donald Stufft <[email protected]>
 Discussions-To: https://discuss.python.org/t/pep-458-secure-pypi-downloads-with-package-signing/2648
 Status: Accepted
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 27-Sep-2013
 Post-History: 06-Jan-2019, 13-Nov-2019

diff --git a/pep-0459.txt b/pep-0459.txt
@@ -7,6 +7,7 @@ BDFL-Delegate: Nick Coghlan <[email protected]>
 Discussions-To: [email protected]
 Status: Withdrawn
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Requires: 426
 Created: 11-Nov-2013

diff --git a/pep-0464.txt b/pep-0464.txt
@@ -7,6 +7,7 @@ BDFL-Delegate: Richard Jones <[email protected]>
 Discussions-To: [email protected]
 Status: Final
 Type: Process
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 02-Mar-2014
 Post-History: 04-Mar-2014

diff --git a/pep-0470.txt b/pep-0470.txt
@@ -7,6 +7,7 @@ BDFL-Delegate: Paul Moore <[email protected]>
 Discussions-To: [email protected]
 Status: Final
 Type: Process
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 12-May-2014
 Post-History: 14-May-2014, 05-Jun-2014, 03-Oct-2014, 13-Oct-2014, 26-Aug-2015

diff --git a/pep-0477.txt b/pep-0477.txt
@@ -7,6 +7,7 @@ Author: Donald Stufft <[email protected]>,
 BDFL-Delegate: Benjamin Peterson <[email protected]>
 Status: Final
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Created: 26-Aug-2014
 Post-History: 01-Sep-2014

diff --git a/pep-0480.txt b/pep-0480.txt
@@ -9,6 +9,7 @@ BDFL-Delegate: Donald Stufft <[email protected]>
 Discussions-To: https://discuss.python.org/t/5666
 Status: Draft
 Type: Standards Track
+Topic: Packaging
 Content-Type: text/x-rst
 Requires:  458
 Created: 08-Oct-2014
Original file line number	Diff line number	Diff line change
Expand Up		@@ -16,3 +16,4 @@ This is an internal Sphinx page; please go to the :doc:`PEP Index <pep-0000>`.

		docs/*
		pep-*
		topic/*