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 eric.araujo
Recipients belopolsky, docs@python, eric.araujo, georg.brandl, mark.dickinson
Date 2010-06-12.19:54:57
SpamBayes Score 0.00055005774
Marked as misclassified No
Message-id <1276372499.2.0.92561270725.issue8983@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2010-06-12 19:54:59eric.araujosetrecipients: + eric.araujo, georg.brandl, mark.dickinson, belopolsky, docs@python
2010-06-12 19:54:59eric.araujosetmessageid: <1276372499.2.0.92561270725.issue8983@psf.upfronthosting.co.za>
2010-06-12 19:54:57eric.araujolinkissue8983 messages
2010-06-12 19:54:57eric.araujocreate