gc: call "prune --expire 2.weeks.ago" by default
authorJohannes Schindelin <Johannes.Schindelin@gmx.de>
Wed, 12 Mar 2008 20:55:47 +0000 (21:55 +0100)
committerJunio C Hamano <gitster@pobox.com>
Thu, 13 Mar 2008 06:47:01 +0000 (23:47 -0700)
commit25ee9731c137d0a24b0f4879eb0b0cce9b77d5b0
tree28f94a286b4903b3c00f4154c7ad2f63bb9d104b
parentdbdbfec4413d24f9a423c3e2b86a002489f4acbb
gc: call "prune --expire 2.weeks.ago" by default

The only reason we did not call "prune" in git-gc was that it is an
inherently dangerous operation: if there is a commit going on, you will
prune loose objects that were just created, and are, in fact, needed by the
commit object just about to be created.

Since it is dangerous, we told users so.  That led to many users not even
daring to run it when it was actually safe. Besides, they are users, and
should not have to remember such details as when to call git-gc with
--prune, or to call git-prune directly.

Of course, the consequence was that "git gc --auto" gets triggered much
more often than we would like, since unreferenced loose objects (such as
left-overs from a rebase or a reset --hard) were never pruned.

Alas, git-prune recently learnt the option --expire <minimum-age>, which
makes it a much safer operation.  This allows us to call prune from git-gc,
with a grace period of 2 weeks for the unreferenced loose objects (this
value was determined in a discussion on the git list as a safe one).

If you want to override this grace period, just set the config variable
gc.pruneExpire to a different value; an example would be

[gc]
pruneExpire = 6.months.ago

or even "never", if you feel really paranoid.

Note that this new behaviour makes "--prune" be a no-op.

While adding a test to t5304-prune.sh (since it really tests the implicit
call to "prune"), also the original test for "prune --expire" was moved
there from t1410-reflog.sh, where it did not belong.

Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
Documentation/config.txt
Documentation/git-gc.txt
builtin-gc.c
t/t1410-reflog.sh
t/t5304-prune.sh