[3.13] Document that `PyInterpreterState_GetDict` returns a borrowed reference (GH...

Document that `PyInterpreterState_GetDict` returns a borrowed reference (GH-139451)
(cherry picked from commit 80cdf3ef74f6622899c1c82af1e08492e4ab7a00)

Co-authored-by: Petr Viktorin <encukou@gmail.com>

diff --git a/Doc/c-api/init.rst b/Doc/c-api/init.rst
index 211b902ad1e4e48aa721675e32f2835c111bd710..cc0f7c3a7de32fc3e62396b1929e1028951a046c 100644 (file)
--- a/Doc/c-api/init.rst
+++ b/Doc/c-api/init.rst
@@ -1477,6 +1477,9 @@ All of the following functions must be called after :c:func:`Py_Initialize`.
    This is not a replacement for :c:func:`PyModule_GetState()`, which
    extensions should use to store interpreter-specific state information.
 
+   The returned dictionary is borrowed from the interpreter and is valid until
+   interpreter shutdown.
+
    .. versionadded:: 3.8
 
 

diff --git a/Doc/data/refcounts.dat b/Doc/data/refcounts.dat
index 53e2ea717ed7ecdb74ea4c736b483a470ec31d35..67f551cf6de4428e7845b9bbcfba28c233aaa7af 100644 (file)
--- a/Doc/data/refcounts.dat
+++ b/Doc/data/refcounts.dat
@@ -1148,6 +1148,9 @@ PyInterpreterState_Clear:PyInterpreterState*:interp::
 PyInterpreterState_Delete:void:::
 PyInterpreterState_Delete:PyInterpreterState*:interp::
 
+PyInterpreterState_GetDict:PyObject*::0:
+PyInterpreterState_GetDict:PyInterpreterState*:interp::
+
 PyInterpreterState_GetID:int64_t:::
 PyInterpreterState_GetID:PyInterpreterState*:interp::