kernel
/
git
mirror of https://git.kernel.org/pub/scm/git/git.git
1
0
Fork 0
Code Releases Activity

Documentation/config: mention "now" and "never" for 'expire' settings 

In addition to approxidate-style values ("2.months.ago", "yesterday"),
consumers of 'gc.*expire*' configuration variables also accept and
respect 'now' ("do it immediately") and 'never' ("suppress entirely").

Suggested-by: Michael Haggerty <mhagger@alum.mit.edu>
Signed-off-by: Eric Sunshine <sunshine@sunshineco.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
Eric Sunshine 2015-07-28 16:06:10 -04:00 committed by Junio C Hamano
parent 5f5f553fd5
commit 8cc88166c0
1 changed files with 11 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
Documentation/config.txt
View File

@ -1227,19 +1227,23 @@ gc.pruneexpire::
When 'git gc' is run, it will call 'prune --expire 2.weeks.ago'. When 'git gc' is run, it will call 'prune --expire 2.weeks.ago'.
Override the grace period with this config variable. The value Override the grace period with this config variable. The value
"now" may be used to disable this grace period and always prune "now" may be used to disable this grace period and always prune
unreachable objects immediately. unreachable objects immediately, or "never" may be used to
suppress pruning.


gc.worktreePruneExpire:: gc.worktreePruneExpire::
When 'git gc' is run, it calls When 'git gc' is run, it calls
'git worktree prune --expire 3.months.ago'. 'git worktree prune --expire 3.months.ago'.
This config variable can be used to set a different grace This config variable can be used to set a different grace
period. The value "now" may be used to disable the grace period. The value "now" may be used to disable the grace
period and prune $GIT_DIR/worktrees immediately. period and prune $GIT_DIR/worktrees immediately, or "never"
may be used to suppress pruning.


gc.reflogexpire:: gc.reflogexpire::
gc.<pattern>.reflogexpire:: gc.<pattern>.reflogexpire::
'git reflog expire' removes reflog entries older than 'git reflog expire' removes reflog entries older than
this time; defaults to 90 days. With "<pattern>" (e.g. this time; defaults to 90 days. The value "now" expires all
entries immediately, and "never" suppresses expiration
altogether. With "<pattern>" (e.g.
"refs/stash") in the middle the setting applies only to "refs/stash") in the middle the setting applies only to
the refs that match the <pattern>. the refs that match the <pattern>.


@ -1247,7 +1251,9 @@ gc.reflogexpireunreachable::
gc.<ref>.reflogexpireunreachable:: gc.<ref>.reflogexpireunreachable::
'git reflog expire' removes reflog entries older than 'git reflog expire' removes reflog entries older than
this time and are not reachable from the current tip; this time and are not reachable from the current tip;
defaults to 30 days. With "<pattern>" (e.g. "refs/stash") defaults to 30 days. The value "now" expires all entries
immediately, and "never" suppresses expiration altogether.
With "<pattern>" (e.g. "refs/stash")
in the middle, the setting applies only to the refs that in the middle, the setting applies only to the refs that
match the <pattern>. match the <pattern>.