Add/adjust comments & news entries

Author: encukou

Doc/c-api/type.rst

@@ -108,7 +108,8 @@ Type Objects
    .. versionadded:: 3.4
 
    .. versionchanged:: 3.10
-      :c:func:`PyType_GetSlot` could accept static types.
+      :c:func:`PyType_GetSlot` can now accept all types.
+      Previously, it was limited to heap types.
 
 .. c:function:: PyObject* PyType_GetModule(PyTypeObject *type)
 

Misc/NEWS.d/next/C API/2020-07-08-21-01-49.bpo-41073.VqQZON.rst

@@ -1 +1 @@
-:c:func:`PyType_GetSlot()` could accept static types.
+:c:func:`PyType_GetSlot()` can now accept static types.

Objects/typeobject.c

@@ -2875,6 +2875,16 @@ type_new(PyTypeObject *metatype, PyObject *args, PyObject *kwds)
     return NULL;
 }
 
+/* An array of type slot offsets corresponding to Py_tp_* constants,
+  * for use in e.g. PyType_Spec and PyType_GetSlot.
+  * Each entry has two offsets: "slot_offset" and "subslot_offset".
+  * If is subslot_offset is -1, slot_offset is an offset within the
+  * PyTypeObject struct.
+  * Otherwise slot_offset is an offset to a pointer to a sub-slots struct
+  * (such as "tp_as_number"), and subslot_offset is the offset within
+  * that struct.
+  * The actual table is generated by a script.
+  */
 static const PySlot_Offset pyslot_offsets[] = {
     {0, 0},
 #include "typeslots.inc"