From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Mon, 21 Jul 2025 12:29:51 +0000 (+0200)
Subject: [3.14] gh-121028: Soft-deprecate sys.api_version (GH-136463) (GH-136928)
X-Git-Tag: v3.14.0rc1~29
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=0d87bb66d3c2fc6331c3b1f9d649ebc9bb385c5a;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-121028: Soft-deprecate sys.api_version (GH-136463) (GH-136928)

(cherry picked from commit 658599c15d13ee3a5cb56c3d9fccaa195465d4b5)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
---

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