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.

Author Faris Chugthai
Recipients Faris Chugthai, docs@python
Date 2020-12-22.04:26:30
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1608611191.07.0.553217513358.issue42710@roundup.psfhosted.org>
In-reply-to
Content
I'm sure that this has been observed before, but I was unable to find the original issue where this was discussed so I'm going to apologize in advance for what is probably a duplicate issue.

But why is there no documentation available on the classes and functions available in the pydoc module?

There are a large number of well documented classes, methods and functions and I could easily imagine legitimate motivations to want to import some of the functionality provided and use it in a project.

No information on the 2000 lines of code in pydoc.py are provided at https://docs.python.org/3/library/pydoc.html

Running:

`python -m pydoc -w pydoc`

Generates a similarly sparse file.

In addition, running in the interactive interpreter:

>>> help(pydoc)

shows almost no real information. I'm genuinely unsure of why this happens. Even if this is an intentional design decision for how the Helper class is supposed to work, why isn't there corresponding information for the different classes at `Doc/library/pydoc.rst`?

Searching for something like `pydoc.TextRepr` in the search bar of docs.python.org doesn't return anything at all.

Sorry if there's something horrifically obvious I'm missing here guys but I'd appreciate any clarification on this matter.
History
Date User Action Args
2020-12-22 04:26:31Faris Chugthaisetrecipients: + Faris Chugthai, docs@python
2020-12-22 04:26:31Faris Chugthaisetmessageid: <1608611191.07.0.553217513358.issue42710@roundup.psfhosted.org>
2020-12-22 04:26:31Faris Chugthailinkissue42710 messages
2020-12-22 04:26:30Faris Chugthaicreate