Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #107994

Re: What should Python apps do when asked to show help?

Show key headers only | View raw

On 5/1/2016 9:48 PM, Steven D'Aprano wrote:
> On Mon, 2 May 2016 03:04 am, Grant Edwards wrote:
>
>> On 2016-05-01, Steven D'Aprano <steve@pearwood.info> wrote:
>>> On Mon, 2 May 2016 02:30 am, Grant Edwards wrote:
>>>
>>>>> In discussions like these, it would be important to draw from
>>>>> precedents. Are there commands that have such an option?
>>>>
>>>> It's pretty rare.  It is assumed that Unix uses can type " | less"
>>>
>>> Is nobody except me questioning the assumption that we're only
>>> talking about Unix users?
>>
>> Didn't the OP specify that he was writing a command-line utility for
>> Linux/Unix?
>
> *cough* I'm the OP, and no I didn't.
>
> Obviously I'm a Linux user myself, but I'm presumptuous enough to hope that
> when I release the utility publicly[1], others may find it of some small
> use. Including Windows users.
>
> [1] Real Soon Now.

As a Windows user in recent years, I expect -h to give me a list of 
options, hopefully with some annotation beyond the bare bones, that give 
the signature of the command (regarding it as a function call).  'python 
-h' is pretty bare bones.  'python -m test -h' is much better.  I expect 
both to tell me how to properly pass a file argument.  I don't expect 
either to tell me how write a python or unittest file.  I use the manual 
for this.

-- 
Terry Jan Reedy

Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar | Unroll thread

Thread

Re: What should Python apps do when asked to show help? Grant Edwards <grant.b.edwards@gmail.com> - 2016-05-01 13:53 +0000
  Re: What should Python apps do when asked to show help? Marko Rauhamaa <marko@pacujo.net> - 2016-05-01 18:08 +0300
    Re: What should Python apps do when asked to show help? Grant Edwards <grant.b.edwards@gmail.com> - 2016-05-01 16:30 +0000
      Re: What should Python apps do when asked to show help? Steven D'Aprano <steve@pearwood.info> - 2016-05-02 02:36 +1000
        Re: What should Python apps do when asked to show help? Grant Edwards <grant.b.edwards@gmail.com> - 2016-05-01 17:04 +0000
          Re: What should Python apps do when asked to show help? Steven D'Aprano <steve@pearwood.info> - 2016-05-02 11:48 +1000
            Re: What should Python apps do when asked to show help? Terry Reedy <tjreedy@udel.edu> - 2016-05-02 02:34 -0400
        Re: What should Python apps do when asked to show help? Gene Heskett <gheskett@wdtv.com> - 2016-05-01 13:09 -0400
        Re: What should Python apps do when asked to show help? Random832 <random832@fastmail.com> - 2016-05-01 13:49 -0400
        Re: What should Python apps do when asked to show help? Ethan Furman <ethan@stoneleaf.us> - 2016-05-01 10:54 -0700

csiph-web