[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 d1745bf5ccd0150ec1f43e7dbbbbcc88cb4cba85..c85370fec84aea189c12b1f7f43276df1c0e9cef 100644 (file)
--- 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