[3.13] Document that PyType_GetModuleByDef returns a borrowed reference (GH-135666) (GH-135702)

miss-islington · encukou · web-flow · commit 773ca09caa3b · 2025-06-19T09:18:00.000+02:00
(cherry picked from commit 140731f) Co-authored-by: Petr Viktorin <encukou@gmail.com>
diff --git a/Doc/c-api/type.rst b/Doc/c-api/type.rst
@@ -267,6 +267,10 @@ Type Objects
    and other places where a method's defining class cannot be passed using the
    :c:type:`PyCMethod` calling convention.
 
+   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.
+
    .. versionadded:: 3.11
 
 .. c:function:: int PyUnstable_Type_AssignVersionTag(PyTypeObject *type)
diff --git a/Doc/data/refcounts.dat b/Doc/data/refcounts.dat
@@ -2371,6 +2371,10 @@ PyType_GetFlags:PyTypeObject*:type:0:
 PyType_GetName:PyObject*::+1:
 PyType_GetName:PyTypeObject*:type:0:
 
+PyType_GetModuleByDef:PyObject*::0:
+PyType_GetModuleByDef:PyTypeObject*:type:0:
+PyType_GetModuleByDef:PyModuleDef*:def::
+
 PyType_GetQualName:PyObject*::+1:
 PyType_GetQualName:PyTypeObject*:type:0:
 
