mirror of
https://github.com/python/cpython.git
synced 2025-09-26 18:29:57 +00:00
[3.13] gh-118181: Fix parameter markup in AST docs (GH-124473) (#124600)
gh-118181: Fix parameter markup in AST docs (GH-124473)
(cherry picked from commit 09aebb1fbc
)
Co-authored-by: Tomas R <tomas.roun8@gmail.com>
This commit is contained in:
parent
c2aaf50780
commit
c74679bff7
1 changed files with 13 additions and 13 deletions
|
@ -173,9 +173,9 @@ Root nodes
|
|||
A Python module, as with :ref:`file input <file-input>`.
|
||||
Node type generated by :func:`ast.parse` in the default ``"exec"`` *mode*.
|
||||
|
||||
*body* is a :class:`list` of the module's :ref:`ast-statements`.
|
||||
``body`` is a :class:`list` of the module's :ref:`ast-statements`.
|
||||
|
||||
*type_ignores* is a :class:`list` of the module's type ignore comments;
|
||||
``type_ignores`` is a :class:`list` of the module's type ignore comments;
|
||||
see :func:`ast.parse` for more details.
|
||||
|
||||
.. doctest::
|
||||
|
@ -194,7 +194,7 @@ Root nodes
|
|||
A single Python :ref:`expression input <expression-input>`.
|
||||
Node type generated by :func:`ast.parse` when *mode* is ``"eval"``.
|
||||
|
||||
*body* is a single node,
|
||||
``body`` is a single node,
|
||||
one of the :ref:`expression types <ast-expressions>`.
|
||||
|
||||
.. doctest::
|
||||
|
@ -209,7 +209,7 @@ Root nodes
|
|||
A single :ref:`interactive input <interactive>`, like in :ref:`tut-interac`.
|
||||
Node type generated by :func:`ast.parse` when *mode* is ``"single"``.
|
||||
|
||||
*body* is a :class:`list` of :ref:`statement nodes <ast-statements>`.
|
||||
``body`` is a :class:`list` of :ref:`statement nodes <ast-statements>`.
|
||||
|
||||
.. doctest::
|
||||
|
||||
|
@ -238,9 +238,9 @@ Root nodes
|
|||
# type: (int, int) -> int
|
||||
return a + b
|
||||
|
||||
*argtypes* is a :class:`list` of :ref:`expression nodes <ast-expressions>`.
|
||||
``argtypes`` is a :class:`list` of :ref:`expression nodes <ast-expressions>`.
|
||||
|
||||
*returns* is a single :ref:`expression node <ast-expressions>`.
|
||||
``returns`` is a single :ref:`expression node <ast-expressions>`.
|
||||
|
||||
.. doctest::
|
||||
|
||||
|
@ -1766,9 +1766,9 @@ aliases.
|
|||
|
||||
.. class:: TypeVar(name, bound, default_value)
|
||||
|
||||
A :class:`typing.TypeVar`. *name* is the name of the type variable.
|
||||
*bound* is the bound or constraints, if any. If *bound* is a :class:`Tuple`,
|
||||
it represents constraints; otherwise it represents the bound. *default_value*
|
||||
A :class:`typing.TypeVar`. ``name`` is the name of the type variable.
|
||||
``bound`` is the bound or constraints, if any. If ``bound`` is a :class:`Tuple`,
|
||||
it represents constraints; otherwise it represents the bound. ``default_value``
|
||||
is the default value; if the :class:`!TypeVar` has no default, this
|
||||
attribute will be set to ``None``.
|
||||
|
||||
|
@ -1796,8 +1796,8 @@ aliases.
|
|||
|
||||
.. class:: ParamSpec(name, default_value)
|
||||
|
||||
A :class:`typing.ParamSpec`. *name* is the name of the parameter specification.
|
||||
*default_value* is the default value; if the :class:`!ParamSpec` has no default,
|
||||
A :class:`typing.ParamSpec`. ``name`` is the name of the parameter specification.
|
||||
``default_value`` is the default value; if the :class:`!ParamSpec` has no default,
|
||||
this attribute will be set to ``None``.
|
||||
|
||||
.. doctest::
|
||||
|
@ -1831,8 +1831,8 @@ aliases.
|
|||
|
||||
.. class:: TypeVarTuple(name, default_value)
|
||||
|
||||
A :class:`typing.TypeVarTuple`. *name* is the name of the type variable tuple.
|
||||
*default_value* is the default value; if the :class:`!TypeVarTuple` has no
|
||||
A :class:`typing.TypeVarTuple`. ``name`` is the name of the type variable tuple.
|
||||
``default_value`` is the default value; if the :class:`!TypeVarTuple` has no
|
||||
default, this attribute will be set to ``None``.
|
||||
|
||||
.. doctest::
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue