From: Petr Viktorin <encukou@gmail.com>
Date: Fri, 6 Sep 2024 13:46:05 +0000 (+0200)
Subject: [3.12] gh-120426: Add the glossary term "immortal" (GH-123191) (GH-123491) (#123636)
X-Git-Tag: v3.12.6~8
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=74feab2bae0b5cb70ce236f2682bf167ef8664bd;p=thirdparty%2FPython%2Fcpython.git

[3.12] gh-120426: Add the glossary term "immortal" (GH-123191) (GH-123491) (#123636)

Add the glossary term "immortal", mark it as an implementation detail

(cherry picked from commit 6754566a51a5706e8c9da0094b892113311ba20c)
(cherry picked from commit 1af74fa652b40d5ce67875ebfefd2f5a1cc28a2f)

(Unlike the original commits, this adds the entire entry.)
---

diff --git a/Doc/glossary.rst b/Doc/glossary.rst
index d1745bf5ccd0..c85370fec84a 100644
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -591,6 +591,14 @@ Glossary
       :ref:`idle` is a basic editor and interpreter environment
       which ships with the standard distribution of Python.
 
+   immortal
+      *Immortal objects* are a CPython implementation detail introduced
+      in :pep:`683`.
+
+      If an object is immortal, its :term:`reference count` is never modified,
+      and therefore it is never deallocated while the interpreter is running.
+      For example, :const:`True` and :const:`None` are immortal in CPython.
+
    immutable
       An object with a fixed value.  Immutable objects include numbers, strings and
       tuples.  Such an object cannot be altered.  A new object has to