[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 05bc7cfb9dc0894ca2acb998c267b8035e511344..52f0af31c68726a9d35e80905dc703e36acf0eb5 100644 (file)
--- 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