Sometimes the doc string for the overridden method does not make much sense in the context of the subclass. Just wondering if this was considered; it seems like a fairly serious downside to this new feature. E.g. in a package I am reviewing, there is a class that inherits HTMLParser and converts HTML to PDF. There is no doc string, so previously there was just the signature in the “pydoc” output. Now the output looks like:

 |  __init__(self, pdf, image_map=None)
 |      Initialize and reset this instance.
 |      
 |      If convert_charrefs is True (the default), all character references
 |      are automatically converted to the corresponding Unicode characters.

The second paragraph mentions parameters and settings of the internal base class, which doesn’t make much sense for the subclass.