https://github.com/python/cpython/commit/fc600e41780cc9aa31baf7ce85fa630038a47270
commit: fc600e41780cc9aa31baf7ce85fa630038a47270
branch: 3.13
author: Miss Islington (bot) <[email protected]>
committer: Yhg1s <[email protected]>
date: 2026-06-09T22:21:51+02:00
summary:

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

(cherry picked from commit a1873300eebe9c634f59592c3333035768f09de9)

Co-authored-by: Christian Zinck <[email protected]>
Co-authored-by: Stan Ulbrych <[email protected]>

files:
M Doc/c-api/typeobj.rst
M Doc/tools/.nitignore

diff --git a/Doc/c-api/typeobj.rst b/Doc/c-api/typeobj.rst
index f22201dc399333b..561f95cb90a1778 100644
--- a/Doc/c-api/typeobj.rst
+++ b/Doc/c-api/typeobj.rst
@@ -611,9 +611,7 @@ and :c:data:`PyType_Type` effectively act as defaults.)
    argument, and store in the instance's :c:member:`~PyVarObject.ob_size` 
field.
    Note that the :c:member:`~PyVarObject.ob_size` field may later be used for
    other purposes. For example, :py:type:`int` instances use the bits of
-   :c:member:`~PyVarObject.ob_size` in an implementation-defined
-   way; the underlying storage and its size should be accessed using
-   :c:func:`PyLong_Export`.
+   :c:member:`~PyVarObject.ob_size` in an implementation-defined way.
 
    .. note::
 
@@ -2745,13 +2743,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``.
 
@@ -2759,10 +2757,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
@@ -2806,7 +2804,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 39b88f88a61b7c5..c863c99e6dca0c7 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/asyncio-policy.rst

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to