From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sat, 8 Nov 2025 18:20:56 +0000 (+0100)
Subject: [3.13] gh-141004: Document the `PyDoc_VAR` macro (GH-141263) (GH-141265)
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=2a300e36420f56383c6871d050ea74e525c7f590;p=thirdparty%2FPython%2Fcpython.git

[3.13] gh-141004: Document the `PyDoc_VAR` macro (GH-141263) (GH-141265)

gh-141004: Document the `PyDoc_VAR` macro (GH-141263)
(cherry picked from commit 545299773b40fb589cbd5e54d1d597207d9a2a76)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>
---

diff --git a/Doc/c-api/intro.rst b/Doc/c-api/intro.rst
index 62ad5be7b8ac..b4a0fa74ffe0 100644
--- a/Doc/c-api/intro.rst
+++ b/Doc/c-api/intro.rst
@@ -247,7 +247,7 @@ complete listing.
 
 .. c:macro:: PyDoc_STRVAR(name, str)
 
-   Creates a variable with name ``name`` that can be used in docstrings.
+   Creates a variable with name *name* that can be used in docstrings.
    If Python is built without docstrings, the value will be empty.
 
    Use :c:macro:`PyDoc_STRVAR` for docstrings to support building
@@ -279,6 +279,15 @@ complete listing.
           {NULL, NULL}
       };
 
+.. c:macro:: PyDoc_VAR(name)
+
+   Declares a static character array variable with the given name *name*.
+
+   For example::
+
+      PyDoc_VAR(python_doc) = PyDoc_STR("A genus of constricting snakes in the Pythonidae family native "
+                                        "to the tropics and subtropics of the Eastern Hemisphere.");
+
 
 .. _api-objects: