gh-100315: clarification to __slots__ docs. (GH-102621)

refer to tp_itemsize in discussion on "variable-length" built-in types (cherry picked from commit 88c262c) Co-authored-by: T <[email protected]>
python · Mar 14, 2023 · 2c015a6 · 2c015a6
1 parent 125f75c
commit 2c015a6
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
@@ -1876,8 +1876,10 @@ Notes on using *__slots__*
   descriptor directly from the base class). This renders the meaning of the
   program undefined.  In the future, a check may be added to prevent this.
 
-* Nonempty *__slots__* does not work for classes derived from "variable-length"
-  built-in types such as :class:`int`, :class:`bytes` and :class:`tuple`.
+* :exc:`TypeError` will be raised if nonempty *__slots__* are defined for a
+  class derived from a
+  :c:member:`"variable-length" built-in type <PyTypeObject.tp_itemsize>` such as
+  :class:`int`, :class:`bytes`, and :class:`tuple`.
 
 * Any non-string :term:`iterable` may be assigned to *__slots__*.