homepage

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.