Re: [PATCH 5/8] git-gc --auto: add documentation.

From: Johannes Schindelin <johannes.schindelin@gmx.de>
Date: Sep 17, 2007, 09:36 UTC
Message-ID: <Pine.LNX.4.64.0709171031420.28586@racer.site>
In-Reply-To: <11900187073420-git-send-email-gitster@pobox.com>

Hi,

On Mon, 17 Sep 2007, Junio C Hamano wrote:

> +	When there are approximately more than this many loose
> +	objects in the repository, `git gc --auto` that is
> +	invoked by some Porcelain commands will create a new
> +	pack and prune them.

It might strike a newbie as dangerous to read "prune them" here.  Maybe

	... `git gc --auto` will pack the loose objects.  Some Porcelain 
	commands use this command, to do a light weight garbage collection
	from time to time.
+
*Note*: you should still run "git gc" from time to time, since the 
"--auto" option is designed to be fast, whereas "git gc" _without_ 
auto is designed to create small packs.

Hmm? (I think that this is the most visible part of the --auto business, so I would document the "git gc" note here...)

Ciao, Dscho