summaryrefslogtreecommitdiffstats
path: root/man5/gitformat-index.5
diff options
context:
space:
mode:
Diffstat (limited to 'man5/gitformat-index.5')
-rw-r--r--man5/gitformat-index.544
1 files changed, 22 insertions, 22 deletions
diff --git a/man5/gitformat-index.5 b/man5/gitformat-index.5
index 42a9e89c8..5c1a66391 100644
--- a/man5/gitformat-index.5
+++ b/man5/gitformat-index.5
@@ -2,12 +2,12 @@
.\" Title: gitformat-index
.\" 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\-INDEX" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual"
+.TH "GITFORMAT\-INDEX" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -69,7 +69,7 @@ A 12\-byte header consisting of
.\}
.nf
4\-byte signature:
- The signature is { \(aqD\(aq, \(aqI\(aq, \(aqR\(aq, \(aqC\(aq } (stands for "dircache")
+ The signature is { \*(AqD\*(Aq, \*(AqI\*(Aq, \*(AqR\*(Aq, \*(AqC\*(Aq } (stands for "dircache")
.fi
.if n \{\
.RE
@@ -133,7 +133,7 @@ be ignored if Git does not understand them\&.
.RS 4
.\}
.nf
-4\-byte extension signature\&. If the first byte is \(aqA\(aq\&.\&.\(aqZ\(aq the
+4\-byte extension signature\&. If the first byte is \*(AqA\*(Aq\&.\&.\*(AqZ\*(Aq the
extension is optional and can be ignored\&.
.fi
.if n \{\
@@ -179,7 +179,7 @@ Hash checksum over the content of the index file before this checksum\&.
.nf
Index entries are sorted in ascending order on the name field,
interpreted as a string of unsigned bytes (i\&.e\&. memcmp() order, no
-localization, no special casing of directory separator \(aq/\(aq)\&. Entries
+localization, no special casing of directory separator \*(Aq/\*(Aq)\&. Entries
with the same name are sorted by their stage field\&.
.fi
.if n \{\
@@ -205,7 +205,7 @@ the path ends in a directory separator\&.
.RS 4
.\}
.nf
-32\-bit ctime seconds, the last time a file\(aqs metadata changed
+32\-bit ctime seconds, the last time a file\*(Aqs metadata changed
this is stat(2) data
.fi
.if n \{\
@@ -227,7 +227,7 @@ the path ends in a directory separator\&.
.RS 4
.\}
.nf
-32\-bit mtime seconds, the last time a file\(aqs data changed
+32\-bit mtime seconds, the last time a file\*(Aqs data changed
this is stat(2) data
.fi
.if n \{\
@@ -367,7 +367,7 @@ Object name for the represented object
.RS 4
.\}
.nf
-A 16\-bit \(aqflags\(aq field split into (high to low bits)
+A 16\-bit \*(Aqflags\*(Aq field split into (high to low bits)
.fi
.if n \{\
.RE
@@ -470,7 +470,7 @@ is stored in this field\&.
.\}
.nf
Entry path name (variable length) relative to top level directory
- (without leading slash)\&. \(aq/\(aq is used as path separator\&. The special
+ (without leading slash)\&. \*(Aq/\*(Aq is used as path separator\&. The special
path components "\&.", "\&.\&." and "\&.git" (without quotes) are disallowed\&.
Trailing slash is also disallowed\&.
.fi
@@ -482,7 +482,7 @@ Entry path name (variable length) relative to top level directory
.RS 4
.\}
.nf
-The exact encoding is undefined, but the \(aq\&.\(aq and \(aq/\(aq characters
+The exact encoding is undefined, but the \*(Aq\&.\*(Aq and \*(Aq/\*(Aq characters
are encoded in 7\-bit ASCII and the encoding cannot contain a NUL
byte (iow, this is a UNIX pathname)\&.
.fi
@@ -571,7 +571,7 @@ entries, a list of subnodes, and an object ID (OID)\&. The OID references
the existing tree for that node, if it is known to exist\&. The subnodes
correspond to subdirectories that themselves have cache tree nodes\&. The
number of cache entries corresponds to the number of cache entries in
-the index that describe paths within that tree\(aqs directory\&.
+the index that describe paths within that tree\*(Aqs directory\&.
.fi
.if n \{\
.RE
@@ -607,7 +607,7 @@ cache tree\&.
.RS 4
.\}
.nf
-The signature for this extension is { \(aqT\(aq, \(aqR\(aq, \(aqE\(aq, \(aqE\(aq }\&.
+The signature for this extension is { \*(AqT\*(Aq, \*(AqR\*(Aq, \*(AqE\*(Aq, \*(AqE\*(Aq }\&.
.fi
.if n \{\
.RE
@@ -708,7 +708,7 @@ When writing an invalid entry, \-1 should always be used as entry_count\&.
.nf
The entries are written out in the top\-down, depth\-first order\&. The
first entry represents the root level of the repository, followed by the
-first subtree\-\-let\(aqs call this A\-\-of the root level (with its name
+first subtree\-\-let\*(Aqs call this A\-\-of the root level (with its name
relative to the root level), followed by the first subtree of A (with
its name relative to A), and so on\&. The specified number of subtrees
indicates when the current level of the recursive stack is complete\&.
@@ -749,7 +749,7 @@ from scratch\&.
.RS 4
.\}
.nf
-The signature for this extension is { \(aqR\(aq, \(aqE\(aq, \(aqU\(aq, \(aqC\(aq }\&.
+The signature for this extension is { \*(AqR\*(Aq, \*(AqE\*(Aq, \*(AqU\*(Aq, \*(AqC\*(Aq }\&.
.fi
.if n \{\
.RE
@@ -816,7 +816,7 @@ top of that to produce the final index\&.
.RS 4
.\}
.nf
-The signature for this extension is { \(aql\(aq, \(aqi\(aq, \(aqn\(aq, \(aqk\(aq }\&.
+The signature for this extension is { \*(Aql\*(Aq, \*(Aqi\*(Aq, \*(Aqn\*(Aq, \*(Aqk\*(Aq }\&.
.fi
.if n \{\
.RE
@@ -883,8 +883,8 @@ stage\&.
.\}
.nf
Untracked cache saves the untracked file list and necessary data to
-verify the cache\&. The signature for this extension is { \(aqU\(aq, \(aqN\(aq,
-\(aqT\(aq, \(aqR\(aq }\&.
+verify the cache\&. The signature for this extension is { \*(AqU\*(Aq, \*(AqN\*(Aq,
+\*(AqT\*(Aq, \*(AqR\*(Aq }\&.
.fi
.if n \{\
.RE
@@ -1118,7 +1118,7 @@ One NUL\&.
.nf
The file system monitor cache tracks files for which the core\&.fsmonitor
hook has told us about changes\&. The signature for this extension is
-{ \(aqF\(aq, \(aqS\(aq, \(aqM\(aq, \(aqN\(aq }\&.
+{ \*(AqF\*(Aq, \*(AqS\*(Aq, \*(AqM\*(Aq, \*(AqN\*(Aq }\&.
.fi
.if n \{\
.RE
@@ -1209,7 +1209,7 @@ to parse through all of the index entries\&.
.nf
Because it must be able to be loaded before the variable length cache
entries and other index extensions, this extension must be written last\&.
-The signature for this extension is { \(aqE\(aq, \(aqO\(aq, \(aqI\(aq, \(aqE\(aq }\&.
+The signature for this extension is { \*(AqE\*(Aq, \*(AqO\*(Aq, \*(AqI\*(Aq, \*(AqE\*(Aq }\&.
.fi
.if n \{\
.RE
@@ -1266,7 +1266,7 @@ Hash("TREE" + <binary representation of N> +
The Index Entry Offset Table (IEOT) is used to help address the CPU
cost of loading the index by enabling multi\-threading the process of
converting cache entries from the on\-disk format to the in\-memory format\&.
-The signature for this extension is { \(aqI\(aq, \(aqE\(aq, \(aqO\(aq, \(aqT\(aq }\&.
+The signature for this extension is { \*(AqI\*(Aq, \*(AqE\*(Aq, \*(AqO\*(Aq, \*(AqT\*(Aq }\&.
.fi
.if n \{\
.RE
@@ -1337,7 +1337,7 @@ entire expanded list of paths within that tree\&. An index containing such
entries is a "sparse index"\&. Index format versions 4 and less were not
implemented with such entries in mind\&. Thus, for these versions, an
index containing sparse directory entries will include this extension
-with signature { \(aqs\(aq, \(aqd\(aq, \(aqi\(aq, \(aqr\(aq }\&. Like the split\-index extension,
+with signature { \*(Aqs\*(Aq, \*(Aqd\*(Aq, \*(Aqi\*(Aq, \*(Aqr\*(Aq }\&. Like the split\-index extension,
tools should avoid interacting with a sparse index unless they understand
this extension\&.
.fi