Re: Improve 'git help' with basic user guide linkss

From: Junio C Hamano <gitster@pobox.com>
Date: Feb 8, 2013, 22:54 UTC
Message-ID: <7v6222za9x.fsf@alter.siamese.dyndns.org>
In-Reply-To: <6BC280F5827C4098BCB6276232DDE8E4@PhilipOakley>

"Philip Oakley" <philipoakley@iee.org> writes:

Show 9 quoted lines

> My initial https://github.com/PhilipOakley/git/commit/e6217d simply
> updates
> -  N_("See 'git help <command>' for more information on a specific
> command.");
> +  N_("See 'git help <command>' for more information on a specific
> command.\n"
> +     "Or 'git help <guide>', such as 'tutorial' for an introduction
> to Git.");
> as a starter for the new users.

Yeah, that would be a good change to make to "git help<RETURN>" output.

> My view is that help --all (-a) is essentially incomplete as it
> currently doesn't provide all the help.

It has always been about "tell me all subcommands", not about "give me all the help you could give me". You are not adding a "help" subcommand to a system you wrote last week. Changing the semantics this late feels, eh, too late.