gh-121028: Soft-deprecate sys.api_version (GH-136463)

encukou · web-flow · commit 658599c15d13 · 2025-07-21T14:22:48.000+02:00
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
@@ -2191,8 +2191,11 @@ always available. Unless explicitly noted otherwise, all variables are read-only
 
 .. data:: api_version
 
-   The C API version for this interpreter.  Programmers may find this useful when
-   debugging version conflicts between Python and extension modules.
+   The C API version, equivalent to the C macro :c:macro:`PYTHON_API_VERSION`.
+   Defined for backwards compatibility.
+
+   Currently, this constant is not updated in new Python versions, and is not
+   useful for versioning. This may change in the future.
 
 
 .. data:: version_info
