summaryrefslogtreecommitdiffstats
path: root/man1/git-pack-refs.1
diff options
context:
space:
mode:
Diffstat (limited to 'man1/git-pack-refs.1')
-rw-r--r--man1/git-pack-refs.137
1 files changed, 33 insertions, 4 deletions
diff --git a/man1/git-pack-refs.1 b/man1/git-pack-refs.1
index b3b8d60b3..bef5d9292 100644
--- a/man1/git-pack-refs.1
+++ b/man1/git-pack-refs.1
@@ -2,12 +2,12 @@
.\" Title: git-pack-refs
.\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
-.\" Date: 2024-04-05
+.\" Date: 2024-04-09
.\" Manual: Git Manual
-.\" Source: Git 2.44.0.501.g19981daefd
+.\" Source: Git 2.44.0.548.g91ec36f2cc
.\" Language: English
.\"
-.TH "GIT\-PACK\-REFS" "1" "2024\-04\-05" "Git 2\&.44\&.0\&.501\&.g19981d" "Git Manual"
+.TH "GIT\-PACK\-REFS" "1" "2024\-04\-09" "Git 2\&.44\&.0\&.548\&.g91ec36" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -32,7 +32,7 @@ git-pack-refs \- Pack heads and tags for efficient repository access
.SH "SYNOPSIS"
.sp
.nf
-\fIgit pack\-refs\fR [\-\-all] [\-\-no\-prune] [\-\-include <pattern>] [\-\-exclude <pattern>]
+\fIgit pack\-refs\fR [\-\-all] [\-\-no\-prune] [\-\-auto] [\-\-include <pattern>] [\-\-exclude <pattern>]
.fi
.sp
.SH "DESCRIPTION"
@@ -58,6 +58,35 @@ The command usually removes loose refs under
hierarchy after packing them\&. This option tells it not to\&.
.RE
.PP
+\-\-auto
+.RS 4
+Pack refs as needed depending on the current state of the ref database\&. The behavior depends on the ref format used by the repository and may change in the future\&.
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+"files": No special handling for
+\fB\-\-auto\fR
+has been implemented\&.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+"reftable": Tables are compacted such that they form a geometric sequence\&. For two tables N and N+1, where N+1 is newer, this maintains the property that N is at least twice as big as N+1\&. Only tables that violate this property are compacted\&.
+.RE
+.RE
+.PP
\-\-include <pattern>
.RS 4
Pack refs based on a