Consider making it clearer that --verbose is an option for the help subcommand itself

[scotje]

When using the basic help command, the way the --verbose option is currently presented can be a bit confusing for users:

$ mycommand help new

<snip>

OPTIONS FOR NEW
    -d --debug                     Enable debug output.
    -h --help                      Show help for this command.
    -v --verbose                   show more detailed help
       --version                   Show version of mycommand.

It would be clearer if --verbose was listed in it's own section labelled OPTIONS FOR HELP or something similar:

$ mycommand help new

<snip>

OPTIONS FOR NEW
    -d --debug                     Enable debug output.
    -h --help                      Show help for this command.

OPTIONS FOR HELP
    -v --verbose                   show more detailed help

[denisdefreyne]

Hey,

Which version of Cri does this happen in? 2.15.8 had a bug in it, which was rectified in 2.15.9 (see release notes).

I can’t reproduce the problem locally; do you have a test case?

[scotje]

Let me check again with 2.15.9 and see if I can still replicate the issue.

[scotje]

Yeah it looks like 2.15.9 resolves this. Is it expected then that the --verbose option is only ever listed in the (1 hidden command omitted; show it with --verbose) text that shows up when you hide something?

[denisdefreyne]

Is it expected then that the --verbose option is only ever listed in the (1 hidden command omitted; show it with --verbose) text that shows up when you hide something?

I don't quite understand what you mean. Can you rephrase? The --verbose option should always be visible in the help text.