[docs] super() definition

[Rad]

Hi there!

the definition goes "Return a proxy object that delegates method calls to a
parent or sibling class of type."  (
https://docs.python.org/3/library/functions.html#super) it is misleading
since can read as a parent class of type OR a sibling class of type while
actually what it mean is "a parent or its sibling class ..." or perhaps
even more explicitly "a parent or a sibling of the parent ...". The same
problem with the last sentence of 5th paragraph: "(because the order of
calls is determined at runtime, because that order adapts to changes in the
class hierarchy, and because that order can include sibling classes that
are unknown prior to runtime)". It is not clear whose sibling it refers to.

Cheers!
Rad

Radomirs Cirskis MCDBA, MCAD C#, MCSD .NET C#, ZCE PHP5, MCSD VB6 ...
M: +64 221 221 442 | E: RAD at nowITworks.eu <rad at nowitworks.eu>
[image: View my profile on LinkedIn] <http://nz.linkedin.com/in/nad2000>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20161027/039898fd/attachment.html>