This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ncoghlan
Recipients Claudiu.Popa, eric.araujo, eric.snow, ethan.furman, martin.panter, ncoghlan, python-dev, serhiy.storchaka, yselivanov
Date 2015-04-25.07:50:46
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1429948246.99.0.110236234657.issue15582@psf.upfronthosting.co.za>
In-reply-to
Content
Yes, this was a deliberate change to "flip the default" as to which subclasses get bad docstring behaviour.

In the status quo, if you provide a subclass method which does basically the same thing as the parent class, you lose the docstring unless you duplicate it, meaning you have to choose between bad docstrings and a maintainability problem due to content duplication.

With this change, you only need a custom docstring in the subclass if you've changed the method behaviour enough that the parent class docstring no longer makes any sense.

If you just want to suppress the docstring entirely, then you'll need to specify an empty docstring.

This is potentially worth a note in the "Porting to Python 3.5" section of the What's New document, but it's an intended consequence of the change.
History
Date User Action Args
2015-04-25 07:50:47ncoghlansetrecipients: + ncoghlan, eric.araujo, Claudiu.Popa, ethan.furman, python-dev, eric.snow, martin.panter, serhiy.storchaka, yselivanov
2015-04-25 07:50:46ncoghlansetmessageid: <1429948246.99.0.110236234657.issue15582@psf.upfronthosting.co.za>
2015-04-25 07:50:46ncoghlanlinkissue15582 messages
2015-04-25 07:50:46ncoghlancreate