cpython/Doc/c-api
Eric Snow 951320e4d0
[3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753)
PEP 683 (immortal objects) revealed some ways in which the Python documentation has been unnecessarily coupled to the implementation details of reference counts.  In the end users should focus on reference ownership, including taking references and releasing them, rather than on how many reference counts an object has.

This change updates the documentation to reflect that perspective.
2023-08-07 16:17:12 -06:00
..
abstract.rst bpo-41103: Resurrect the old buffer protocol. (GH-27437) 2021-07-29 12:46:47 +02:00
allocation.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
apiabiversion.rst [3.11] gh-107298: Fix Sphinx warnings in the C API doc (GH-107302) (GH-107373) 2023-07-28 06:44:54 +00:00
arg.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
bool.rst [3.11] gh-101100: Sphinx warnings: pick the low hanging fruits (GH-107386) (GH-107418) 2023-07-29 09:17:20 +03:00
buffer.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
bytearray.rst [3.11] GH-97950: Use new-style index directive ('object') (GH-104158) (#104159) 2023-05-04 13:14:16 +03:00
bytes.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
call.rst [3.11] Fix PyVectorcall_Function doc versionadded (GH-107140) (#107174) 2023-07-24 13:06:46 +00:00
capsule.rst [3.11] gh-107298: Fix yet more Sphinx warnings in the C API doc (GH-107345) (GH-107381) 2023-07-28 08:31:49 +00:00
cell.rst [3.11] gh-107298: Fix Sphinx warnings in the C API doc (GH-107302) (GH-107373) 2023-07-28 06:44:54 +00:00
code.rst [3.11] Fix the documentation for PyCode_New add qualname parameter (GH-107186) (#107454) 2023-07-30 08:48:01 +00:00
codec.rst [3.11] gh-107298: Fix doc references to undocumented modules (GH-107300) (GH-107371) 2023-07-28 09:21:50 +03:00
complex.rst [3.11] gh-107298: Fix more Sphinx warnings in the C API doc (GH-107329) (GH-107377) 2023-07-28 07:03:47 +00:00
concrete.rst [3.11] GH-97950: Use new-style index directive ('object') (GH-104158) (#104159) 2023-05-04 13:14:16 +03:00
contextvars.rst bpo-43959: clarify the documentation of the PyContextVar C-API (GH-25671) 2021-04-28 07:03:19 -07:00
conversion.rst [3.11] gh-107298: Fix more Sphinx warnings in the C API doc (GH-107329) (GH-107377) 2023-07-28 07:03:47 +00:00
coro.rst bpo-42528: Improve the docs of most Py*_Check{,Exact} API calls (GH-23602) 2021-01-06 12:38:26 +01:00
datetime.rst [3.11] gh-90359: Unify documentation style for datetime.rst (gh-94836) (gh-94838) 2022-07-14 09:52:53 +09:00
descriptor.rst bpo-40170: Convert PyDescr_IsData() to static inline function (GH-24535) 2021-02-16 08:50:00 +01:00
dict.rst [3.11] gh-106033: [docs] Improve C API GetItem & HasAttr notes. (GH-106047) (#106071) 2023-06-24 16:30:09 -07:00
exceptions.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
file.rst [3.11] gh-106919: Use role :c:macro: for referencing the C "constants" (GH-106920) (GH-106952) 2023-07-21 14:48:30 +03:00
float.rst [3.11] gh-106919: Use role :c:macro: for referencing the C "constants" (GH-106920) (GH-106952) 2023-07-21 14:48:30 +03:00
frame.rst gh-93937: Document PyFrame_Check and PyFrame_Type (GH-99695) 2022-11-22 07:50:39 -08:00
function.rst [3.11] GH-97950: Use new-style index directive ('object') (GH-104158) (#104159) 2023-05-04 13:14:16 +03:00
gcsupport.rst [3.11] gh-107298: Fix more Sphinx warnings in the C API doc (GH-107329) (GH-107377) 2023-07-28 07:03:47 +00:00
gen.rst bpo-42528: Improve the docs of most Py*_Check{,Exact} API calls (GH-23602) 2021-01-06 12:38:26 +01:00
import.rst [3.11] gh-107298: Fix more Sphinx warnings in the C API doc (GH-107329) (GH-107377) 2023-07-28 07:03:47 +00:00
index.rst bpo-36763: Implement the PEP 587 (GH-13592) 2019-05-27 16:39:22 +02:00
init.rst [3.11] gh-107298: Fix more Sphinx warnings in the C API doc (GH-107329) (GH-107377) 2023-07-28 07:03:47 +00:00
init_config.rst [3.11] gh-107298: Fix yet more Sphinx warnings in the C API doc (GH-107345) (GH-107381) 2023-07-28 08:31:49 +00:00
intro.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
iter.rst More minor fixes to C API docs (GH-31525) 2022-04-02 12:31:05 -07:00
iterator.rst [3.11] gh-107298: Fix Sphinx warnings in the C API doc (GH-107302) (GH-107373) 2023-07-28 06:44:54 +00:00
list.rst [3.11] GH-97950: Use new-style index directive ('builtin') (GH-104164) (#104221) 2023-05-06 07:14:37 +03:00
long.rst [3.11] gh-106919: Use role :c:macro: for referencing the C "constants" (GH-106920) (GH-106952) 2023-07-21 14:48:30 +03:00
mapping.rst [3.11] gh-101100: Fix some broken sphinx references (GH-107095). (#107120) 2023-07-23 05:56:09 -06:00
marshal.rst [3.11] gh-105184: document that marshal functions can fail and need to be checked with PyErr_Occurred (GH-105185) (#105219) 2023-06-02 08:28:35 +00:00
memory.rst [3.11] gh-107298: Fix yet more Sphinx warnings in the C API doc (GH-107345) (GH-107381) 2023-07-28 08:31:49 +00:00
memoryview.rst [3.11] GH-97950: Use new-style index directive ('object') (GH-104158) (#104159) 2023-05-04 13:14:16 +03:00
method.rst [3.11] gh-107091: Fix the use of some C domain roles (GH-107092) (GH-107121) 2023-07-23 15:06:32 +03:00
module.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
none.rst [3.11] gh-107298: Fix yet more Sphinx warnings in the C API doc (GH-107345) (GH-107381) 2023-07-28 08:31:49 +00:00
number.rst [3.11] GH-97950: Use new-style index directive ('builtin') (GH-104164) (#104221) 2023-05-06 07:14:37 +03:00
objbuffer.rst bpo-41103: Resurrect the old buffer protocol. (GH-27437) 2021-07-29 12:46:47 +02:00
object.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
objimpl.rst Doc: Replace the deprecated highlightlang directive by highlight. (#13377) 2019-05-17 15:25:34 +05:30
refcounting.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
reflection.rst bpo-46836: Add Doc/c-api/frame.rst (GH-32051) 2022-03-23 13:19:13 +01:00
sequence.rst [3.11] gh-101100: Fix some broken sphinx references (GH-107095). (#107120) 2023-07-23 05:56:09 -06:00
set.rst [3.11] gh-107298: Fix yet more Sphinx warnings in the C API doc (GH-107345) (GH-107381) 2023-07-28 08:31:49 +00:00
slice.rst [3.11] gh-106919: Use role :c:macro: for referencing the C "constants" (GH-106920) (GH-106952) 2023-07-21 14:48:30 +03:00
stable.rst [3.11] gh-106919: Use role :c:macro: for referencing the C "constants" (GH-106920) (GH-106952) 2023-07-21 14:48:30 +03:00
structures.rst [3.11] gh-107298: Fix more Sphinx warnings in the C API doc (GH-107329) (GH-107377) 2023-07-28 07:03:47 +00:00
sys.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
tuple.rst [3.11] gh-107298: Docs: add targets for some :c:member: and :c:macro: references (GH-107316) (GH-107333) 2023-07-27 09:27:02 +03:00
type.rst [3.11] gh-107298: Fix Sphinx warnings in the C API doc (GH-107302) (GH-107373) 2023-07-28 06:44:54 +00:00
typehints.rst [3.11] gh-107298: Fix Sphinx warnings in the C API doc (GH-107302) (GH-107373) 2023-07-28 06:44:54 +00:00
typeobj.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
unicode.rst [3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753) 2023-08-07 16:17:12 -06:00
utilities.rst Doc: Replace the deprecated highlightlang directive by highlight. (#13377) 2019-05-17 15:25:34 +05:30
veryhigh.rst [3.11] gh-107091: Fix some uses of :attr: role (GH-107318) (GH-107331) 2023-07-27 09:26:14 +03:00
weakref.rst [3.11] gh-107298: Fix Sphinx warnings in the C API doc (GH-107302) (GH-107373) 2023-07-28 06:44:54 +00:00