What should Python apps do when asked to show help?

Random832 random832 at fastmail.com
Thu Apr 28 15:51:25 EDT 2016


On Thu, Apr 28, 2016, at 15:39, Grant Edwards wrote:
> That's fine.  If you want two or three forms of documentation then you
> prepare two or three forms of documentation.
> 
> Adding an option to run the default 'help' output through a pager or
> display it in a web browser doesn't somehow force you "to compose two
> forms of documentation" unless you want two forms of documentation.

The point is that having "help" output at all (beyond either a cursory
"see the manpage") implies two forms of documentation (given you already
have a manpage), and some people choose not to do that, instead
launching directly into the manpage (which implies using a pager)



More information about the Python-list mailing list