Message242005
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. |
|
Date |
User |
Action |
Args |
2015-04-25 07:50:47 | ncoghlan | set | recipients:
+ ncoghlan, eric.araujo, Claudiu.Popa, ethan.furman, python-dev, eric.snow, martin.panter, serhiy.storchaka, yselivanov |
2015-04-25 07:50:46 | ncoghlan | set | messageid: <1429948246.99.0.110236234657.issue15582@psf.upfronthosting.co.za> |
2015-04-25 07:50:46 | ncoghlan | link | issue15582 messages |
2015-04-25 07:50:46 | ncoghlan | create | |
|