aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2021-01-21 22:09:50 -0800
committerGitHub <noreply@github.com>2021-01-21 22:09:50 -0800
commit98e1f5c778b9719f6338a3247da95402192bad18 (patch)
tree4e1dd21211e5e6b972d8318891ffa8c57f7b3824
parentbpo-42780: Fix set_inheritable() for O_PATH file descriptors on Linux (GH-241... (diff)
downloadcpython-98e1f5c778b9719f6338a3247da95402192bad18.tar.gz
cpython-98e1f5c778b9719f6338a3247da95402192bad18.tar.bz2
cpython-98e1f5c778b9719f6338a3247da95402192bad18.zip
bpo-40304: Correct type(name, bases, dict) doc (GH-19553)
Co-authored-by: Éric Araujo <merwok@netwok.org> Co-authored-by: Terry Jan Reedy <tjreedy@udel.edu> Co-authored-by: Tal Einat <532281+taleinat@users.noreply.github.com> (cherry picked from commit 644d52818a6391535e5838fd57d58ffcb1163056) Co-authored-by: Борис Верховский <boris.verk@gmail.com>
-rw-r--r--Doc/library/functions.rst17
-rw-r--r--Misc/NEWS.d/next/Documentation/2021-01-20-23-03-49.bpo-40304.-LK7Ps.rst2
2 files changed, 11 insertions, 8 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 9c12b6c48d8..9d13967c04f 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1687,18 +1687,19 @@ are always available. They are listed here in alphabetical order.
With three arguments, return a new type object. This is essentially a
- dynamic form of the :keyword:`class` statement. The *name* string is the
- class name and becomes the :attr:`~definition.__name__` attribute; the *bases*
- tuple itemizes the base classes and becomes the :attr:`~class.__bases__`
- attribute; and the *dict* dictionary is the namespace containing definitions
- for class body and is copied to a standard dictionary to become the
- :attr:`~object.__dict__` attribute. For example, the following two
- statements create identical :class:`type` objects:
+ dynamic form of the :keyword:`class` statement. The *name* string is
+ the class name and becomes the :attr:`~definition.__name__` attribute.
+ The *bases* tuple contains the base classes and becomes the
+ :attr:`~class.__bases__` attribute; if empty, :class:`object`, the
+ ultimate base of all classes, is added. The *dict* dictionary contains
+ attribute and method definitions for the class body; it may be copied
+ or wrapped before becoming the :attr:`~object.__dict__` attribute.
+ The following two statements create identical :class:`type` objects:
>>> class X:
... a = 1
...
- >>> X = type('X', (object,), dict(a=1))
+ >>> X = type('X', (), dict(a=1))
See also :ref:`bltin-type-objects`.
diff --git a/Misc/NEWS.d/next/Documentation/2021-01-20-23-03-49.bpo-40304.-LK7Ps.rst b/Misc/NEWS.d/next/Documentation/2021-01-20-23-03-49.bpo-40304.-LK7Ps.rst
new file mode 100644
index 00000000000..3f2f14c2d7b
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2021-01-20-23-03-49.bpo-40304.-LK7Ps.rst
@@ -0,0 +1,2 @@
+Fix doc for type(name, bases, dict). Patch by Boris Verkhovskiy and
+Éric Araujo.