]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
gh-118181: Fix parameter markup in AST docs (#124473)
authorTomas R <tomas.roun8@gmail.com>
Thu, 26 Sep 2024 13:38:25 +0000 (15:38 +0200)
committerGitHub <noreply@github.com>
Thu, 26 Sep 2024 13:38:25 +0000 (06:38 -0700)
Doc/library/ast.rst

index a8a18ad31fb773aa9493a175d5ed0b0cddaf1c77..a9518859b83478a19731cad27bcc441d5edf30bc 100644 (file)
@@ -178,9 +178,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::
@@ -199,7 +199,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::
@@ -214,7 +214,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::
 
@@ -243,9 +243,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::
 
@@ -1771,9 +1771,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``.
 
@@ -1801,8 +1801,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::
@@ -1836,8 +1836,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::