Soft-deprecate C-API OSError aliases (GH-160111)

Author: encukou

Doc/c-api/exceptions.rst

@@ -1340,34 +1340,30 @@ Exception types
 OSError aliases
 ---------------
 
-The following are a compatibility aliases to :c:data:`PyExc_OSError`.
-
-.. versionchanged:: 3.3
-   These aliases used to be separate exception types.
-
-.. list-table::
-   :align: left
-   :widths: auto
-   :header-rows: 1
-
-   * * C name
-     * Python name
-     * Notes
-   * * .. c:var:: PyObject *PyExc_EnvironmentError
-     * :exc:`OSError`
-     *
-   * * .. c:var:: PyObject *PyExc_IOError
-     * :exc:`OSError`
-     *
-   * * .. c:var:: PyObject *PyExc_WindowsError
-     * :exc:`OSError`
-     * [win]_
-
-Notes:
-
-.. [win]
-   :c:var:`!PyExc_WindowsError` is only defined on Windows; protect code that
-   uses this by testing that the preprocessor macro ``MS_WINDOWS`` is defined.
+The following are :term:`soft deprecated` compatibility aliases
+to :c:data:`PyExc_OSError`.
+
+.. stable-abi-note::
+
+   These pointers are part of the :ref:`Stable ABI <stable>` since the
+   version in the *S.ABI* column (or since 3.2 when *S.ABI* is empty).
+
+.. c:var:: PyObject *PyExc_EnvironmentError
+
+   .. soft-deprecated:: next
+      Use :c:data:`PyExc_OSError` instead.
+
+.. c:var:: PyObject *PyExc_IOError
+
+   .. soft-deprecated:: next
+      Use :c:data:`PyExc_OSError` instead.
+
+.. c:var:: PyObject *PyExc_WindowsError
+
+   .. availability:: Windows
+
+   .. soft-deprecated:: next
+      Use :c:data:`PyExc_OSError` instead.
 
 
 .. _standardwarningcategories:

Doc/tools/removed-ids.txt

@@ -121,3 +121,6 @@ library/turtle.html: introduction
 # Wrong exception names in 'concurrent.interpreters' docs (gh-136563)
 library/concurrent.interpreters.html: concurrent.interpreters.QueueEmptyError
 library/concurrent.interpreters.html: concurrent.interpreters.QueueFullError
+
+# Removed footnote
+c-api/exceptions.html: win