diff options
Diffstat (limited to 'man5/gitformat-index.5')
-rw-r--r-- | man5/gitformat-index.5 | 44 |
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 |