From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Thu, 30 Aug 2007 11:58:00 GMT
Subject: Re: [PATCH] Add commands that git-gc runs underneath
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