`super` builtin class

[dongbohu]

Documentation

I found the leading sentence in this paragraph a little misleading:

cpython/Doc/library/functions.rst

Line 1961 in ec89620

The :attr:`~class.__mro__` attribute of the *object_or_type* lists the method

because if the object_or_type is an object, it won't have __mro__ attribute. The attribute should be object.__class__.__mro__.

On the other hand, if object_or_type is a type (class), then __mro__ attribute does exist.

Linked PRs

• gh-123207: Clarify the documentation for the mro lookup for super() #123417
• [3.13] gh-123207: Clarify the documentation for the mro lookup for super() (GH-123417) #123732
• [3.12] gh-123207: Clarify the documentation for the mro lookup for super() (GH-123417) #123733

[eendebakpt]

@dongbohu I agree it is a bit confusing. Maybe we can reformulate to something like

The :attr:~class.__mro__ attribute of the class corresponding to object_or_type lists the method ...

Maybe there are better suggestions, otherwise I will open a PR with this suggestion.

[dongbohu]

@eendebakpt: I think your proposed wording is much better. Thank you!