From 044bb4d22a20a172edc58dd7eed5f72428d2cc16 Mon Sep 17 00:00:00 2001
From: Fred Drake <fdrake@acm.org>
Date: Thu, 2 Aug 2001 15:53:05 +0000
Subject: [PATCH] Explain that __init__() methods do not get to return values.

---
 Doc/ref/ref3.tex | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/Doc/ref/ref3.tex b/Doc/ref/ref3.tex
index 9074a0b061..97c03f8756 100644
--- a/Doc/ref/ref3.tex
+++ b/Doc/ref/ref3.tex
@@ -892,14 +892,15 @@ extracting a slice may not make sense.  (One example of this is the
 
 \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}
 
 
-- 
2.40.0