[Python-checkins] bpo-45392: Update the docstring of the 'type' built-in (GH-29439) (GH-29452)

ambv webhook-mailer at python.org
Sat Nov 6 16:21:13 EDT 2021


https://github.com/python/cpython/commit/045f205ba4710c4c633364a4e2e098483af936e5
commit: 045f205ba4710c4c633364a4e2e098483af936e5
branch: 3.10
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: ambv <lukasz at langa.pl>
date: 2021-11-06T21:21:04+01:00
summary:

bpo-45392: Update the docstring of the 'type' built-in (GH-29439) (GH-29452)

(cherry picked from commit 91275207296c39e495fe118019a757c4ddefede8)

Co-authored-by: Mark Dickinson <mdickinson at enthought.com>

files:
A Misc/NEWS.d/next/Documentation/2021-11-06-10-54-17.bpo-45392.JZnVOz.rst
M Objects/typeobject.c

diff --git a/Misc/NEWS.d/next/Documentation/2021-11-06-10-54-17.bpo-45392.JZnVOz.rst b/Misc/NEWS.d/next/Documentation/2021-11-06-10-54-17.bpo-45392.JZnVOz.rst
new file mode 100644
index 0000000000000..09c16578ff478
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2021-11-06-10-54-17.bpo-45392.JZnVOz.rst
@@ -0,0 +1,2 @@
+Update the docstring of the :class:`type` built-in to remove a redundant
+line and to mention keyword arguments for the constructor.
diff --git a/Objects/typeobject.c b/Objects/typeobject.c
index dc06cf0a0c11b..02046e5f2ebef 100644
--- a/Objects/typeobject.c
+++ b/Objects/typeobject.c
@@ -4221,10 +4221,8 @@ static PyMethodDef type_methods[] = {
 };
 
 PyDoc_STRVAR(type_doc,
-/* this text signature cannot be accurate yet.  will fix.  --larry */
-"type(object_or_name, bases, dict)\n"
 "type(object) -> the object's type\n"
-"type(name, bases, dict) -> a new type");
+"type(name, bases, dict, **kwds) -> a new type");
 
 static int
 type_traverse(PyTypeObject *type, visitproc visit, void *arg)



More information about the Python-checkins mailing list