Stefan Seefeld <ste...@seefeld.name> added the comment:

Exactly ! I'm fully aware of the ubiquity of objects in Python, and it is for 
that reason that I had naively expected `pydoc` to simply DoTheRightThing when 
encountering an object containing a `__doc__` attribute. rather than only 
working for types and function objects.

OK, assuming that this is a recognized bug / limitation, it seems easy to 
address.

Is there any discussion concerning what syntax might be used for docstrings 
associated with objects ? (There seem to be some partial solutions added on top 
of the Python parser (I think `epydoc` offered one), but it would be nice to 
have a built-in solution to avoid having to re-invent wheels.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue35449>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to