From fd04870a3dc9c8d2695957e2ee6079411dd6fd90 Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Mon, 16 Feb 2009 22:42:54 +0000 Subject: Issue 5229: Documentation for super() neglects to say what super() actually does --- Doc/library/functions.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index bd71309..7f5fa3a 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, -- cgit v0.12