summaryrefslogtreecommitdiffstats
path: root/Doc/library/functions.rst
diff options
context:
space:
mode:
authorRaymond Hettinger <python@rcn.com>2009-02-16 22:42:54 (GMT)
committerRaymond Hettinger <python@rcn.com>2009-02-16 22:42:54 (GMT)
commitfd04870a3dc9c8d2695957e2ee6079411dd6fd90 (patch)
tree139f5ac8a1188bf433f6082a835e20ca20d0afc0 /Doc/library/functions.rst
parentf1c95fe004d3cb35f59175a446d2caba55a8a399 (diff)
downloadcpython-fd04870a3dc9c8d2695957e2ee6079411dd6fd90.zip
cpython-fd04870a3dc9c8d2695957e2ee6079411dd6fd90.tar.gz
cpython-fd04870a3dc9c8d2695957e2ee6079411dd6fd90.tar.bz2
Issue 5229: Documentation for super() neglects to say what super() actually does
Diffstat (limited to 'Doc/library/functions.rst')
-rw-r--r--Doc/library/functions.rst6
1 files changed, 5 insertions, 1 deletions
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,