Re: [PATCH 1/3] gc.txt: more details about what gc does
- Date: Sat, 3 Mar 2018 04:14:16 -0500
- From: Eric Sunshine <sunshine@xxxxxxxxxxxxxx>
- Subject: Re: [PATCH 1/3] gc.txt: more details about what gc does
On Fri, Mar 2, 2018 at 10:39 PM, Nguyễn Thái Ngọc Duy <pclouds@xxxxxxxxx> wrote:
> Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@xxxxxxxxx>
> diff --git a/Documentation/git-gc.txt b/Documentation/git-gc.txt
> @@ -15,8 +15,9 @@ DESCRIPTION
> Runs a number of housekeeping tasks within the current repository,
> such as compressing file revisions (to reduce disk space and increase
> -performance) and removing unreachable objects which may have been
> -created from prior invocations of 'git add'.
> +performance), removing unreachable objects which may have been
> +created from prior invocations of 'git add', packing refs, pruning
> +reflog, rerere or stale working trees.
> Users are encouraged to run this task on a regular basis within
> each repository to maintain good disk space utilization and good
> @@ -59,6 +60,10 @@ then existing packs (except those marked with a `.keep` file)
> are consolidated into a single pack by using the `-A` option of
> 'git repack'. Setting `gc.autoPackLimit` to 0 disables
> automatic consolidation of packs.
> +If `git gc --auto` goes ahead because of either too loose objects or
> +packs, all other housekeeping tasks (e.g. rerere, working trees,
> +reflog...) will also be be performed.
Perhaps this new paragraph should be moved up by one paragraph; the
result feels a bit more cohesive.
If `git gc --auto` finds that housekeeping is required due to too
many loose objects or packs, all other housekeeping tasks (e.g.
rerere, working trees, reflog...) will be performed, as well.
> @@ -133,6 +138,9 @@ The optional configuration variable `gc.pruneExpire` controls how old
> the unreferenced loose objects have to be before they are pruned. The
> default is "2 weeks ago".
> +The optional gc.worktreePruneExpire controls how old a stale working
> +tree before `git worktree prune` deletes it. The default is "3 months
Missing backticks around "gc.worktreePruneExpire".
s/tree before/tree should be before/
You lost a blank line before the "Notes" section.
With minor fixes:
Optional configuration variable `gc.worktreePruneExpire` controls
how old a stale working tree should be before `git worktree prune`
deletes it. Default is "3 months ago".