https://github.com/python/cpython/commit/dc1b56aa03a1764e7c6bbcbf190b1c293eb5c462
commit: dc1b56aa03a1764e7c6bbcbf190b1c293eb5c462
branch: main
author: Peter Bierma <[email protected]>
committer: ZeroIntensity <[email protected]>
date: 2026-02-27T10:11:52-05:00
summary:
gh-141004: Document missing type flags (GH-145127)
files:
M Doc/c-api/typeobj.rst
M Tools/check-c-api-docs/ignored_c_api.txt
diff --git a/Doc/c-api/typeobj.rst b/Doc/c-api/typeobj.rst
index bc134b5d00b4ad..87b488912653b9 100644
--- a/Doc/c-api/typeobj.rst
+++ b/Doc/c-api/typeobj.rst
@@ -1499,6 +1499,52 @@ and :c:data:`PyType_Type` effectively act as defaults.)
It will be removed in a future version of CPython
+ .. c:macro:: Py_TPFLAGS_HAVE_VERSION_TAG
+
+ This is a :term:`soft deprecated` macro that does nothing.
+ Historically, this would indicate that the
+ :c:member:`~PyTypeObject.tp_version_tag` field was available and
+ initialized.
+
+
+ .. c:macro:: Py_TPFLAGS_INLINE_VALUES
+
+ This bit indicates that instances of this type will have an "inline
values"
+ array (containing the object's attributes) placed directly after the end
+ of the object.
+
+ This requires that :c:macro:`Py_TPFLAGS_HAVE_GC` is set.
+
+ **Inheritance:**
+
+ This flag is not inherited.
+
+ .. versionadded:: 3.13
+
+
+ .. c:macro:: Py_TPFLAGS_IS_ABSTRACT
+
+ This bit indicates that this is an abstract type and therefore cannot
+ be instantiated.
+
+ **Inheritance:**
+
+ This flag is not inherited.
+
+ .. seealso::
+ :mod:`abc`
+
+
+ .. c:macro:: Py_TPFLAGS_HAVE_STACKLESS_EXTENSION
+
+ Internal. Do not set or unset this flag.
+ Historically, this was a reserved flag for use in Stackless Python.
+
+ .. warning::
+ This flag is present in header files, but is not be used.
+ This may be removed in a future version of CPython.
+
+
.. c:member:: const char* PyTypeObject.tp_doc
.. corresponding-type-slot:: Py_tp_doc
diff --git a/Tools/check-c-api-docs/ignored_c_api.txt
b/Tools/check-c-api-docs/ignored_c_api.txt
index 7bf79872bd4630..02a3031e52fb8b 100644
--- a/Tools/check-c-api-docs/ignored_c_api.txt
+++ b/Tools/check-c-api-docs/ignored_c_api.txt
@@ -22,9 +22,6 @@ Py_HASH_EXTERNAL
PyABIInfo_FREETHREADING_AGNOSTIC
# object.h
Py_INVALID_SIZE
-Py_TPFLAGS_HAVE_VERSION_TAG
-Py_TPFLAGS_INLINE_VALUES
-Py_TPFLAGS_IS_ABSTRACT
# pyexpat.h
PyExpat_CAPI_MAGIC
PyExpat_CAPSULE_NAME
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
