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

Aperta Adatta ai principianti
#161,078 3 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@TheLouisMahdi ci sta già lavorando.

Dal 2/11/2026.

  • #161158 di @TheLouisMahdi — aperta

Valutazione

Difficoltà
1/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
82/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
python
Ambito
documentation

Direzione di ricerca

Il problema si trova in Doc/whatsnew/3.12.rst, nelle novità della release sotto C API improvements e nella sezione C API Changes. Controlla entrambi i punti e conferma che il livello instabile della C API è PEP 689, mentre PEP 697 è la voce opaque types che la stessa pagina descrive già correttamente. Il lavoro è completo quando entrambi i riferimenti citano 689, il nome dell'etichetta è coerente se lo rinomini e la documentazione Sphinx continua a compilarsi.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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
Lingua principale
Python
Stelle
77.8k
Fork
37.7k
Merge medio
17h 24m
PR unite (30g)
716

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di python/cpython

Tutte le issue di python/cpython

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.