From: Raymond Hettinger Date: Mon, 16 Feb 2009 22:42:54 +0000 (+0000) Subject: Issue 5229: Documentation for super() neglects to say what super() actually does X-Git-Tag: v2.7a1~2007 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=fd04870a3dc9c8d2695957e2ee6079411dd6fd90;p=python Issue 5229: Documentation for super() neglects to say what super() actually does --- diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index bd7130938c..7f5fa3ab2f 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1166,7 +1166,11 @@ available. They are listed here in alphabetical order. .. function:: super(type[, object-or-type]) - Return a "super" object that acts like the superclass of *type*. + Return a proxy object that delegates method calls to a parent class of + *type*. This is useful for accessing inherited methods that have been + overriden in a child class. The search order for parent classes is + determined by the ``__mro__`` attribute of the *type* and can change + whenever the parent classes are updated. If the second argument is omitted the super object returned is unbound. If the second argument is an object,