From: Petr Viktorin <encukou@gmail.com>
Date: Mon, 21 Jul 2025 12:22:48 +0000 (+0200)
Subject: gh-121028: Soft-deprecate sys.api_version (GH-136463)
X-Git-Tag: v3.15.0a1~902
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=658599c15d13ee3a5cb56c3d9fccaa195465d4b5;p=thirdparty%2FPython%2Fcpython.git

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

diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 05bc7cfb9dc0..52f0af31c687 100644
--- 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