From 012c4a998f978b08f6f6054f553470d62ec47673 Mon Sep 17 00:00:00 2001 From: Peter Bierma Date: Sun, 13 Jul 2025 05:10:37 -0400 Subject: [PATCH] gh-132346: Docs: Clarify that reference counts aren't stable between versions (GH-132352) (cherry picked from commit 3dbe02ccd3eefc48ac9fa14427bb4cdb82d1ebae) Co-authored-by: Peter Bierma --- Doc/glossary.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Doc/glossary.rst b/Doc/glossary.rst index 118d4fbe30fda7..9e44b156e73322 100644 --- a/Doc/glossary.rst +++ b/Doc/glossary.rst @@ -1163,6 +1163,11 @@ Glossary :func:`sys.getrefcount` function to return the reference count for a particular object. + In :term:`CPython`, reference counts are not considered to be stable + or well-defined values; the number of references to an object, and how + that number is affected by Python code, may be different between + versions. + regular package A traditional :term:`package`, such as a directory containing an ``__init__.py`` file.