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

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



From: "Junio C Hamano" <gitster@xxxxxxxxx>
Sent: Friday, February 08, 2013 10:54 PM
"Philip Oakley" <philipoakley@xxxxxxx> 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.

I'll sort some patches early next week (the weekend's committed elsewhere)


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.

OK, I'll limit the the follow-ons to just an extra --guides option (probably just a list of the common guides initially), and leave --all(-a) for just the commands.


--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Kernel Development]     [Gcc Help]     [IETF Annouce]     [DCCP]     [Netdev]     [Networking]     [Security]     [V4L]     [Bugtraq]     [Yosemite]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Linux SCSI]     [Fedora Users]