From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Mon, 8 Jun 2026 10:33:13 +0000 (+0200)
Subject: [3.14] gh-101100: Fix Sphinx warnings in 'Buffer Object Structures' documentation... 
X-Git-Tag: v3.14.6~27
X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=6bd2e08a5d807b3eecee20cf2f3095816328c109;p=thirdparty%2FPython%2Fcpython.git

[3.14] gh-101100: Fix Sphinx warnings in 'Buffer Object Structures' documentation (GH-151058)

(cherry picked from commit a1873300eebe9c634f59592c3333035768f09de9)

Co-authored-by: Christian Zinck <christian.zinck@gmail.com>
---

diff --git a/Doc/c-api/typeobj.rst b/Doc/c-api/typeobj.rst
index 43c61441bce8..72335a6181ea 100644
--- a/Doc/c-api/typeobj.rst
+++ b/Doc/c-api/typeobj.rst
@@ -3045,13 +3045,13 @@ Buffer Object Structures
    steps:
 
    (1) Check if the request can be met. If not, raise :exc:`BufferError`,
-       set :c:expr:`view->obj` to ``NULL`` and return ``-1``.
+       set ``view->obj`` to ``NULL`` and return ``-1``.
 
    (2) Fill in the requested fields.
 
    (3) Increment an internal counter for the number of exports.
 
-   (4) Set :c:expr:`view->obj` to *exporter* and increment :c:expr:`view->obj`.
+   (4) Set ``view->obj`` to *exporter* and increment ``view->obj``.
 
    (5) Return ``0``.
 
@@ -3077,10 +3077,10 @@ Buffer Object Structures
    schemes can be used:
 
    * Re-export: Each member of the tree acts as the exporting object and
-     sets :c:expr:`view->obj` to a new reference to itself.
+     sets ``view->obj`` to a new reference to itself.
 
    * Redirect: The buffer request is redirected to the root object of the
-     tree. Here, :c:expr:`view->obj` will be a new reference to the root
+     tree. Here, ``view->obj`` will be a new reference to the root
      object.
 
    The individual fields of *view* are described in section
@@ -3134,7 +3134,7 @@ Buffer Object Structures
    *view* argument.
 
 
-   This function MUST NOT decrement :c:expr:`view->obj`, since that is
+   This function MUST NOT decrement ``view->obj``, since that is
    done automatically in :c:func:`PyBuffer_Release` (this scheme is
    useful for breaking reference cycles).
 
diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore
index 520e64f5fe13..f93f2903534c 100644
--- a/Doc/tools/.nitignore
+++ b/Doc/tools/.nitignore
@@ -8,7 +8,6 @@ Doc/c-api/init_config.rst
 Doc/c-api/intro.rst
 Doc/c-api/module.rst
 Doc/c-api/stable.rst
-Doc/c-api/typeobj.rst
 Doc/library/ast.rst
 Doc/library/asyncio-extending.rst
 Doc/library/email.charset.rst