config.txt: move gc.* to a separate file
Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Nguyễn Thái Ngọc Duy committed
Oct 27, 2018 at 08:22 UTC
8daf3271f358ed55e8e07c5476c5a15f0e6cbf7d
2 files changed
+109
-108
Documentation/config.txt
+1
-108
@@ -333,114 +333,7 @@ include::config/filter.txt[]
333
334
include::config/fsck.txt[]
335
336
-gc.aggressiveDepth::
337
- The depth parameter used in the delta compression
338
- algorithm used by 'git gc --aggressive'. This defaults
339
- to 50.
340
-
341
-gc.aggressiveWindow::
342
- The window size parameter used in the delta compression
343
- algorithm used by 'git gc --aggressive'. This defaults
344
- to 250.
345
-
346
-gc.auto::
347
- When there are approximately more than this many loose
348
- objects in the repository, `git gc --auto` will pack them.
349
- Some Porcelain commands use this command to perform a
350
- light-weight garbage collection from time to time. The
351
- default value is 6700. Setting this to 0 disables it.
352
-
353
-gc.autoPackLimit::
354
- When there are more than this many packs that are not
355
- marked with `*.keep` file in the repository, `git gc
356
- --auto` consolidates them into one larger pack. The
357
- default value is 50. Setting this to 0 disables it.
358
-
359
-gc.autoDetach::
360
- Make `git gc --auto` return immediately and run in background
361
- if the system supports it. Default is true.
362
-
363
-gc.bigPackThreshold::
364
- If non-zero, all packs larger than this limit are kept when
365
- `git gc` is run. This is very similar to `--keep-base-pack`
366
- except that all packs that meet the threshold are kept, not
367
- just the base pack. Defaults to zero. Common unit suffixes of
368
- 'k', 'm', or 'g' are supported.
369
-+
370
-Note that if the number of kept packs is more than gc.autoPackLimit,
371
-this configuration variable is ignored, all packs except the base pack
372
-will be repacked. After this the number of packs should go below
373
-gc.autoPackLimit and gc.bigPackThreshold should be respected again.
374
-
375
-gc.writeCommitGraph::
376
- If true, then gc will rewrite the commit-graph file when
377
- linkgit:git-gc[1] is run. When using linkgit:git-gc[1]
378
- '--auto' the commit-graph will be updated if housekeeping is
379
- required. Default is false. See linkgit:git-commit-graph[1]
380
- for details.
381
-
382
-gc.logExpiry::
383
- If the file gc.log exists, then `git gc --auto` will print
384
- its content and exit with status zero instead of running
385
- unless that file is more than 'gc.logExpiry' old. Default is
386
- "1.day". See `gc.pruneExpire` for more ways to specify its
387
- value.
388
-
389
-gc.packRefs::
390
- Running `git pack-refs` in a repository renders it
391
- unclonable by Git versions prior to 1.5.1.2 over dumb
392
- transports such as HTTP. This variable determines whether
393
- 'git gc' runs `git pack-refs`. This can be set to `notbare`
394
- to enable it within all non-bare repos or it can be set to a
395
- boolean value. The default is `true`.
396
-
397
-gc.pruneExpire::
398
- When 'git gc' is run, it will call 'prune --expire 2.weeks.ago'.
399
- Override the grace period with this config variable. The value
400
- "now" may be used to disable this grace period and always prune
401
- unreachable objects immediately, or "never" may be used to
402
- suppress pruning. This feature helps prevent corruption when
403
- 'git gc' runs concurrently with another process writing to the
404
- repository; see the "NOTES" section of linkgit:git-gc[1].
405
-
406
-gc.worktreePruneExpire::
407
- When 'git gc' is run, it calls
408
- 'git worktree prune --expire 3.months.ago'.
409
- This config variable can be used to set a different grace
410
- period. The value "now" may be used to disable the grace
411
- period and prune `$GIT_DIR/worktrees` immediately, or "never"
412
- may be used to suppress pruning.
413
-
414
-gc.reflogExpire::
415
-gc.<pattern>.reflogExpire::
416
- 'git reflog expire' removes reflog entries older than
417
- this time; defaults to 90 days. The value "now" expires all
418
- entries immediately, and "never" suppresses expiration
419
- altogether. With "<pattern>" (e.g.
420
- "refs/stash") in the middle the setting applies only to
421
- the refs that match the <pattern>.
422
-
423
-gc.reflogExpireUnreachable::
424
-gc.<pattern>.reflogExpireUnreachable::
425
- 'git reflog expire' removes reflog entries older than
426
- this time and are not reachable from the current tip;
427
- defaults to 30 days. The value "now" expires all entries
428
- immediately, and "never" suppresses expiration altogether.
429
- With "<pattern>" (e.g. "refs/stash")
430
- in the middle, the setting applies only to the refs that
431
- match the <pattern>.
432
-
433
-gc.rerereResolved::
434
- Records of conflicted merge you resolved earlier are
435
- kept for this many days when 'git rerere gc' is run.
436
- You can also use more human-readable "1.month.ago", etc.
437
- The default is 60 days. See linkgit:git-rerere[1].
438
-
439
-gc.rerereUnresolved::
440
- Records of conflicted merge you have not resolved are
441
- kept for this many days when 'git rerere gc' is run.
442
- You can also use more human-readable "1.month.ago", etc.
443
- The default is 15 days. See linkgit:git-rerere[1].
336
+include::config/gc.txt[]
337
338
include::gitcvs-config.txt[]
339
Documentation/config/gc.txt
new
+108
@@ -0,0 +1,108 @@
1
+gc.aggressiveDepth::
2
+ The depth parameter used in the delta compression
3
+ algorithm used by 'git gc --aggressive'. This defaults
4
+ to 50.
5
+
6
+gc.aggressiveWindow::
7
+ The window size parameter used in the delta compression
8
+ algorithm used by 'git gc --aggressive'. This defaults
9
+ to 250.
10
+
11
+gc.auto::
12
+ When there are approximately more than this many loose
13
+ objects in the repository, `git gc --auto` will pack them.
14
+ Some Porcelain commands use this command to perform a
15
+ light-weight garbage collection from time to time. The
16
+ default value is 6700. Setting this to 0 disables it.
17
+
18
+gc.autoPackLimit::
19
+ When there are more than this many packs that are not
20
+ marked with `*.keep` file in the repository, `git gc
21
+ --auto` consolidates them into one larger pack. The
22
+ default value is 50. Setting this to 0 disables it.
23
+
24
+gc.autoDetach::
25
+ Make `git gc --auto` return immediately and run in background
26
+ if the system supports it. Default is true.
27
+
28
+gc.bigPackThreshold::
29
+ If non-zero, all packs larger than this limit are kept when
30
+ `git gc` is run. This is very similar to `--keep-base-pack`
31
+ except that all packs that meet the threshold are kept, not
32
+ just the base pack. Defaults to zero. Common unit suffixes of
33
+ 'k', 'm', or 'g' are supported.
34
++
35
+Note that if the number of kept packs is more than gc.autoPackLimit,
36
+this configuration variable is ignored, all packs except the base pack
37
+will be repacked. After this the number of packs should go below
38
+gc.autoPackLimit and gc.bigPackThreshold should be respected again.
39
+
40
+gc.writeCommitGraph::
41
+ If true, then gc will rewrite the commit-graph file when
42
+ linkgit:git-gc[1] is run. When using linkgit:git-gc[1]
43
+ '--auto' the commit-graph will be updated if housekeeping is
44
+ required. Default is false. See linkgit:git-commit-graph[1]
45
+ for details.
46
+
47
+gc.logExpiry::
48
+ If the file gc.log exists, then `git gc --auto` will print
49
+ its content and exit with status zero instead of running
50
+ unless that file is more than 'gc.logExpiry' old. Default is
51
+ "1.day". See `gc.pruneExpire` for more ways to specify its
52
+ value.
53
+
54
+gc.packRefs::
55
+ Running `git pack-refs` in a repository renders it
56
+ unclonable by Git versions prior to 1.5.1.2 over dumb
57
+ transports such as HTTP. This variable determines whether
58
+ 'git gc' runs `git pack-refs`. This can be set to `notbare`
59
+ to enable it within all non-bare repos or it can be set to a
60
+ boolean value. The default is `true`.
61
+
62
+gc.pruneExpire::
63
+ When 'git gc' is run, it will call 'prune --expire 2.weeks.ago'.
64
+ Override the grace period with this config variable. The value
65
+ "now" may be used to disable this grace period and always prune
66
+ unreachable objects immediately, or "never" may be used to
67
+ suppress pruning. This feature helps prevent corruption when
68
+ 'git gc' runs concurrently with another process writing to the
69
+ repository; see the "NOTES" section of linkgit:git-gc[1].
70
+
71
+gc.worktreePruneExpire::
72
+ When 'git gc' is run, it calls
73
+ 'git worktree prune --expire 3.months.ago'.
74
+ This config variable can be used to set a different grace
75
+ period. The value "now" may be used to disable the grace
76
+ period and prune `$GIT_DIR/worktrees` immediately, or "never"
77
+ may be used to suppress pruning.
78
+
79
+gc.reflogExpire::
80
+gc.<pattern>.reflogExpire::
81
+ 'git reflog expire' removes reflog entries older than
82
+ this time; defaults to 90 days. The value "now" expires all
83
+ entries immediately, and "never" suppresses expiration
84
+ altogether. With "<pattern>" (e.g.
85
+ "refs/stash") in the middle the setting applies only to
86
+ the refs that match the <pattern>.
87
+
88
+gc.reflogExpireUnreachable::
89
+gc.<pattern>.reflogExpireUnreachable::
90
+ 'git reflog expire' removes reflog entries older than
91
+ this time and are not reachable from the current tip;
92
+ defaults to 30 days. The value "now" expires all entries
93
+ immediately, and "never" suppresses expiration altogether.
94
+ With "<pattern>" (e.g. "refs/stash")
95
+ in the middle, the setting applies only to the refs that
96
+ match the <pattern>.
97
+
98
+gc.rerereResolved::
99
+ Records of conflicted merge you resolved earlier are
100
+ kept for this many days when 'git rerere gc' is run.
101
+ You can also use more human-readable "1.month.ago", etc.
102
+ The default is 60 days. See linkgit:git-rerere[1].
103
+
104
+gc.rerereUnresolved::
105
+ Records of conflicted merge you have not resolved are
106
+ kept for this many days when 'git rerere gc' is run.
107
+ You can also use more human-readable "1.month.ago", etc.
108
+ The default is 15 days. See linkgit:git-rerere[1].