From: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
Date: Mon, 17 Nov 2025 22:52:13 +0000 (+0000)
Subject: gh-141004: Document `Py_MEMCPY` (GH-141676)
X-Git-Tag: v3.15.0a2~7
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=16ea9505ce690485bab38691e5a83f467757fc03;p=thirdparty%2FPython%2Fcpython.git

gh-141004: Document `Py_MEMCPY` (GH-141676)
---

diff --git a/Doc/c-api/intro.rst b/Doc/c-api/intro.rst
index c76cc2f70ecc..bace21b79810 100644
--- a/Doc/c-api/intro.rst
+++ b/Doc/c-api/intro.rst
@@ -183,6 +183,14 @@ complete listing.
 
    .. versionadded:: 3.6
 
+.. c:macro:: Py_MEMCPY(dest, src, n)
+
+   This is a :term:`soft deprecated` alias to :c:func:`!memcpy`.
+   Use :c:func:`!memcpy` directly instead.
+
+   .. deprecated:: 3.14
+      The macro is :term:`soft deprecated`.
+
 .. c:macro:: Py_MIN(x, y)
 
    Return the minimum value between ``x`` and ``y``.
diff --git a/Misc/NEWS.d/3.14.0a1.rst b/Misc/NEWS.d/3.14.0a1.rst
index 305a0b65b98e..1938976fa422 100644
--- a/Misc/NEWS.d/3.14.0a1.rst
+++ b/Misc/NEWS.d/3.14.0a1.rst
@@ -6092,7 +6092,7 @@ Patch by Victor Stinner.
 .. nonce: qOr9GF
 .. section: C API
 
-Soft deprecate the :c:macro:`!Py_MEMCPY` macro: use directly ``memcpy()``
+Soft deprecate the :c:macro:`Py_MEMCPY` macro: use directly ``memcpy()``
 instead.  Patch by Victor Stinner.
 
 ..