From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Tue, 16 Jun 2026 11:52:39 +0000 (+0200)
Subject: [3.15] gh-149716: Document PySlot_DATA for Py_mod_gil and Py_mod_multiple_interpreter... 
X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=488a03bd2b6ee594dfa65fbb7c1e7c60c41389c4;p=thirdparty%2FPython%2Fcpython.git

[3.15] gh-149716: Document PySlot_DATA for Py_mod_gil and Py_mod_multiple_interpreters (GH-150053) (#151322)

Co-authored-by: Taeknology <20297177+Taeknology@users.noreply.github.com>
---

diff --git a/Doc/c-api/module.rst b/Doc/c-api/module.rst
index 20fd66e35a0d..9f68abba66bc 100644
--- a/Doc/c-api/module.rst
+++ b/Doc/c-api/module.rst
@@ -247,6 +247,15 @@ Feature slots
    If ``Py_mod_multiple_interpreters`` is not specified, the import
    machinery defaults to ``Py_MOD_MULTIPLE_INTERPRETERS_SUPPORTED``.
 
+   For historical reasons, the values are declared as pointers (``void *``).
+   When using :c:type:`PySlot` arrays, use :c:macro:`PySlot_DATA` for
+   :c:macro:`!Py_mod_multiple_interpreters`:
+
+   .. code-block:: c
+
+      PySlot_DATA(Py_mod_multiple_interpreters,
+                  Py_MOD_PER_INTERPRETER_GIL_SUPPORTED)
+
    .. versionadded:: 3.12
 
 .. c:macro:: Py_mod_gil
@@ -272,6 +281,14 @@ Feature slots
    If ``Py_mod_gil`` is not specified, the import machinery defaults to
    ``Py_MOD_GIL_USED``.
 
+   For historical reasons, the values are declared as pointers (``void *``).
+   When using :c:type:`PySlot` arrays, use :c:macro:`PySlot_DATA` for
+   :c:macro:`!Py_mod_gil`:
+
+   .. code-block:: c
+
+      PySlot_DATA(Py_mod_gil, Py_MOD_GIL_NOT_USED)
+
    .. versionadded:: 3.13