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 bd71309..7f5fa3a 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1166,7 +1166,11 @@
.. 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,