diff options
Diffstat (limited to 'man5/gitformat-pack.5')
-rw-r--r-- | man5/gitformat-pack.5 | 32 |
1 files changed, 16 insertions, 16 deletions
diff --git a/man5/gitformat-pack.5 b/man5/gitformat-pack.5 index 0133cac22..48285597a 100644 --- a/man5/gitformat-pack.5 +++ b/man5/gitformat-pack.5 @@ -2,12 +2,12 @@ .\" Title: gitformat-pack .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 03/21/2023 +.\" Date: 03/28/2023 .\" Manual: Git Manual -.\" Source: Git 2.40.0.130.g27d43aaaf5 +.\" Source: Git 2.40.0.141.g8d90352acc .\" Language: English .\" -.TH "GITFORMAT\-PACK" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITFORMAT\-PACK" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -63,7 +63,7 @@ A header appears at the beginning and consists of the following: .\} .nf 4\-byte signature: - The signature is: {\(aqP\(aq, \(aqA\(aq, \(aqC\(aq, \(aqK\(aq} + The signature is: {\*(AqP\*(Aq, \*(AqA\*(Aq, \*(AqC\*(Aq, \*(AqK\*(Aq} .fi .if n \{\ .RE @@ -132,7 +132,7 @@ compressed data (deltified representation) n\-byte type and length (3\-bit type, (n\-1)*7+4\-bit length) base object name if OBJ_REF_DELTA or a negative relative - offset from the delta object\(aqs position in the pack if this + offset from the delta object\*(Aqs position in the pack if this is an OBJ_OFS_DELTA object compressed delta data .fi @@ -779,7 +779,7 @@ HEADER: .\} .nf 4\-byte signature: - The signature is: {\(aqM\(aq, \(aqI\(aq, \(aqD\(aq, \(aqX\(aq} + The signature is: {\*(AqM\*(Aq, \*(AqI\*(Aq, \*(AqD\*(Aq, \*(AqX\*(Aq} .fi .if n \{\ .RE @@ -804,7 +804,7 @@ HEADER: We infer the length of object IDs (OIDs) from this value: 1 => SHA\-1 2 => SHA\-256 - If the hash type does not match the repository\(aqs hash algorithm, + If the hash type does not match the repository\*(Aqs hash algorithm, the multi\-pack\-index file should be ignored with a warning presented to the user\&. .fi @@ -888,7 +888,7 @@ CHUNK DATA: .RS 4 .\} .nf -Packfile Names (ID: {\(aqP\(aq, \(aqN\(aq, \(aqA\(aq, \(aqM\(aq}) +Packfile Names (ID: {\*(AqP\*(Aq, \*(AqN\*(Aq, \*(AqA\*(Aq, \*(AqM\*(Aq}) Stores the packfile names as concatenated, null\-terminated strings\&. Packfiles must be listed in lexicographic order for fast lookups by name\&. This is the only chunk not guaranteed to be a multiple of four @@ -902,7 +902,7 @@ Packfile Names (ID: {\(aqP\(aq, \(aqN\(aq, \(aqA\(aq, \(aqM\(aq}) .RS 4 .\} .nf -OID Fanout (ID: {\(aqO\(aq, \(aqI\(aq, \(aqD\(aq, \(aqF\(aq}) +OID Fanout (ID: {\*(AqO\*(Aq, \*(AqI\*(Aq, \*(AqD\*(Aq, \*(AqF\*(Aq}) The ith entry, F[i], stores the number of OIDs with first byte at most i\&. Thus F[255] stores the total number of objects\&. @@ -915,7 +915,7 @@ OID Fanout (ID: {\(aqO\(aq, \(aqI\(aq, \(aqD\(aq, \(aqF\(aq}) .RS 4 .\} .nf -OID Lookup (ID: {\(aqO\(aq, \(aqI\(aq, \(aqD\(aq, \(aqL\(aq}) +OID Lookup (ID: {\*(AqO\*(Aq, \*(AqI\*(Aq, \*(AqD\*(Aq, \*(AqL\*(Aq}) The OIDs for all objects in the MIDX are stored in lexicographic order in this chunk\&. .fi @@ -927,7 +927,7 @@ OID Lookup (ID: {\(aqO\(aq, \(aqI\(aq, \(aqD\(aq, \(aqL\(aq}) .RS 4 .\} .nf -Object Offsets (ID: {\(aqO\(aq, \(aqO\(aq, \(aqF\(aq, \(aqF\(aq}) +Object Offsets (ID: {\*(AqO\*(Aq, \*(AqO\*(Aq, \*(AqF\*(Aq, \*(AqF\*(Aq}) Stores two 4\-byte values for every object\&. 1: The pack\-int\-id for the pack storing this object\&. 2: The offset within the pack\&. @@ -948,7 +948,7 @@ Object Offsets (ID: {\(aqO\(aq, \(aqO\(aq, \(aqF\(aq, \(aqF\(aq}) .RS 4 .\} .nf -[Optional] Object Large Offsets (ID: {\(aqL\(aq, \(aqO\(aq, \(aqF\(aq, \(aqF\(aq}) +[Optional] Object Large Offsets (ID: {\*(AqL\*(Aq, \*(AqO\*(Aq, \*(AqF\*(Aq, \*(AqF\*(Aq}) 8\-byte offsets into large packfiles\&. .fi .if n \{\ @@ -959,7 +959,7 @@ Object Offsets (ID: {\(aqO\(aq, \(aqO\(aq, \(aqF\(aq, \(aqF\(aq}) .RS 4 .\} .nf -[Optional] Bitmap pack order (ID: {\(aqR\(aq, \(aqI\(aq, \(aqD\(aq, \(aqX\(aq}) +[Optional] Bitmap pack order (ID: {\*(AqR\*(Aq, \*(AqI\*(Aq, \*(AqD\*(Aq, \*(AqX\*(Aq}) A list of MIDX positions (one per object in the MIDX, num_objects in total, each a 4\-byte unsigned integer in network byte order), sorted according to their relative bitmap/pseudo\-pack positions\&. @@ -1071,7 +1071,7 @@ To remove unreachable objects from your repository, Git offers \fBgit repack \-A .nf [\&.\&.\&.] unreachable objects in a previous pack become loose, unpacked objects, instead of being left in the old pack\&. [\&.\&.\&.] loose unreachable objects will be -pruned according to normal expiry rules with the next \(aqgit gc\(aq invocation\&. +pruned according to normal expiry rules with the next \*(Aqgit gc\*(Aq invocation\&. .fi .if n \{\ .RE @@ -1087,7 +1087,7 @@ This can lead to undesirable situations when a repository contains many unreacha .sp A cruft pack eliminates the need for storing unreachable objects in a loose state by including the per\-object mtimes in a separate file alongside a single pack containing all loose objects\&. .sp -A cruft pack is written by \fBgit repack \-\-cruft\fR when generating a new pack\&. \fBgit-pack-objects\fR(1)\(aqs \fB\-\-cruft\fR option\&. Note that \fBgit repack \-\-cruft\fR is a classic all\-into\-one repack, meaning that everything in the resulting pack is reachable, and everything else is unreachable\&. Once written, the \fB\-\-cruft\fR option instructs \fBgit repack\fR to generate another pack containing only objects not packed in the previous step (which equates to packing all unreachable objects together)\&. This progresses as follows: +A cruft pack is written by \fBgit repack \-\-cruft\fR when generating a new pack\&. \fBgit-pack-objects\fR(1)\*(Aqs \fB\-\-cruft\fR option\&. Note that \fBgit repack \-\-cruft\fR is a classic all\-into\-one repack, meaning that everything in the resulting pack is reachable, and everything else is unreachable\&. Once written, the \fB\-\-cruft\fR option instructs \fBgit repack\fR to generate another pack containing only objects not packed in the previous step (which equates to packing all unreachable objects together)\&. This progresses as follows: .sp .RS 4 .ie n \{\ @@ -1157,7 +1157,7 @@ An older version of Git running GC explodes the contents of an existing cruft pa A newer version running GC collects those loose objects into a cruft pack, where the \&.mtime file reflects the loose object\(cqs actual mtimes, but the cruft pack mtime is "now"\&. .RE .sp -Repeating this process will lead to unreachable objects not getting pruned as a result of repeatedly resetting the objects\(aq mtimes to the present time\&. +Repeating this process will lead to unreachable objects not getting pruned as a result of repeatedly resetting the objects\*(Aq mtimes to the present time\&. .sp If you are GC\-ing repositories in a mixed version environment, consider omitting the \fB\-\-cruft\fR option when using \fBgit-repack\fR(1) and \fBgit-gc\fR(1), and leaving the \fBgc\&.cruftPacks\fR configuration unset until all writers understand cruft packs\&. .SS "Alternatives" |