[PATCH 8 of 8 v2] help: mark boolean flags with a ^ and explain that they can be negated (RFC)
Augie Fackler
raf at durin42.com
Wed Aug 31 13:10:11 EDT 2016
On Wed, Aug 31, 2016 at 12:13 PM, Matt Mackall <mpm at selenic.com> wrote:
> On Tue, 2016-08-30 at 16:16 -0400, Augie Fackler wrote:
>> # HG changeset patch
>> # User Augie Fackler <augie at google.com>
>> # Date 1472584444 14400
>> # Tue Aug 30 15:14:04 2016 -0400
>> # Node ID 5efc13a760938ff5fd8e4553dd8e06d06b98025b
>> # Parent fd68fb86c29873eb32c4a2bd28f7ac0abe3dc172
>> help: mark boolean flags with a ^ and explain that they can be negated (RFC)
>
>
>> options ([+] can be repeated, flags marked ^ can be negated with --no-):
>
> The format here is a bit inconsistent. Perhaps:
>
> options ([+] can be repeated, [?] are flags):
>
> I think actually sticking ^ on the option name itself is a little bizarre and
> might lead to some minor confusion.
>
> Also, we should probably figure out a way to have aliases for some of these
> options so we can fully normalize the scheme. Consider:
>
>> + -y --noninteractive^ do not prompt, automatically pick the first choice
>
> Having --no-noninteractive seems really sad. We could make --noninteractive
> hidden and then advertise --no-interactive as the long version.
>
> Also, I don't think --no-no-backup is a good idea. --backup should be its
> negation.
These cases are a bit problematic, because we don't really have a way
to specify default-true flags. Would it be good enough to blacklist
anything that starts with no- and noninteractive for now?
>
>> + --version^ output version information and exit
>> + -h --help^ display help and exit
>
> Wat. That's maybe a little too generalized.
Heh. Yeah. I can blacklist specific flags, I guess.
>
> --
> Mathematics is the supreme nostalgia of our time.
>
More information about the Mercurial-devel
mailing list