update-index: list supported idx versions and their features
Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com> Reviewed-by: Jonathan Nieder <jrnieder@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Nguyễn Thái Ngọc Duy committed
Feb 23, 2013 at 09:29 UTC
647d87947f8248df5608f621ece8b1dc875fa859
1 file changed
+9
-1
Documentation/git-update-index.txt
+9
-1
@@ -145,7 +145,15 @@ you will need to handle the situation manually.
145
146
--index-version <n>::
147
Write the resulting index out in the named on-disk format version.
148
- The current default version is 2.
148
+ Supported versions are 2, 3 and 4. The current default version is 2
149
+ or 3, depending on whether extra features are used, such as
150
+ `git add -N`.
151
++
152
+Version 4 performs a simple pathname compression that reduces index
153
+size by 30%-50% on large repositories, which results in faster load
154
+time. Version 4 is relatively young (first released in in 1.8.0 in
155
+October 2012). Other Git implementations such as JGit and libgit2
156
+may not support it yet.
157
158
-z::
159
Only meaningful with `--stdin` or `--index-info`; paths are