Re: [PATCH] git.c: show usage for accessing the git(1) help page
- Date: Tue, 14 May 2019 17:17:17 -0700
- From: Emily Shaffer <emilyshaffer@xxxxxxxxxx>
- Subject: Re: [PATCH] git.c: show usage for accessing the git(1) help page
On Tue, May 14, 2019 at 04:24:50PM +0100, Philip Oakley wrote:
> It is not immediately obvious how to use the `git help` system
> to show the git(1) page, with all its background and ccordinating
> material, such as environment variables.
> Let's simply list it as the last few words of the last usage line.
> Signed-off-by: Philip Oakley <philipoakley@xxxxxxx>
> This follows from the discussion <3cd065d1-9db5-f2e6-ddff-aa539746d45e@xxxxxxx>
> git.c | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
> diff --git a/git.c b/git.c
> index 2324ac0b7e..9a852b09c1 100644
> --- a/git.c
> +++ b/git.c
> @@ -33,7 +33,7 @@ const char git_usage_string =
> const char git_more_info_string =
> N_("'git help -a' and 'git help -g' list available subcommands and some\n"
> "concept guides. See 'git help <command>' or 'git help <concept>'\n"
> - "to read about a specific subcommand or concept.");
> + "to read about a specific subcommand or concept. Or use 'git help git'.");
I'm not sure the wording makes sense here. It sounds like you're saying,
"Or use 'git help git' to read about specific subcommands or concepts."
which isn't really what I think you're trying to say.
What about, "Or, use 'git help git' for a detailed guide of the Git
system as a whole."
(I'm still not sure that's quite it - since `git help git` mostly
details the flags you can pass to git before invoking a subcommand. But
I'm not sure that `git --help` is the place to say that...)
> static int use_pager = -1;