From: Peter Bierma <zintensitydev@gmail.com>
Date: Sat, 8 Nov 2025 17:29:31 +0000 (-0500)
Subject: gh-141004: Document `PyBUF_WRITEABLE` (GH-141255)
X-Git-Tag: v3.15.0a2~154
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=5e5fc0404ed983bb37a19793a5c802d0d9852e5d;p=thirdparty%2FPython%2Fcpython.git

gh-141004: Document `PyBUF_WRITEABLE` (GH-141255)
---

diff --git a/Doc/c-api/buffer.rst b/Doc/c-api/buffer.rst
index d3081894eada..6bb72a2312be 100644
--- a/Doc/c-api/buffer.rst
+++ b/Doc/c-api/buffer.rst
@@ -261,6 +261,10 @@ readonly, format
       MUST be consistent for all consumers. For example, :c:expr:`PyBUF_SIMPLE | PyBUF_WRITABLE`
       can be used to request a simple writable buffer.
 
+   .. c:macro:: PyBUF_WRITEABLE
+
+      This is a :term:`soft deprecated` alias to :c:macro:`PyBUF_WRITABLE`.
+
    .. c:macro:: PyBUF_FORMAT
 
       Controls the :c:member:`~Py_buffer.format` field. If set, this field MUST