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 veky
Recipients gvanrossum, levkivskyi, ncoghlan, serhiy.storchaka, veky, yselivanov
Date 2020-04-12.05:16:07
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1586668567.45.0.510309162163.issue40257@roundup.psfhosted.org>
In-reply-to
Content
I don't agree with 1. I use that feature a lot, I write a base class which my students must subclass to their liking, but they still expect that help(TheirClass) will give them the documentation they need.

I agree that in _some_ cases it is not helpful (but even when the base is abstract, it might be helpful). How about: we keep the current behavior, but make it clear that the docstring applies to a superclass? It might be subtle, as just changing the first line of help() output (currently it says "Help on class Derived in module ...", change it to "Help on class Base in module ..."), or write a longer message such as "Documentation for Derived not found, showing the documentation for Base". But just removing it in all cases is really a wrong thing to do.
History
Date User Action Args
2020-04-12 05:16:07vekysetrecipients: + veky, gvanrossum, ncoghlan, serhiy.storchaka, yselivanov, levkivskyi
2020-04-12 05:16:07vekysetmessageid: <1586668567.45.0.510309162163.issue40257@roundup.psfhosted.org>
2020-04-12 05:16:07vekylinkissue40257 messages
2020-04-12 05:16:07vekycreate