[3.13] gh-118915: Document PyUnstable_InterpreterState_GetMainModule (GH-128483) (GH-128677)

miss-islington · ZeroIntensity · web-flow · commit 65da5db28a39 · 2025-01-10T08:41:14.000+01:00
(cherry picked from commit ea39c8b) Co-authored-by: Peter Bierma <zintensitydev@gmail.com>
diff --git a/Doc/c-api/init.rst b/Doc/c-api/init.rst
@@ -1445,6 +1445,17 @@ All of the following functions must be called after :c:func:`Py_Initialize`.
 
    .. versionadded:: 3.8
 
+
+.. c:function:: PyObject* PyUnstable_InterpreterState_GetMainModule(PyInterpreterState *interp)
+
+   Return a :term:`strong reference` to the ``__main__`` `module object <moduleobjects>`_
+   for the given interpreter.
+
+   The caller must hold the GIL.
+
+   .. versionadded:: 3.13
+
+
 .. c:type:: PyObject* (*_PyFrameEvalFunction)(PyThreadState *tstate, _PyInterpreterFrame *frame, int throwflag)
 
    Type of a frame evaluation function.
