From: Peter Bierma <zintensitydev@gmail.com>
Date: Mon, 20 Jan 2025 16:45:08 +0000 (-0500)
Subject: gh-118915: C API: Document compiler flag macros (GH-129028)
X-Git-Tag: v3.14.0a5~343
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=6e02096e2f9a18671d608f79dd61c5757deca4e8;p=thirdparty%2FPython%2Fcpython.git

gh-118915: C API: Document compiler flag macros (GH-129028)
---

diff --git a/Doc/c-api/veryhigh.rst b/Doc/c-api/veryhigh.rst
index 9f02bdb58965..1ef4181d52eb 100644
--- a/Doc/c-api/veryhigh.rst
+++ b/Doc/c-api/veryhigh.rst
@@ -348,8 +348,20 @@ the same library that the Python runtime is using.
    .. versionchanged:: 3.8
       Added *cf_feature_version* field.
 
+   The available compiler flags are accessible as macros:
 
-.. c:var:: int CO_FUTURE_DIVISION
+   .. c:namespace:: NULL
 
-   This bit can be set in *flags* to cause division operator ``/`` to be
-   interpreted as "true division" according to :pep:`238`.
+   .. c:macro:: PyCF_ALLOW_TOP_LEVEL_AWAIT
+                PyCF_ONLY_AST
+                PyCF_OPTIMIZED_AST
+                PyCF_TYPE_COMMENTS
+
+      See :ref:`compiler flags <ast-compiler-flags>` in documentation of the
+      :py:mod:`!ast` Python module, which exports these constants under
+      the same names.
+
+   .. c:var:: int CO_FUTURE_DIVISION
+
+      This bit can be set in *flags* to cause division operator ``/`` to be
+      interpreted as "true division" according to :pep:`238`.