Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion Doc/c-api/buffer.rst
Original file line number Diff line number Diff line change
Expand Up @@ -263,7 +263,9 @@ readonly, format

.. c:macro:: PyBUF_WRITEABLE

This is a :term:`soft deprecated` alias to :c:macro:`PyBUF_WRITABLE`.
This is an alias to :c:macro:`PyBUF_WRITABLE`.

.. soft-deprecated:: 3.13

.. c:macro:: PyBUF_FORMAT

Expand Down
4 changes: 3 additions & 1 deletion Doc/c-api/code.rst
Original file line number Diff line number Diff line change
Expand Up @@ -214,14 +214,16 @@ bound into a function.

.. c:function:: PyObject *PyCode_Optimize(PyObject *code, PyObject *consts, PyObject *names, PyObject *lnotab_obj)

This is a :term:`soft deprecated` function that does nothing.
This is a function that does nothing.

Prior to Python 3.10, this function would perform basic optimizations to a
code object.

.. versionchanged:: 3.10
This function now does nothing.

.. soft-deprecated:: 3.13


.. _c_codeobject_flags:

Expand Down
4 changes: 3 additions & 1 deletion Doc/c-api/gen.rst
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,9 @@ Deprecated API

.. c:macro:: PyAsyncGenASend_CheckExact(op)

This is a :term:`soft deprecated` API that was included in Python's C API
This is an API that was included in Python's C API
by mistake.

It is solely here for completeness; do not use this API.

.. soft-deprecated:: 3.14
12 changes: 6 additions & 6 deletions Doc/c-api/intro.rst
Original file line number Diff line number Diff line change
Expand Up @@ -508,22 +508,22 @@ in C11.

.. c:macro:: Py_MEMCPY(dest, src, n)

This is a :term:`soft deprecated` alias to :c:func:`!memcpy`.
Use :c:func:`!memcpy` directly instead.
This is an alias to :c:func:`!memcpy`.

.. deprecated:: 3.14
The macro is :term:`soft deprecated`.
.. soft-deprecated:: 3.14
Use :c:func:`!memcpy` directly instead.

.. c:macro:: Py_VA_COPY

This is a :term:`soft deprecated` alias to the C99-standard ``va_copy``
function.
This is an alias to the C99-standard ``va_copy`` function.

Historically, this would use a compiler-specific method to copy a ``va_list``.

.. versionchanged:: 3.6
This is now an alias to ``va_copy``.

.. soft-deprecated:: 3.14


.. _api-objects:

Expand Down
4 changes: 3 additions & 1 deletion Doc/c-api/set.rst
Original file line number Diff line number Diff line change
Expand Up @@ -204,7 +204,7 @@ Deprecated API

.. c:macro:: PySet_MINSIZE

A :term:`soft deprecated` constant representing the size of an internal
A constant representing the size of an internal
preallocated table inside :c:type:`PySetObject` instances.

This is documented solely for completeness, as there are no guarantees
Expand All @@ -214,3 +214,5 @@ Deprecated API
:c:macro:`!PySet_MINSIZE` can be replaced with a small constant like ``8``.

If looking for the size of a set, use :c:func:`PySet_Size` instead.

.. soft-deprecated:: 3.14
8 changes: 5 additions & 3 deletions Doc/c-api/typeobj.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1376,8 +1376,8 @@ and :c:data:`PyType_Type` effectively act as defaults.)

.. versionchanged:: 3.9

Renamed to the current name, without the leading underscore.
The old provisional name is :term:`soft deprecated`.
Renamed to the current name, without the leading underscore.
The old provisional name is :term:`soft deprecated`.

.. versionchanged:: 3.12

Expand Down Expand Up @@ -1486,11 +1486,13 @@ and :c:data:`PyType_Type` effectively act as defaults.)

.. c:macro:: Py_TPFLAGS_HAVE_VERSION_TAG

This is a :term:`soft deprecated` macro that does nothing.
This macro does nothing.
Historically, this would indicate that the
:c:member:`~PyTypeObject.tp_version_tag` field was available and
initialized.

.. soft-deprecated:: 3.13


.. c:macro:: Py_TPFLAGS_INLINE_VALUES

Expand Down
4 changes: 2 additions & 2 deletions Doc/library/ctypes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3191,8 +3191,8 @@ Arrays and pointers
Equivalent to ``type * length``, where *type* is a
:mod:`!ctypes` data type and *length* an integer.

This function is :term:`soft deprecated` in favor of multiplication.
There are no plans to remove it.
.. soft-deprecated:: 3.14
In favor of multiplication.


.. class:: _Pointer
Expand Down
2 changes: 1 addition & 1 deletion Doc/library/mimetypes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ the information :func:`init` sets up.
Added support for *url* being a :term:`path-like object`.

.. soft-deprecated:: 3.13
Passing a file path instead of URL is :term:`soft deprecated`.
Passing a file path instead of URL.
Use :func:`guess_file_type` for this.


Expand Down
Loading