Re: [PATCH 1/1] show-ref: improve short help messages of options

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Patrick Steinhardt <ps@xxxxxx> writes:

> Agreed, I think that this is a sensible change. In practice, this
> feature can also be combined with `--head`, so in that spirit we might
> even change it to:
>
>     "only show tags (can be combined with --branches and --head)"
>
> Not sure though whether this is getting too noisy?

It is somewhat an oxymoron that "*only* show X" can be combined with
"*only* show Y" in the first place.

For a reader to accept it without finding it awkward, the reader
must understand that

 (1) the command shows by default everything, but

 (2) if any of these "only show" options are given, the command
     stops showing everything and the user can pick which subset of
     "only show" options to give, which work additively.

But if the reader knows that much already, it is redundant to say
"can be combined with", isn't it?

So, I dunno.




[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]

  Powered by Linux