From: Petr Viktorin <encukou@gmail.com>
Date: Tue, 10 Mar 2026 09:06:08 +0000 (+0100)
Subject: [3.14] Document that PyType_GetModule returns a borrowed ref (GH-145612) (GH-145682)
X-Git-Tag: v3.14.4~181
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=30bcdcd379445b942e1278244bbce805dc32b5a2;p=thirdparty%2FPython%2Fcpython.git

[3.14] Document that PyType_GetModule returns a borrowed ref (GH-145612) (GH-145682)

(cherry picked from commit 44855458a423569eaea3df53fd5a0c0032da932d)
---

diff --git a/Doc/c-api/type.rst b/Doc/c-api/type.rst
index 2f2060d05822..7fe810f585fa 100644
--- a/Doc/c-api/type.rst
+++ b/Doc/c-api/type.rst
@@ -274,6 +274,10 @@ Type Objects
    Return the module object associated with the given type when the type was
    created using :c:func:`PyType_FromModuleAndSpec`.
 
+   The returned reference is :term:`borrowed <borrowed reference>` from *type*,
+   and will be valid as long as you hold a reference to *type*.
+   Do not release it with :c:func:`Py_DECREF` or similar.
+
    If no module is associated with the given type, sets :py:class:`TypeError`
    and returns ``NULL``.
 
diff --git a/Doc/data/refcounts.dat b/Doc/data/refcounts.dat
index 1cc1b44a5b8e..48b800fdf9a5 100644
--- a/Doc/data/refcounts.dat
+++ b/Doc/data/refcounts.dat
@@ -2415,6 +2415,9 @@ PyType_GetFlags:PyTypeObject*:type:0:
 PyType_GetName:PyObject*::+1:
 PyType_GetName:PyTypeObject*:type:0:
 
+PyType_GetModule:PyObject*::0:
+PyType_GetModule:PyTypeObject*:type:0:
+
 PyType_GetModuleByDef:PyObject*::0:
 PyType_GetModuleByDef:PyTypeObject*:type:0:
 PyType_GetModuleByDef:PyModuleDef*:def::