Author martin.panter
Recipients Claudiu.Popa, eric.araujo, eric.snow, ethan.furman, martin.panter, ncoghlan, python-dev, serhiy.storchaka, yselivanov
Date 2015-04-19.06:23:33
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1429424614.05.0.227766877394.issue15582@psf.upfronthosting.co.za>
In-reply-to
Content
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.
History
Date User Action Args
2015-04-19 06:23:34martin.pantersetrecipients: + martin.panter, ncoghlan, eric.araujo, Claudiu.Popa, ethan.furman, python-dev, eric.snow, serhiy.storchaka, yselivanov
2015-04-19 06:23:34martin.pantersetmessageid: <1429424614.05.0.227766877394.issue15582@psf.upfronthosting.co.za>
2015-04-19 06:23:34martin.panterlinkissue15582 messages
2015-04-19 06:23:33martin.pantercreate