]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
gh-89554: Document NoneType, NotImplementedType and EllipsisType as classes (GH-150682)
authorBernát Gábor <gaborjbernat@gmail.com>
Tue, 2 Jun 2026 07:55:01 +0000 (00:55 -0700)
committerGitHub <noreply@github.com>
Tue, 2 Jun 2026 07:55:01 +0000 (10:55 +0300)
Always use the directive and the role "class" instead of "data" for
NoneType, NotImplementedType and EllipsisType.

Doc/library/constants.rst
Doc/library/types.rst
Doc/whatsnew/3.10.rst

index d058ba206c6cd62720300d8ee3776ca06eea4cba..6f005f98bd3ede57408e6a57710773490c98149c 100644 (file)
@@ -22,7 +22,7 @@ A small number of constants live in the built-in namespace.  They are:
    An object frequently used to represent the absence of a value, as when
    default arguments are not passed to a function. Assignments to ``None``
    are illegal and raise a :exc:`SyntaxError`.
-   ``None`` is the sole instance of the :data:`~types.NoneType` type.
+   ``None`` is the sole instance of the :class:`~types.NoneType` type.
 
 
 .. data:: NotImplemented
@@ -33,7 +33,7 @@ A small number of constants live in the built-in namespace.  They are:
    the other type; may be returned by the in-place binary special methods
    (e.g. :meth:`~object.__imul__`, :meth:`~object.__iand__`, etc.) for the same purpose.
    It should not be evaluated in a boolean context.
-   :data:`!NotImplemented` is the sole instance of the :data:`types.NotImplementedType` type.
+   :data:`!NotImplemented` is the sole instance of the :class:`types.NotImplementedType` type.
 
    .. note::
 
@@ -68,7 +68,7 @@ A small number of constants live in the built-in namespace.  They are:
    The same as the ellipsis literal "``...``", an object frequently used to
    indicate that something is omitted. Assignment to ``Ellipsis`` is possible, but
    assignment to  ``...`` raises a :exc:`SyntaxError`.
-   ``Ellipsis`` is the sole instance of the :data:`types.EllipsisType` type.
+   ``Ellipsis`` is the sole instance of the :class:`types.EllipsisType` type.
 
 
 .. data:: __debug__
index 74898baa521bd69f1c6dacc42518b8399cc525a3..b4793be9bdfd7073b3655deb9469ab063f851f9a 100644 (file)
@@ -143,7 +143,7 @@ If you instantiate any of these types, note that signatures may vary between Pyt
 
 Standard names are defined for the following types:
 
-.. data:: NoneType
+.. class:: NoneType
 
    The type of :data:`None`.
 
@@ -233,7 +233,7 @@ Standard names are defined for the following types:
    .. versionadded:: 3.7
 
 
-.. data:: NotImplementedType
+.. class:: NotImplementedType
 
    The type of :data:`NotImplemented`.
 
@@ -273,7 +273,7 @@ Standard names are defined for the following types:
          creating :class:`!ModuleType` instances which ensures the various
          attributes are set appropriately.
 
-.. data:: EllipsisType
+.. class:: EllipsisType
 
    The type of :data:`Ellipsis`.
 
index 8a78dbd90382ed7f8f811be2714a9aa0f6f882ee..0a01462aa430e7d2d36a1f4e3479e55b10496fac 100644 (file)
@@ -1446,8 +1446,8 @@ as a positional-only argument.
 types
 -----
 
-Reintroduce the :data:`types.EllipsisType`, :data:`types.NoneType`
-and :data:`types.NotImplementedType` classes, providing a new set
+Reintroduce the :class:`types.EllipsisType`, :class:`types.NoneType`
+and :class:`types.NotImplementedType` classes, providing a new set
 of types readily interpretable by type checkers.
 (Contributed by Bas van Beek in :issue:`41810`.)