gh-149716: Document PySlot_DATA for Py_mod_gil and Py_mod_multiple_interpreters

Taeknology · Taeknology · commit 7cbcf3772f19 · 2026-05-19T12:46:28.000+09:00
Add short code examples mirroring the existing Py_mod_abi example,
so it is clear which slot definition macro (PySlot_DATA, PySlot_INT64,
or PySlot_UINT64) to use for these two slots.
diff --git a/Doc/c-api/module.rst b/Doc/c-api/module.rst
@@ -247,6 +247,14 @@ Feature slots
    If ``Py_mod_multiple_interpreters`` is not specified, the import
    machinery defaults to ``Py_MOD_MULTIPLE_INTERPRETERS_SUPPORTED``.
 
+   A suitable slot value can be defined using the :c:macro:`PySlot_DATA` macro,
+   as in:
+
+   .. 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 +280,13 @@ Feature slots
    If ``Py_mod_gil`` is not specified, the import machinery defaults to
    ``Py_MOD_GIL_USED``.
 
+   A suitable slot value can be defined using the :c:macro:`PySlot_DATA` macro,
+   as in:
+
+   .. code-block:: c
+
+      PySlot_DATA(Py_mod_gil, Py_MOD_GIL_NOT_USED)
+
    .. versionadded:: 3.13
 
 
