From: Junio C Hamano <gitster@pobox.com>
Date: Fri, 08 Feb 2013 22:54:50 GMT
Subject: Re: Improve 'git help' with basic user guide linkss
Message-ID: <7v6222za9x.fsf@alter.siamese.dyndns.org>
In-Reply-To: <6BC280F5827C4098BCB6276232DDE8E4@PhilipOakley>

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

> 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.