Éric Araujo <mer...@netwok.org> added the comment:

1. For old-style class instances, both help(i) and help(type(i)) give the help 
for the instance type, which is highly unhelpful IMO. Otherwise it seems than 
both C class instances and regular Python new-style class instances give the 
class doc for help(i). Summary: help(x) is good, help(type(x)) unnecessary.

2. 3. Magic methods are documented through docs.python.org and eventually ABCs, 
not docstrings. I see no reason to make an exception for __init__, except if 
removing its docstring breaks code.

4. There are actually two typos ;) Regarding parens, I personally think it’s 
not helpful to always put them, since e.g. “len()” is not valid, but my choice 
is not Python’s.

----------
nosy: +merwok

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

Reply via email to