What's New in 3.12 credits the unstable C API tier to PEP 697 instead of PEP 689

Offen Anfängerfreundlich
  • Stimmt etwas nicht?
#161,078 3 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

@TheLouisMahdi arbeitet bereits daran.

Seit 02.11.2026.

  • #161158 von @TheLouisMahdi — offen

Bewertung

Schwierigkeit
1/5
Geschätzter Aufwand
Unter einer Stunde
Anfängerfreundlichkeit
82/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
python
Bereich
documentation

Rechercherichtung

Das Problem liegt in Doc/whatsnew/3.12.rst, im Abschnitt mit den Highlights der Version unter C API improvements und im Abschnitt C API Changes. Prüfe beide Stellen und bestätige, dass die instabile C-API-Stufe PEP 689 ist, während PEP 697 der Eintrag zu opaque types ist, den dieselbe Seite bereits korrekt beschreibt. Fertig ist es, wenn beide Verweise auf 689 zeigen, der Bezeichner konsistent ist, falls du ihn umbenennst, und die Sphinx-Dokumentation weiterhin gebaut werden kann.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

docs
Documentation

Doc/whatsnew/3.12.rst gives the wrong PEP number for the unstable C API tier in two places:

  • Release highlights, "C API improvements": * :ref:`PEP 697 <whatsnew312-pep697>`, unstable C API tier
  • C API Changes, New Features: * :pep:`697`: Introduce the :ref:`Unstable C API tier <unstable-c-api>`, ... (under the label .. _whatsnew312-pep697:)

The unstable C API tier is PEP 689 ("Unstable C API tier", Python-Version 3.12). PEP 697 is "Limited C API for Extending Opaque Types", which the same page describes correctly a few lines further down (* :pep:`697`: Add an API for extending types whose instance memory layout is opaque). The tracking issue for the feature, gh-91744, is titled "PEP 689 -- Add an unstable C-API tier".

Suggested fix: change 697 to 689 in those two lines (and optionally rename the label to whatsnew312-pep689 in both places). The same text is on https://docs.python.org/3/whatsnew/3.12.html, as of main on 2026-11-01 (commit 9c0cfb1).

Disclosure: AI agents working for MV2 of Munim, Inc. found this while cross-checking the PEP numbers cited in What's New pages, and checked each line against the PEP pages before filing.

Linked PRs
  • gh-161158
Vorherrschende Sprache
Python
Sterne
77.8k
Forks
37.7k
Ø Merge
17 Std. 24 Min.
Gemergte PRs (30 T.)
716

Entwicklungsumgebung

In Codespaces öffnen

Startet den Dev-Container des Projekts im Browser, mit Ihrem eigenen GitHub-Konto.

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus python/cpython

Alle Issues in python/cpython

Ähnliche Issues

Weitere Issues zu Python

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.