update-index doc: v4 is OK with JGit and libgit2
Being invented in late 2012 no longer makes the index v4 format "relatively young". The support for the index version 4 was added to libgit2 with their 5625d86b (index: support index v4, 2016-05-17) and to JGit with their e9cb0a8e (DirCache: support index V4, 2020-08-10). Let's update the paragraph that discouraged its use for folks overly cautious about cross-tool compatibility. Helped-by: Oswald Buddenhagen <oswald.buddenhagen@gmx.de> Helped-by: Linus Arver <linusa@google.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Junio C Hamano committed
Sep 12, 2023 at 12:32 UTC
764b2330db42d07ed8c7d4f6c66a1d1203fb95de
1 file changed
+5
-3
Documentation/git-update-index.txt
+5
-3
@@ -166,9 +166,11 @@ you will need to handle the situation manually.
166
+
167
Version 4 performs a simple pathname compression that reduces index
168
size by 30%-50% on large repositories, which results in faster load
169
-time. Version 4 is relatively young (first released in 1.8.0 in
170
-October 2012). Other Git implementations such as JGit and libgit2
171
-may not support it yet.
169
+time. Git supports it since version 1.8.0, released in October 2012,
170
+and support for it was added to libgit2 in 2016 and to JGit in 2020.
171
+Older versions of this manual page called it "relatively young", but
172
+it should be considered mature technology these days.
173
+
174
175
-z::
176
Only meaningful with `--stdin` or `--index-info`; paths are