]> git.ipfire.org Git - thirdparty/Python/cpython.git/commit
[3.11] gh-98154: Clarify Usage of "Reference Count" In the Docs (gh-107753)
authorEric Snow <ericsnowcurrently@gmail.com>
Mon, 7 Aug 2023 22:17:12 +0000 (16:17 -0600)
committerGitHub <noreply@github.com>
Mon, 7 Aug 2023 22:17:12 +0000 (16:17 -0600)
commit951320e4d0f498857d0f78b3dbd0ee353bc4b93c
tree10f70b9fa75426a9e112ac30e3e0f8ebb95939b6
parent22b39d13eccb965515e3a4b3fd358755f8db9d7f
[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.
14 files changed:
Doc/c-api/allocation.rst
Doc/c-api/arg.rst
Doc/c-api/buffer.rst
Doc/c-api/bytes.rst
Doc/c-api/exceptions.rst
Doc/c-api/intro.rst
Doc/c-api/module.rst
Doc/c-api/object.rst
Doc/c-api/refcounting.rst
Doc/c-api/sys.rst
Doc/c-api/typeobj.rst
Doc/c-api/unicode.rst
Doc/glossary.rst
Doc/library/sys.rst