Skip to content

Commit efc266e

Browse files
jrngitster
authored andcommitted
Documentation: git gc packs refs by default now
In commit 5675239 (Make "git gc" pack all refs by default, 2007-05-24), 'git gc' was changed to run pack-refs by default Versions before v1.5.1.2 cannot clone repos with packed refs over http, and versions before v1.4.4 cannot handled packed refs at all, but more recent git should have no problems. Try to make this more clear in the git-config manual. The analagous passage in git-gc.txt was updated already with commit fe2128a (Change git-gc documentation to reflect gc.packrefs implementation., 2008-01-09). Signed-off-by: Jonathan Nieder <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent dc89689 commit efc266e

File tree

1 file changed

+6
-9
lines changed

1 file changed

+6
-9
lines changed

Documentation/config.txt

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -875,15 +875,12 @@ gc.autopacklimit::
875875
default value is 50. Setting this to 0 disables it.
876876

877877
gc.packrefs::
878-
'git-gc' does not run `git pack-refs` in a bare repository by
879-
default so that older dumb-transport clients can still fetch
880-
from the repository. Setting this to `true` lets 'git-gc'
881-
to run `git pack-refs`. Setting this to `false` tells
882-
'git-gc' never to run `git pack-refs`. The default setting is
883-
`notbare`. Enable it only when you know you do not have to
884-
support such clients. The default setting will change to `true`
885-
at some stage, and setting this to `false` will continue to
886-
prevent `git pack-refs` from being run from 'git-gc'.
878+
Running `git pack-refs` in a repository renders it
879+
unclonable by Git versions prior to 1.5.1.2 over dumb
880+
transports such as HTTP. This variable determines whether
881+
'git gc' runs `git pack-refs`. This can be set to "nobare"
882+
to enable it within all non-bare repos or it can be set to a
883+
boolean value. The default is `true`.
887884

888885
gc.pruneexpire::
889886
When 'git-gc' is run, it will call 'prune --expire 2.weeks.ago'.

0 commit comments

Comments
 (0)