Add pyunicodewriter ref in the doc

Author: vstinner

Doc/c-api/unicode.rst

@@ -1697,10 +1697,12 @@ They all return ``NULL`` or ``-1`` if an exception occurs.
       intern-related details, may change between CPython versions.
 
 
+.. _pyunicodewriter:
+
 PyUnicodeWriter
 ^^^^^^^^^^^^^^^
 
-The :c:type:`PyUnicodeWriter` API can be used to create a Python :class:`str`
+The ``PyUnicodeWriter`` API can be used to create a Python :class:`str`
 object.
 
 .. versionadded:: 3.14
@@ -1916,7 +1918,7 @@ then filling in its contents.
 They are :term:`soft deprecated`: they break the assumption that
 strings are immutable, making them hard to use correctly.
 
-Prefer using the :c:type:`PyUnicodeWriter` API,
+Prefer using the :ref:`PyUnicodeWriter API <pyunicodewriter>`,
 or one of the ``PyUnicode_From*``
 functions such as :c:func:`PyUnicode_FromStringAndSize`.
 
@@ -1971,7 +1973,7 @@ Python does not always check these requirements.
    .. versionadded:: 3.3
 
    .. soft-deprecated:: 3.16
-      Use the :c:type:`PyUnicodeWriter` API instead.
+      Use the :ref:`PyUnicodeWriter API <pyunicodewriter>` instead.
 
 
 .. c:function:: Py_ssize_t PyUnicode_CopyCharacters(PyObject *to, \
@@ -1991,7 +1993,7 @@ Python does not always check these requirements.
    .. versionadded:: 3.3
 
    .. soft-deprecated:: 3.16
-      Use the :c:type:`PyUnicodeWriter` API instead.
+      Use the :ref:`PyUnicodeWriter API <pyunicodewriter>` instead.
 
 
 .. c:function:: int PyUnicode_Resize(PyObject **unicode, Py_ssize_t length);
@@ -2012,7 +2014,7 @@ Python does not always check these requirements.
    See :ref:`pyunicode-new-mutating` for details.
 
    .. soft-deprecated:: 3.16
-      Use the :c:type:`PyUnicodeWriter` API instead.
+      Use the :ref:`PyUnicodeWriter API <pyunicodewriter>` instead.
 
 
 .. c:function:: Py_ssize_t PyUnicode_Fill(PyObject *unicode, Py_ssize_t start, \
@@ -2033,7 +2035,7 @@ Python does not always check these requirements.
    .. versionadded:: 3.3
 
    .. soft-deprecated:: 3.16
-      Use the :c:type:`PyUnicodeWriter` API instead.
+      Use the :ref:`PyUnicodeWriter API <pyunicodewriter>` instead.
 
 
 .. c:function:: int PyUnicode_WriteChar(PyObject *unicode, Py_ssize_t index, \
@@ -2053,4 +2055,4 @@ Python does not always check these requirements.
    .. versionadded:: 3.3
 
    .. soft-deprecated:: 3.16
-      Use the :c:type:`PyUnicodeWriter` API instead.
+      Use the :ref:`PyUnicodeWriter API <pyunicodewriter>` instead.

Doc/whatsnew/3.14.rst

@@ -2990,7 +2990,7 @@ New features in the C API
   The function is also added to the Limited C API.
   (Contributed by Victor Stinner in :gh:`124502`.)
 
-* Add a new :c:type:`PyUnicodeWriter` API to create a Python :class:`str`
+* Add a new :ref:`PyUnicodeWriter API <pyunicodewriter>` to create a Python :class:`str`
   object, with the following functions:
 
   * :c:func:`PyUnicodeWriter_Create`

Doc/whatsnew/3.16.rst

@@ -1384,7 +1384,7 @@ New features
   API.
   (Contributed by Nathan Goldbaum and Victor Stinner in :gh:`158842`.)
 
-* Add the :ref:`PyUnicodeWriter API <PyUnicodeWriter>` to the limited C API.
+* Add the :ref:`PyUnicodeWriter API <pyunicodewriter>` to the limited C API.
   (Contributed by Victor Stinner in :gh:`161172`.)
 
 Porting to Python 3.16
@@ -1434,7 +1434,7 @@ Deprecated C APIs
   :c:func:`PyUnicode_New`, :c:func:`PyUnicode_CopyCharacters`,
   :c:func:`PyUnicode_Fill`, :c:func:`PyUnicode_Resize`,
   :c:func:`PyUnicode_WRITE` and :c:func:`PyUnicode_WriteChar`.
-  Use the safer :c:type:`PyUnicodeWriter` API instead.
+  Use the safer :ref:`PyUnicodeWriter API <pyunicodewriter>` instead.
   (Contributed by Victor Stinner in :gh:`157710`.)
 
 .. Add C API deprecations above alphabetically, not here at the end.

Misc/NEWS.d/next/C_API/2026-11-02-13-15-22.gh-issue-161172.U6kpuN.rst

@@ -1,2 +1,2 @@
-Add the :ref:`PyUnicodeWriter API <PyUnicodeWriter>` to the limited C API.
+Add the :ref:`PyUnicodeWriter API <pyunicodewriter>` to the limited C API.
 Patch by Victor Stinner.