[issue20467] Confusing wording about __init__

[Mark Lawrence]

New submission from Mark Lawrence:

I found the wording here http://docs.python.org/3/reference/datamodel.html#object.__init__ very confusing as it implies that __init__ is the class constructor and not the initialiser.  Specifically it says "As a special constraint on constructors, no value may be returned; doing so will cause a TypeError to be raised at runtime".  Can we please have the wording changed so that it states exactly what this method does?  Possibly changes are also needed in the equivalent section for __new__.

----------
assignee: docs at python
components: Documentation
messages: 209843
nosy: BreamoreBoy, docs at python
priority: normal
severity: normal
status: open
title: Confusing wording about __init__
type: enhancement
versions: Python 2.7, Python 3.3, Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue20467>
_______________________________________