From: Jakub Narebski Date: Wed, 03 Dec 2008 00:47:56 GMT Subject: Re: [PATCH] Modified the default git help message to be grouped by topic Message-ID: In-Reply-To: <7vfxl6m84g.fsf@gitster.siamese.dyndns.org> Junio C Hamano wrote: > Jeff King writes: > >> On Tue, Dec 02, 2008 at 11:55:03PM +0100, Johannes Schindelin wrote: >> >>> If the whole thing gets longer than 24 lines, we have to leave some things >>> out.  Personally, I consider rm and mv unimportant enough that they could >>> be shown in an extended list, but be left out of the summary page. >> >> For the record, the current output is 26 lines, plus you probably want >> to account for 1 line of the user's next shell prompt. So we are 3 lines >> over already. >> >> Scott's proposal is about grouping the commands more sensibly. Many of >> the complaints are about the length of the output. Maybe we should scrap >> having a list of commands altogether and just point at section-specific >> documentation, each of which could discuss basic commands related to it. >> >> I think there has been mention of task-oriented documentation pointers >> before, and I think this is a place where we would want it. > > It might not be a bad idea to make this "top page help" into an > interactive hierarchical help topic browser. Isn't that info? -- Jakub Narebski Warsaw, Poland ShadeHawk on #git