Re: [PATCH] Add commands that git-gc runs underneath

From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Aug 30, 2007, 11:58 UTC
Message-ID: <Pine.LNX.4.64.0708301254420.28586@racer.site>
In-Reply-To: <46D6984D.9040802@op5.se>

Hi,

On Thu, 30 Aug 2007, Andreas Ericsson wrote:

> I kinda like it [listing the commands git-gc calls], and it might be 
> helpful if someone's got a large repo and one part of gc for some reason 
> didn't complete so they want to start at whatever step it broke off on.

Let me clarify: I do not like the listing in the man page. This suggests to the user to delve into plumbing areas where it is all too easy to shoot yourself in the foot.

I have nothing against listing the commands per se. But the man page is too exposed IMHO. (Or would you like to add the original shell script to git-log's man page, too?)

My preferred location would be somewhere near Documentation/technical/, so that people reading the commands are more likely to understand the consequences.

But maybe I'm wrong.

Ciao, Dscho