gh-141004: Document soft-deprecated symbols

Doc/c-api/file.rst

@@ -131,3 +131,15 @@ the :mod:`io` APIs instead.
 
    Write string *s* to file object *p*.  Return ``0`` on success or ``-1`` on
    failure; the appropriate exception will be set.
+
+
+Deprecated API
+^^^^^^^^^^^^^^
+
+.. c:function:: PyObject *PyFile_NewStdPrinter(void)
+
+.. c:var:: PyTypeObject PyStdPrinter_Type
+
+   These are :term:`soft deprecated` APIs that were included in Python's C API
+   by mistake. They are documented solely for completeness; use other
+   ``PyFile*`` APIs instead.

Doc/c-api/gen.rst

@@ -44,3 +44,14 @@ than explicitly calling :c:func:`PyGen_New` or :c:func:`PyGen_NewWithQualName`.
    with ``__name__`` and ``__qualname__`` set to *name* and *qualname*.
    A reference to *frame* is stolen by this function.  The *frame* argument
    must not be ``NULL``.
+
+
+Deprecated API
+^^^^^^^^^^^^^^
+
+.. c:macro:: PyAsyncGenASend_CheckExact(op)
+
+   This is a :term:`soft deprecated` API that was included in Python's C API
+   by mistake.
+
+   It is solely here for completeness; do not use this API.

Doc/c-api/long.rst

@@ -855,3 +855,16 @@ The :c:type:`PyLongWriter` API can be used to import an integer.
    If *writer* is ``NULL``, no operation is performed.
 
    The writer instance and the *digits* array are invalid after the call.
+
+
+Deprecated API
+^^^^^^^^^^^^^^
+
+.. c:macro:: PyLong_BASE
+.. c:macro:: PyLong_SHIFT
+.. c:macro:: PyLong_MASK
+
+   These macros are :term:`soft deprecated`. They represent internal constants
+   for :c:type:`PyLongObject` instances.
+
+   Do not use these; use :c:func:`PyLong_GetNativeLayout` instead.

Doc/c-api/set.rst

@@ -166,3 +166,15 @@ subtypes but not for instances of :class:`frozenset` or its subtypes.
    Empty an existing set of all elements. Return ``0`` on
    success. Return ``-1`` and raise :exc:`SystemError` if *set* is not an instance of
    :class:`set` or its subtype.
+
+
+Deprecated API
+^^^^^^^^^^^^^^
+
+.. c:macro:: PySet_MINSIZE
+
+   This is a :term:`soft deprecated` constant representing the size of a
+   preallocated table inside :c:type:`PySetObject` instances.
+
+   This is documented solely for completeness and not useful to users in any
+   way. If looking for the size of a set, use :c:func:`PySet_Size` instead.