Re: [PATCH] notes: attach help text to subcommands

On Fri, Jun 8, 2012 at 6:34 PM, Ramkumar Ramachandra [off-list ref] wrote:

Hi Jonathan and Felipe,

Jonathan Nieder wrote:

quoted

Ramkumar Ramachandra wrote:

quoted

 Thanks.  I wish we could do something aout USAGE_OPTS_WIDTH and
 USAGE_GAP; I stole them from parse-options.

Expose them in parse-options.h?  Or put this functionality in a
parseopt-related file?

Exposing a `subcommand_usage` in parse-options.h may not be a bad idea.

Felipe Contreras wrote:

quoted

There's many commands that would benefit from this. In addition to
provide a better help for subcommands, this can be used to generate
automatically the shell completion list of subcommands.

Even more; in zsh it would be possible to show this help text directly
in the completion.

How exactly is that going to work?  `git notes -h` doesn't output
this- so the only way to get this output is to invoke `git notes` with
an invalid subcommand.  To fix that, I'd have to teach parse-options
about subcommands.

Yeah, something like that. See this proposal:

http://mid.gmane.org/1334140165-24958-2-git-send-email-bebarino@gmail.com

I would prefer something like 'git info --subcommands notes' or
something like that.

Cheers.

-- 
Felipe Contreras