mirror of
https://github.com/python/cpython
synced 2024-09-16 05:19:56 +00:00
gh-93738: Documentation C syntax (:c:data:view->obj
-> :c:expr:view->obj
) (#97773)
:c:data:`view->obj` -> :c:expr:`view->obj`
This commit is contained in:
parent
a77d9dedcd
commit
fa59bda8d3
|
@ -2356,13 +2356,13 @@ Buffer Object Structures
|
||||||
steps:
|
steps:
|
||||||
|
|
||||||
(1) Check if the request can be met. If not, raise :c:data:`PyExc_BufferError`,
|
(1) Check if the request can be met. If not, raise :c:data:`PyExc_BufferError`,
|
||||||
set :c:data:`view->obj` to ``NULL`` and return ``-1``.
|
set :c:expr:`view->obj` to ``NULL`` and return ``-1``.
|
||||||
|
|
||||||
(2) Fill in the requested fields.
|
(2) Fill in the requested fields.
|
||||||
|
|
||||||
(3) Increment an internal counter for the number of exports.
|
(3) Increment an internal counter for the number of exports.
|
||||||
|
|
||||||
(4) Set :c:data:`view->obj` to *exporter* and increment :c:data:`view->obj`.
|
(4) Set :c:expr:`view->obj` to *exporter* and increment :c:expr:`view->obj`.
|
||||||
|
|
||||||
(5) Return ``0``.
|
(5) Return ``0``.
|
||||||
|
|
||||||
|
@ -2370,10 +2370,10 @@ Buffer Object Structures
|
||||||
schemes can be used:
|
schemes can be used:
|
||||||
|
|
||||||
* Re-export: Each member of the tree acts as the exporting object and
|
* Re-export: Each member of the tree acts as the exporting object and
|
||||||
sets :c:data:`view->obj` to a new reference to itself.
|
sets :c:expr:`view->obj` to a new reference to itself.
|
||||||
|
|
||||||
* Redirect: The buffer request is redirected to the root object of the
|
* Redirect: The buffer request is redirected to the root object of the
|
||||||
tree. Here, :c:data:`view->obj` will be a new reference to the root
|
tree. Here, :c:expr:`view->obj` will be a new reference to the root
|
||||||
object.
|
object.
|
||||||
|
|
||||||
The individual fields of *view* are described in section
|
The individual fields of *view* are described in section
|
||||||
|
@ -2415,7 +2415,7 @@ Buffer Object Structures
|
||||||
*view* argument.
|
*view* argument.
|
||||||
|
|
||||||
|
|
||||||
This function MUST NOT decrement :c:data:`view->obj`, since that is
|
This function MUST NOT decrement :c:expr:`view->obj`, since that is
|
||||||
done automatically in :c:func:`PyBuffer_Release` (this scheme is
|
done automatically in :c:func:`PyBuffer_Release` (this scheme is
|
||||||
useful for breaking reference cycles).
|
useful for breaking reference cycles).
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue