Author ncoghlan
Recipients Cubky, CuriousLearner, Devin Jeanpierre, eric.araujo, ezio.melotti, jairotrad, jbitcm-, mikehoy, ncoghlan, r.david.murray, terry.reedy
Date 2017-02-19.06:27:20
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1487485641.26.0.0437475733934.issue13691@psf.upfronthosting.co.za>
In-reply-to
Content
Recapping the situations that need test cases before this can be merged:

* behaviour when "help" is entered at the interactive help prompt (as the current behaviour is correct and should *not* change)
* behaviour when calling "help(help)"
* behaviour when calling "help('help')"
* behaviour when running "python3 -m pydoc help"

In the latter 3 cases, the default site._Helper docs currently shown are not particularly helpful.

It does make me wonder whether it might be worth defining a __help__ magic method that completely overrides what help(obj) displays. It would limit the fix to 3.7+, but it would make it possible to do this cleanly just by defining __help__ on site._Helper.
History
Date User Action Args
2017-02-19 06:27:21ncoghlansetrecipients: + ncoghlan, terry.reedy, Devin Jeanpierre, ezio.melotti, eric.araujo, r.david.murray, mikehoy, jbitcm-, Cubky, jairotrad, CuriousLearner
2017-02-19 06:27:21ncoghlansetmessageid: <1487485641.26.0.0437475733934.issue13691@psf.upfronthosting.co.za>
2017-02-19 06:27:21ncoghlanlinkissue13691 messages
2017-02-19 06:27:20ncoghlancreate