`Py_SETREF` and `Py_NewRef` is not explained in extending new types using a C extension
Nessuno ha ancora preso questa issue.
- Lingua principale
- Python
- Stelle
- 77.2k
- Fork
- 36k
- Metriche di merge delle PR
- Metriche PR in attesa
Descrizione
Documentation
The documentation for extending new types using a C extension just uses Py_SETREF and Py_NewRef with no extra clarification as to what those functions do. It'd be nicer and more convenient if they were explained on-the-spot instead of having to search for it in the docs. They are also not explained in the previous topic (that explains Py_INCREF and Py_DECREF) and the other topics thereafter.
Linked PRs
- gh-101234
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Direzione di ricerca
Inizia dalla sezione «Fornire un controllo più preciso sugli attributi dei dati» del tutorial collegato sui nuovi tipi. Spiega Py_SETREF e Py_NewRef nei punti in cui vengono usati e verifica che gli argomenti circostanti sul conteggio dei riferimenti siano trattati in modo coerente; la documentazione è completa quando i lettori possono comprendere entrambe le funzioni senza cercare altrove.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Stack tecnologico
- c
- Ambito
- documentation
- Tipo di issue
- Documentazione
- Difficoltà
- 1/5
- Tempo stimato
- 1-3 ore
- Stato di attività
- Ferma
- Chiarezza
- Specificata chiaramente
- Idoneità per principianti
- 25/100