This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: help() is too noisy for types used like functions
Type: enhancement Stage:
Components: Library (Lib) Versions: Python 3.11
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: Nosy List: rhettinger
Priority: normal Keywords:

Created on 2021-10-15 21:29 by rhettinger, last changed 2022-04-11 14:59 by admin.

Messages (1)
msg404050 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2021-10-15 21:29
When someone requests help(range), help(zip), help(property), or help(classmethod), the expectation and need is to see something like what is shown in main documentation rather than being subjected to a listing of every standard dunder method.

It would be nice to have a way to mark types that are mostly used like functions so that help() output will be more focused and less noisy.  Then help() can omit the Methods and Static methods sections.  It would keep the section for non-standard descriptors such as start, stop, step, fget, fset, or fdel.

Alternatively, for all types, we can condense the Methods and Static Methods sections to just list the standard dunder methods rather that eating several rows of output per method.
History
Date User Action Args
2022-04-11 14:59:51adminsetgithub: 89654
2021-10-15 21:29:28rhettingercreate