New submission from Mark Dickinson <dicki...@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 <rep...@bugs.python.org>
<https://bugs.python.org/issue45392>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to