summaryrefslogtreecommitdiffstats
path: root/man1/git-update-index.1
diff options
context:
space:
mode:
Diffstat (limited to 'man1/git-update-index.1')
-rw-r--r--man1/git-update-index.118
1 files changed, 13 insertions, 5 deletions
diff --git a/man1/git-update-index.1 b/man1/git-update-index.1
index 4a2d1ce64..22d65c885 100644
--- a/man1/git-update-index.1
+++ b/man1/git-update-index.1
@@ -2,12 +2,12 @@
.\" Title: git-update-index
.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\" Date: 2023-09-18
+.\" Date: 2023-09-20
.\" Manual: Git Manual
-.\" Source: Git 2.42.0.221.gd4a83d07b8
+.\" Source: Git 2.42.0.241.g6bdb5b11d6
.\" Language: English
.\"
-.TH "GIT\-UPDATE\-INDEX" "1" "2023\-09\-18" "Git 2\&.42\&.0\&.221\&.gd4a83d" "Git Manual"
+.TH "GIT\-UPDATE\-INDEX" "1" "2023\-09\-20" "Git 2\&.42\&.0\&.241\&.g6bdb5b" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -200,9 +200,17 @@ Report what is being added and removed from index\&.
\-\-index\-version <n>
.RS 4
Write the resulting index out in the named on\-disk format version\&. Supported versions are 2, 3 and 4\&. The current default version is 2 or 3, depending on whether extra features are used, such as
-\fBgit add \-N\fR\&.
+\fBgit add \-N\fR\&. With
+\fB\-\-verbose\fR, also report the version the index file uses before and after this command\&.
.sp
-Version 4 performs a simple pathname compression that reduces index size by 30%\-50% on large repositories, which results in faster load time\&. Version 4 is relatively young (first released in 1\&.8\&.0 in October 2012)\&. Other Git implementations such as JGit and libgit2 may not support it yet\&.
+Version 4 performs a simple pathname compression that reduces index size by 30%\-50% on large repositories, which results in faster load time\&. Git supports it since version 1\&.8\&.0, released in October 2012, and support for it was added to libgit2 in 2016 and to JGit in 2020\&. Older versions of this manual page called it "relatively young", but it should be considered mature technology these days\&.
+.RE
+.PP
+\-\-show\-index\-version
+.RS 4
+Report the index format version used by the on\-disk index file\&. See
+\fB\-\-index\-version\fR
+above\&.
.RE
.PP
\-z