pack.indexversion config option now defaults to 2
As announced for 1.6.0. Git older than version 1.5.2 (or any other git version with this option set to 1) may revert to version 1 of the pack index by manually deleting all .idx files and recreating them using 'git index-pack'. Communication over the git native protocol is unaffected since the pack index is never transferred. Signed-off-by: Nicolas Pitre <nico@cam.org> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Nicolas Pitre committed
Jun 25, 2008 at 00:25 UTC
c0a5e2d477baa9d3ebf7d3303a7d2b5dbc7c2ffe
3 files changed
+13
-4
Documentation/asciidoc.conf
+1
@@ -8,6 +8,7 @@
8
# the command.
9
10
[attributes]
11
+asterisk=*
12
plus=+
13
caret=^
14
startsb=[
Documentation/config.txt
+11
-3
@@ -937,9 +937,17 @@ pack.indexVersion::
937
legacy pack index used by Git versions prior to 1.5.2, and 2 for
938
the new pack index with capabilities for packs larger than 4 GB
939
as well as proper protection against the repacking of corrupted
940
- packs. Version 2 is selected and this config option ignored
941
- whenever the corresponding pack is larger than 2 GB. Otherwise
942
- the default is 1.
940
+ packs. Version 2 is the default. Note that version 2 is enforced
941
+ and this config option ignored whenever the corresponding pack is
942
+ larger than 2 GB.
943
++
944
+If you have an old git that does not understand the version 2 `{asterisk}.idx` file,
945
+cloning or fetching over a non native protocol (e.g. "http" and "rsync")
946
+that will copy both `{asterisk}.pack` file and corresponding `{asterisk}.idx` file from the
947
+other side may give you a repository that cannot be accessed with your
948
+older version of git. If the `{asterisk}.pack` file is smaller than 2 GB, however,
949
+you can use linkgit:git-index-pack[1] on the *.pack file to regenerate
950
+the `{asterisk}.idx` file.
951
952
pack.packSizeLimit::
953
The default maximum size of a pack. This setting only affects
pack-write.c
+1
-1
@@ -2,7 +2,7 @@
2
#include "pack.h"
3
#include "csum-file.h"
4
5
-uint32_t pack_idx_default_version = 1;
5
+uint32_t pack_idx_default_version = 2;
6
uint32_t pack_idx_off32_limit = 0x7fffffff;
7
8
static int sha1_compare(const void *_a, const void *_b)