From: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Date: Fri, 30 May 2025 04:11:20 +0000 (-0700)
Subject: ast docs: Fix description of ast.Constant (#134741)
X-Git-Tag: v3.15.0a1~1455
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=381020d41fb1f8b33421f01c609ba0d0edb99764;p=thirdparty%2FPython%2Fcpython.git

ast docs: Fix description of ast.Constant (#134741)

Contrary to the current docs, ast.Constant will never hold containers
such as frozenset or tuple; the Python parser only emits it for simple
literals.

For precision, add the exact list of types that may be contained in an
ast.Constant.
---

diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index ca9a6b0712c9..cf22250cac60 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -268,9 +268,9 @@ Literals
 .. class:: Constant(value)
 
    A constant value. The ``value`` attribute of the ``Constant`` literal contains the
-   Python object it represents. The values represented can be simple types
-   such as a number, string or ``None``, but also immutable container types
-   (tuples and frozensets) if all of their elements are constant.
+   Python object it represents. The values represented can be instances of :class:`str`,
+   :class:`bytes`, :class:`int`, :class:`float`, :class:`complex`, and :class:`bool`,
+   and the constants :data:`None` and :data:`Ellipsis`.
 
    .. doctest::