Explain that __init__() methods do not get to return values.

freddrake · freddrake · commit 044bb4d22a20 · 2001-08-02T15:53:05.000Z
diff --git a/Doc/ref/ref3.tex b/Doc/ref/ref3.tex
@@ -892,14 +892,15 @@ \section{Special method names\label{specialnames}}
 
 \subsection{Basic customization\label{customization}}
 
-\begin{methoddesc}[object]{__init__}{self\optional{, args...}}
-Called when the instance is created.  The arguments are those passed
-to the class constructor expression.  If a base class has an
-\method{__init__()} method the derived class's \method{__init__()} method must
-explicitly call it to ensure proper initialization of the base class
-part of the instance, e.g., \samp{BaseClass.__init__(\var{self},
-[\var{args}...])}.
-\indexii{class}{constructor}
+\begin{methoddesc}[object]{__init__}{self\optional{, \moreargs}}
+Called\indexii{class}{constructor} when the instance is created.  The
+arguments are those passed to the class constructor expression.  If a
+base class has an \method{__init__()} method the derived class's
+\method{__init__()} method must explicitly call it to ensure proper
+initialization of the base class part of the instance; for example:
+\samp{BaseClass.__init__(\var{self}, [\var{args}...])}.  As a special
+contraint on constructors, no value may be returned; doing so will
+cause a \exception{TypeError} to be raised at runtime.
 \end{methoddesc}
 
 
