Re: [PATCH] Modified the default git help message to be grouped by topic

From: Jeff King <peff@peff.net>
Date: Dec 1, 2008, 18:32 UTC
Message-ID: <20081201183258.GB24443@coredump.intra.peff.net>
In-Reply-To: <20081201173037.GA41967@agadorsparticus>

On Mon, Dec 01, 2008 at 09:30:37AM -0800, Scott Chacon wrote:

> It's difficult to process 21 commands (which is what is output
> by default for git when no command is given).  I've re-grouped
> them into 4 groups of 5 or 6 commands each, which I think is
> clearer and easier for new users to process.

I like it (and I think the categorizations look reasonable, which is something that I recall caused some discussion at the GitTogether).

The only downside I see is that we're now >24 lines.

> This won't automatically update with the common-commands.txt file,
> but I think it is easier to parse for the command you may be looking
> for.

Personally, I don't see a big problem. This is not a list that should change very frequently, and there is extra information here that would be annoying to encode in the list. But since the "common" flag in command-list.txt and the common-cmds.h file would no longer be used, they should probably be removed.

-Peff