https://github.com/python/cpython/commit/e40190e104c81b61cdc6f71a391e28de53bbc1d8
commit: e40190e104c81b61cdc6f71a391e28de53bbc1d8
branch: main
author: Bernát Gábor <[email protected]>
committer: serhiy-storchaka <[email protected]>
date: 2026-06-02T10:55:01+03:00
summary:
gh-89554: Document NoneType, NotImplementedType and EllipsisType as classes
(GH-150682)
Always use the directive and the role "class" instead of "data" for
NoneType, NotImplementedType and EllipsisType.
files:
M Doc/library/constants.rst
M Doc/library/types.rst
M Doc/whatsnew/3.10.rst
diff --git a/Doc/library/constants.rst b/Doc/library/constants.rst
index d058ba206c6cd6..6f005f98bd3ede 100644
--- a/Doc/library/constants.rst
+++ b/Doc/library/constants.rst
@@ -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__
diff --git a/Doc/library/types.rst b/Doc/library/types.rst
index 74898baa521bd6..b4793be9bdfd70 100644
--- a/Doc/library/types.rst
+++ b/Doc/library/types.rst
@@ -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`.
diff --git a/Doc/whatsnew/3.10.rst b/Doc/whatsnew/3.10.rst
index 8a78dbd90382ed..0a01462aa430e7 100644
--- a/Doc/whatsnew/3.10.rst
+++ b/Doc/whatsnew/3.10.rst
@@ -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`.)
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
