[New-bugs-announce] [issue45392] docstring of "type" could use an update

[Mark Dickinson]

New submission from Mark Dickinson <dickinsm at gmail.com>:

The docstring of the "type" builtin is mildly confusing. Here's what the first few lines of the output for `help(type)` look like for me (on Python 3.10.0rc2):

class type(object)
 |  type(object_or_name, bases, dict)
 |  type(object) -> the object's type
 |  type(name, bases, dict) -> a new type

The first line there seems redundant, and potentially misleading, since it suggests that `type(object, bases, dict)` might be legal.

The third line is missing mention of possible keyword arguments.

----------
messages: 403302
nosy: mark.dickinson
priority: normal
severity: normal
status: open
title: docstring of "type" could use an update

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue45392>
_______________________________________