From: Junio C Hamano Date: Tue, 20 Oct 2015 22:22:40 +0000 (-0700) Subject: Merge branch 'jc/doc-gc-prune-now' into maint X-Git-Tag: v2.6.3~33 X-Git-Url: https://git.lorimer.id.au/gitweb.git/diff_plain/ce555f38426e212ced5f2445bc6df1351af21cab?hp=44a9b53c599447a706dd4ae8a00fd8b4bed093b9 Merge branch 'jc/doc-gc-prune-now' into maint "git gc" is safe to run anytime only because it has the built-in grace period to protect young objects. In order to run with no grace period, the user must make sure that the repository is quiescent. * jc/doc-gc-prune-now: Documentation/gc: warn against --prune= --- diff --git a/Documentation/git-gc.txt b/Documentation/git-gc.txt index 52234987f9..fa1510480a 100644 --- a/Documentation/git-gc.txt +++ b/Documentation/git-gc.txt @@ -63,8 +63,11 @@ automatic consolidation of packs. --prune=:: Prune loose objects older than date (default is 2 weeks ago, overridable by the config variable `gc.pruneExpire`). - --prune=all prunes loose objects regardless of their age. - --prune is on by default. + --prune=all prunes loose objects regardless of their age (do + not use --prune=all unless you know exactly what you are doing. + Unless the repository is quiescent, you will lose newly created + objects that haven't been anchored with the refs and end up + corrupting your repository). --prune is on by default. --no-prune:: Do not prune any loose objects.