diff options
author | Junio C Hamano <gitster@pobox.com> | 2023-03-28 12:36:46 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2023-03-28 12:36:46 -0700 |
commit | 5e6ae018e47aec56fa4bc3a1ea9f5fffa087713f (patch) | |
tree | fc1902c62f9c3c66a4b9918e7a4dc069b6c5a238 /man5 | |
parent | d3f99433ce805f8df0cd56f7958376b824d84346 (diff) | |
download | git-manpages-5e6ae018e47aec56fa4bc3a1ea9f5fffa087713f.tar.gz |
Autogenerated manpages for v2.40.0-141-g8d9035
Diffstat (limited to 'man5')
-rw-r--r-- | man5/gitattributes.5 | 8 | ||||
-rw-r--r-- | man5/gitformat-bundle.5 | 6 | ||||
-rw-r--r-- | man5/gitformat-chunk.5 | 6 | ||||
-rw-r--r-- | man5/gitformat-commit-graph.5 | 12 | ||||
-rw-r--r-- | man5/gitformat-index.5 | 44 | ||||
-rw-r--r-- | man5/gitformat-pack.5 | 32 | ||||
-rw-r--r-- | man5/gitformat-signature.5 | 12 | ||||
-rw-r--r-- | man5/githooks.5 | 12 | ||||
-rw-r--r-- | man5/gitignore.5 | 8 | ||||
-rw-r--r-- | man5/gitmailmap.5 | 6 | ||||
-rw-r--r-- | man5/gitmodules.5 | 6 | ||||
-rw-r--r-- | man5/gitprotocol-capabilities.5 | 6 | ||||
-rw-r--r-- | man5/gitprotocol-common.5 | 6 | ||||
-rw-r--r-- | man5/gitprotocol-http.5 | 6 | ||||
-rw-r--r-- | man5/gitprotocol-pack.5 | 16 | ||||
-rw-r--r-- | man5/gitprotocol-v2.5 | 38 | ||||
-rw-r--r-- | man5/gitrepository-layout.5 | 6 | ||||
-rw-r--r-- | man5/gitweb.conf.5 | 54 |
18 files changed, 142 insertions, 142 deletions
diff --git a/man5/gitattributes.5 b/man5/gitattributes.5 index faeb1bdb0..db7ed3153 100644 --- a/man5/gitattributes.5 +++ b/man5/gitattributes.5 @@ -2,12 +2,12 @@ .\" Title: gitattributes .\" 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 "GITATTRIBUTES" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITATTRIBUTES" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -558,7 +558,7 @@ Then you would define a "filter\&.indent\&.clean" and "filter\&.indent\&.smudge" .\} .sp .sp -For best results, \fBclean\fR should not alter its output further if it is run twice ("clean\(->clean" should be equivalent to "clean"), and multiple \fBsmudge\fR commands should not alter \fBclean\fR\(aqs output ("smudge\(->smudge\(->clean" should be equivalent to "clean")\&. See the section on merging below\&. +For best results, \fBclean\fR should not alter its output further if it is run twice ("clean\(->clean" should be equivalent to "clean"), and multiple \fBsmudge\fR commands should not alter \fBclean\fR\*(Aqs output ("smudge\(->smudge\(->clean" should be equivalent to "clean")\&. See the section on merging below\&. .sp The "indent" filter is well\-behaved in this regard: it will not modify input that is already correctly indented\&. In this case, the lack of a smudge filter means that the clean filter \fImust\fR accept its own output without modifying it\&. .sp diff --git a/man5/gitformat-bundle.5 b/man5/gitformat-bundle.5 index ffefab644..0b16fea6e 100644 --- a/man5/gitformat-bundle.5 +++ b/man5/gitformat-bundle.5 @@ -2,12 +2,12 @@ .\" Title: gitformat-bundle .\" 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\-BUNDLE" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITFORMAT\-BUNDLE" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/man5/gitformat-chunk.5 b/man5/gitformat-chunk.5 index ab90afd3f..ab9542548 100644 --- a/man5/gitformat-chunk.5 +++ b/man5/gitformat-chunk.5 @@ -2,12 +2,12 @@ .\" Title: gitformat-chunk .\" 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\-CHUNK" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITFORMAT\-CHUNK" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/man5/gitformat-commit-graph.5 b/man5/gitformat-commit-graph.5 index b77fd2d04..f7a4da450 100644 --- a/man5/gitformat-commit-graph.5 +++ b/man5/gitformat-commit-graph.5 @@ -2,12 +2,12 @@ .\" Title: gitformat-commit-graph .\" 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\-COMMIT\-G" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITFORMAT\-COMMIT\-G" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -108,7 +108,7 @@ All multi\-byte numbers are in network byte order\&. .\} .nf 4\-byte signature: - The signature is: {\(aqC\(aq, \(aqG\(aq, \(aqP\(aq, \(aqH\(aq} + The signature is: {\*(AqC\*(Aq, \*(AqG\*(Aq, \*(AqP\*(Aq, \*(AqH\*(Aq} .fi .if n \{\ .RE @@ -133,7 +133,7 @@ All multi\-byte numbers are in network byte order\&. We infer the hash length (H) from this value: 1 => SHA\-1 2 => SHA\-256 - If the hash type does not match the repository\(aqs hash algorithm, the + If the hash type does not match the repository\*(Aqs hash algorithm, the commit\-graph file should be ignored with a warning presented to the user\&. .fi @@ -521,7 +521,7 @@ The BDAT chunk is present if and only if BIDX is present\&. .nf This list of H\-byte hashes describe a set of B commit\-graph files that form a commit\-graph chain\&. The graph position for the ith commit in this -file\(aqs OID Lookup chunk is equal to i plus the number of commits in all +file\*(Aqs OID Lookup chunk is equal to i plus the number of commits in all base graphs\&. If B is non\-zero, this chunk must exist\&. .fi .if n \{\ 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 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" diff --git a/man5/gitformat-signature.5 b/man5/gitformat-signature.5 index 7cc8bfcdf..548850867 100644 --- a/man5/gitformat-signature.5 +++ b/man5/gitformat-signature.5 @@ -2,12 +2,12 @@ .\" Title: gitformat-signature .\" 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\-SIGNATURE" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITFORMAT\-SIGNATURE" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -372,7 +372,7 @@ mergetag object 04b871796dc0420f8e7561a895b52484b701d51a =jpXa \-\-\-\-\-END PGP SIGNATURE\-\-\-\-\- -Merge tag \(aqsignedtag\(aq into downstream +Merge tag \*(Aqsignedtag\*(Aq into downstream signed tag @@ -407,7 +407,7 @@ verify with: verification is embedded in merge commit message by default, altern .\} .nf commit 9863f0c76ff78712b6800e199a46aa56afbcbd49 -merged tag \(aqsignedtag\(aq +merged tag \*(Aqsignedtag\*(Aq gpg: Signature made Wed Jun 15 10:56:46 2016 CEST using RSA key ID B7227189 gpg: Good signature from "Eris Discordia <discord@example\&.net>" gpg: WARNING: This key is not certified with a trusted signature! @@ -417,7 +417,7 @@ Merge: c33429b 04b8717 Author: A U Thor <author@example\&.com> Date: Wed Jun 15 09:13:29 2016 +0000 - Merge tag \(aqsignedtag\(aq into downstream + Merge tag \*(Aqsignedtag\*(Aq into downstream signed tag diff --git a/man5/githooks.5 b/man5/githooks.5 index cf66e3821..2b647854b 100644 --- a/man5/githooks.5 +++ b/man5/githooks.5 @@ -2,12 +2,12 @@ .\" Title: githooks .\" 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 "GITHOOKS" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITHOOKS" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -238,7 +238,7 @@ This hook can be used to prevent \fIforced\fR update on certain refs by making s .sp It could also be used to log the old\&.\&.new status\&. However, it does not know the entire set of branches, so it would end up firing one e\-mail per ref when used naively, though\&. The \fIpost\-receive\fR hook is more suited to that\&. .sp -In an environment that restricts the users\(aq access only to git commands over the wire, this hook can be used to implement access control without relying on filesystem ownership and group membership\&. See \fBgit-shell\fR(1) for how you might use the login shell to restrict the user\(cqs access to only git commands\&. +In an environment that restricts the users\*(Aq access only to git commands over the wire, this hook can be used to implement access control without relying on filesystem ownership and group membership\&. See \fBgit-shell\fR(1) for how you might use the login shell to restrict the user\(cqs access to only git commands\&. .sp Both standard output and standard error output are forwarded to \fBgit send\-pack\fR on the other end, so you can simply \fBecho\fR messages for the user\&. .sp @@ -271,7 +271,7 @@ H: flush\-pkt S: PKT\-LINE(<old\-oid> <new\-oid> <ref>) S: \&.\&.\&. \&.\&.\&. S: flush\-pkt -# Send push\-options only if the \(aqpush\-options\(aq feature is enabled\&. +# Send push\-options only if the \*(Aqpush\-options\*(Aq feature is enabled\&. S: PKT\-LINE(push\-option) S: \&.\&.\&. \&.\&.\&. S: flush\-pkt @@ -289,7 +289,7 @@ S: flush\-pkt H: PKT\-LINE(ok <ref>) # NO, I reject it\&. H: PKT\-LINE(ng <ref> <reason>) -# Fall through, let \(aqreceive\-pack\(aq to execute it\&. +# Fall through, let \*(Aqreceive\-pack\*(Aq to execute it\&. H: PKT\-LINE(ok <ref>) H: PKT\-LINE(option fall\-through) # OK, but has an alternate reference\&. The alternate reference name diff --git a/man5/gitignore.5 b/man5/gitignore.5 index e9a2da35a..ff3c7b158 100644 --- a/man5/gitignore.5 +++ b/man5/gitignore.5 @@ -2,12 +2,12 @@ .\" Title: gitignore .\" 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 "GITIGNORE" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITIGNORE" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -424,7 +424,7 @@ Another example: vmlinux* $ ls arch/foo/kernel/vm* arch/foo/kernel/vmlinux\&.lds\&.S - $ echo \(aq!/vmlinux*\(aq >arch/foo/kernel/\&.gitignore + $ echo \*(Aq!/vmlinux*\*(Aq >arch/foo/kernel/\&.gitignore .fi .if n \{\ .RE diff --git a/man5/gitmailmap.5 b/man5/gitmailmap.5 index 44f7957c5..db3a2fb65 100644 --- a/man5/gitmailmap.5 +++ b/man5/gitmailmap.5 @@ -2,12 +2,12 @@ .\" Title: gitmailmap .\" 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 "GITMAILMAP" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITMAILMAP" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/man5/gitmodules.5 b/man5/gitmodules.5 index 825a663e3..cbbcac23d 100644 --- a/man5/gitmodules.5 +++ b/man5/gitmodules.5 @@ -2,12 +2,12 @@ .\" Title: gitmodules .\" 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 "GITMODULES" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITMODULES" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/man5/gitprotocol-capabilities.5 b/man5/gitprotocol-capabilities.5 index 0e022f229..f1684c598 100644 --- a/man5/gitprotocol-capabilities.5 +++ b/man5/gitprotocol-capabilities.5 @@ -2,12 +2,12 @@ .\" Title: gitprotocol-capabilities .\" 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 "GITPROTOCOL\-CAPABIL" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITPROTOCOL\-CAPABIL" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/man5/gitprotocol-common.5 b/man5/gitprotocol-common.5 index 4f3c9aa16..393fd30fe 100644 --- a/man5/gitprotocol-common.5 +++ b/man5/gitprotocol-common.5 @@ -2,12 +2,12 @@ .\" Title: gitprotocol-common .\" 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 "GITPROTOCOL\-COMMON" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITPROTOCOL\-COMMON" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/man5/gitprotocol-http.5 b/man5/gitprotocol-http.5 index 15beb8abb..9f52fe6a0 100644 --- a/man5/gitprotocol-http.5 +++ b/man5/gitprotocol-http.5 @@ -2,12 +2,12 @@ .\" Title: gitprotocol-http .\" 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 "GITPROTOCOL\-HTTP" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITPROTOCOL\-HTTP" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/man5/gitprotocol-pack.5 b/man5/gitprotocol-pack.5 index 30446e0dd..2ee84c300 100644 --- a/man5/gitprotocol-pack.5 +++ b/man5/gitprotocol-pack.5 @@ -2,12 +2,12 @@ .\" Title: gitprotocol-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 "GITPROTOCOL\-PACK" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITPROTOCOL\-PACK" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -138,7 +138,7 @@ Initiating the upload\-pack or receive\-pack processes over SSH is executing the .RS 4 .\} .nf -$ ssh git\&.example\&.com "git\-upload\-pack \(aq/project\&.git\(aq" +$ ssh git\&.example\&.com "git\-upload\-pack \*(Aq/project\&.git\*(Aq" .fi .if n \{\ .RE @@ -155,7 +155,7 @@ In an ssh:// format URI, it\(cqs absolute in the URI, so the \fI/\fR after the h git clone ssh://user@example\&.com/project\&.git | v -ssh user@example\&.com "git\-upload\-pack \(aq/project\&.git\(aq" +ssh user@example\&.com "git\-upload\-pack \*(Aq/project\&.git\*(Aq" .fi .if n \{\ .RE @@ -170,7 +170,7 @@ In a "user@host:path" format URI, its relative to the user\(cqs home directory, git clone user@example\&.com:project\&.git | v -ssh user@example\&.com "git\-upload\-pack \(aqproject\&.git\(aq" +ssh user@example\&.com "git\-upload\-pack \*(Aqproject\&.git\*(Aq" .fi .if n \{\ .RE @@ -185,7 +185,7 @@ The exception is if a \fI~\fR is used, in which case we execute it without the l ssh://user@example\&.com/~alice/project\&.git, | v -ssh user@example\&.com "git\-upload\-pack \(aq~alice/project\&.git\(aq" +ssh user@example\&.com "git\-upload\-pack \*(Aq~alice/project\&.git\*(Aq" .fi .if n \{\ .RE @@ -328,7 +328,7 @@ The client now sends the maximum commit history depth it wants for this transact .sp The client can optionally request that pack\-objects omit various objects from the packfile using one of several filtering techniques\&. These are intended for use with partial clone and partial fetch operations\&. An object that does not meet a filter\-spec value is omitted unless explicitly requested in a \fIwant\fR line\&. See \fBrev\-list\fR for possible filter\-spec values\&. .sp -Once all the \fIwant\(cqs and \(aqshallow\(cqs (and optional \(aqdeepen\fR) are transferred, clients MUST send a flush\-pkt, to tell the server side that it is done sending the list\&. +Once all the \fIwant\(cqs and \*(Aqshallow\(cqs (and optional \*(Aqdeepen\fR) are transferred, clients MUST send a flush\-pkt, to tell the server side that it is done sending the list\&. .sp Otherwise, if the client sent a positive depth request, the server will determine which commits will and will not be shallow and send this information to the client\&. If the client did not request a positive depth, this step is skipped\&. .sp diff --git a/man5/gitprotocol-v2.5 b/man5/gitprotocol-v2.5 index 24b71b1ff..ef9a6a4e5 100644 --- a/man5/gitprotocol-v2.5 +++ b/man5/gitprotocol-v2.5 @@ -2,12 +2,12 @@ .\" Title: gitprotocol-v2 .\" 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 "GITPROTOCOL\-V2" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITPROTOCOL\-V2" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -375,7 +375,7 @@ want <oid> have <oid> Indicates to the server an object which the client has locally\&. This allows the server to make a packfile which only contains - the objects that the client needs\&. Multiple \(aqhave\(aq lines can be + the objects that the client needs\&. Multiple \*(Aqhave\*(Aq lines can be supplied\&. .fi .if n \{\ @@ -459,10 +459,10 @@ If the \fIshallow\fR feature is advertised the following arguments can be includ .nf shallow <oid> A client must notify the server of all commits for which it only - has shallow copies (meaning that it doesn\(aqt have the parents of - a commit) by supplying a \(aqshallow <oid>\(aq line for each such + has shallow copies (meaning that it doesn\*(Aqt have the parents of + a commit) by supplying a \*(Aqshallow <oid>\*(Aq line for each such object so that the server is aware of the limitations of the - client\(aqs history\&. This is so that the server is aware that the + client\*(Aqs history\&. This is so that the server is aware that the client may not have all objects reachable from such commits\&. .fi .if n \{\ @@ -487,7 +487,7 @@ deepen <depth> .nf deepen\-relative Requests that the semantics of the "deepen" command be changed - to indicate that the depth requested is relative to the client\(aqs + to indicate that the depth requested is relative to the client\*(Aqs current shallow boundary, instead of relative to the requested commits\&. .fi @@ -501,7 +501,7 @@ deepen\-relative .nf deepen\-since <timestamp> Requests that the shallow clone/fetch should be cut at a - specific time, instead of depth\&. Internally it\(aqs equivalent to + specific time, instead of depth\&. Internally it\*(Aqs equivalent to doing "git rev\-list \-\-max\-age=<timestamp>"\&. Cannot be used with "deepen"\&. .fi @@ -515,8 +515,8 @@ deepen\-since <timestamp> .nf deepen\-not <rev> Requests that the shallow clone/fetch should be cut at a - specific revision specified by \(aq<rev>\(aq, instead of a depth\&. - Internally it\(aqs equivalent of doing "git rev\-list \-\-not <rev>"\&. + specific revision specified by \*(Aq<rev>\*(Aq, instead of a depth\&. + Internally it\*(Aqs equivalent of doing "git rev\-list \-\-not <rev>"\&. Cannot be used with "deepen", but can be used with "deepen\-since"\&. .fi @@ -539,7 +539,7 @@ filter <filter\-spec> (e\&.g\&. "1k") into a fully\-expanded form (e\&.g\&. "1024") to aid interoperability with older receivers that may not understand newly\-invented scaling suffixes\&. However, receivers SHOULD - accept the following suffixes: \(aqk\(aq, \(aqm\(aq, and \(aqg\(aq for 1024, + accept the following suffixes: \*(Aqk\*(Aq, \*(Aqm\*(Aq, and \*(Aqg\*(Aq for 1024, 1048576, and 1073741824, respectively\&. .fi .if n \{\ @@ -694,7 +694,7 @@ packfile = PKT\-LINE("packfile" LF) acknowledgments section * If the client determines that it is finished with negotiations by sending a "done" line (thus requiring the server to send a packfile), - the acknowledgments sections MUST be omitted from the server\(aqs + the acknowledgments sections MUST be omitted from the server\*(Aqs response\&. .fi .if n \{\ @@ -773,7 +773,7 @@ If the server has found a suitable cut point and has decided to send a "ready" l shallow\-info section * If the client has requested a shallow fetch/clone, a shallow client requests a fetch or the server is shallow then the - server\(aqs response may include a shallow\-info section\&. The + server\*(Aqs response may include a shallow\-info section\&. The shallow\-info section will be included if (due to one of the above conditions) the server needs to inform the client of any shallow boundaries or adjustments to the clients already @@ -844,7 +844,7 @@ The server MUST NOT send any "unshallow" lines for anything which the client has .nf wanted\-refs section * This section is only included if the client has requested a - ref using a \(aqwant\-ref\(aq line and if a packfile section is also + ref using a \*(Aqwant\-ref\*(Aq line and if a packfile section is also included in the response\&. .fi .if n \{\ @@ -894,7 +894,7 @@ lines\&. .nf packfile\-uris section * This section is only included if the client sent - \(aqpackfile\-uris\(aq and the server has at least one such URI to + \*(Aqpackfile\-uris\*(Aq and the server has at least one such URI to send\&. .fi .if n \{\ @@ -939,9 +939,9 @@ The hashes are 40 hex characters long\&. When Git upgrades to a new hash algorit .\} .nf packfile section - * This section is only included if the client has sent \(aqwant\(aq + * This section is only included if the client has sent \*(Aqwant\*(Aq lines in its request and either requested that no more - negotiation be done by sending \(aqdone\(aq or if the server has + negotiation be done by sending \*(Aqdone\*(Aq or if the server has decided it has found a sufficient cut point to produce a packfile\&. .fi @@ -1095,7 +1095,7 @@ obj\-info = obj\-id SP obj\-size .sp If the \fIbundle\-uri\fR capability is advertised, the server supports the \(oqbundle\-uri\(cq command\&. .sp -The capability is currently advertised with no value (i\&.e\&. not "bundle\-uri=somevalue"), a value may be added in the future for supporting command\-wide extensions\&. Clients MUST ignore any unknown capability values and proceed with the \(aqbundle\-uri` dialog they support\&. +The capability is currently advertised with no value (i\&.e\&. not "bundle\-uri=somevalue"), a value may be added in the future for supporting command\-wide extensions\&. Clients MUST ignore any unknown capability values and proceed with the \*(Aqbundle\-uri` dialog they support\&. .sp The \fIbundle\-uri\fR command is intended to be issued before \fBfetch\fR to get URIs to bundle files (see \fBgit-bundle\fR(1)) to "seed" and inform the subsequent \fBfetch\fR command\&. .sp diff --git a/man5/gitrepository-layout.5 b/man5/gitrepository-layout.5 index f9ae1ab6a..bc4a6880d 100644 --- a/man5/gitrepository-layout.5 +++ b/man5/gitrepository-layout.5 @@ -2,12 +2,12 @@ .\" Title: gitrepository-layout .\" 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 "GITREPOSITORY\-LAYOU" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITREPOSITORY\-LAYOU" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/man5/gitweb.conf.5 b/man5/gitweb.conf.5 index cf59a190e..9507ab972 100644 --- a/man5/gitweb.conf.5 +++ b/man5/gitweb.conf.5 @@ -2,12 +2,12 @@ .\" Title: gitweb.conf .\" 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 "GITWEB\&.CONF" "5" "03/21/2023" "Git 2\&.40\&.0\&.130\&.g27d43a" "Git Manual" +.TH "GITWEB\&.CONF" "5" "03/28/2023" "Git 2\&.40\&.0\&.141\&.g8d9035" "Git Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -45,7 +45,7 @@ An example: # gitweb configuration file for http://git\&.example\&.org # our $projectroot = "/srv/git"; # FHS recommendation -our $site_name = \(aqExample\&.org >> Repos\(aq; +our $site_name = \*(AqExample\&.org >> Repos\*(Aq; .fi .if n \{\ .RE @@ -323,7 +323,7 @@ For example if repositories you are hosting use "phtml" extension for PHP files, .\} .nf our %highlight_ext; -$highlight_ext{\(aqphtml\(aq} = \(aqphp\(aq; +$highlight_ext{\*(Aqphtml\*(Aq} = \*(Aqphp\*(Aq; .fi .if n \{\ .RE @@ -439,8 +439,8 @@ For example, the following setting produces a breadcrumb trail like "home / dev .\} .nf our @extra_breadcrumbs = ( - [ \(aqhome\(aq => \(aqhttps://www\&.example\&.org/\(aq ], - [ \(aqdev\(aq => \(aqhttps://dev\&.example\&.org/\(aq ], + [ \*(Aqhome\*(Aq => \*(Aqhttps://www\&.example\&.org/\*(Aq ], + [ \*(Aqdev\*(Aq => \*(Aqhttps://dev\&.example\&.org/\*(Aq ], ); .fi .if n \{\ @@ -545,10 +545,10 @@ Gitweb assumes this charset when a line contains non\-UTF\-8 characters\&. The f .PP @diff_opts .RS 4 -Rename detection options for git\-diff and git\-diff\-tree\&. The default is (\(aq\-M\(aq); set it to (\(aq\-C\(aq) or (\(aq\-C\(aq, \(aq\-C\(aq) to also detect copies, or set it to () i\&.e\&. empty list if you don\(cqt want to have renames detection\&. +Rename detection options for git\-diff and git\-diff\-tree\&. The default is (\*(Aq\-M\*(Aq); set it to (\*(Aq\-C\*(Aq) or (\*(Aq\-C\*(Aq, \*(Aq\-C\*(Aq) to also detect copies, or set it to () i\&.e\&. empty list if you don\(cqt want to have renames detection\&. .sp \fBNote\fR -that rename and especially copy detection can be quite CPU\-intensive\&. Note also that non Git tools can have problems with patches generated with options mentioned above, especially when they involve file copies (\(aq\-C\(aq) or criss\-cross renames (\(aq\-B\(aq)\&. +that rename and especially copy detection can be quite CPU\-intensive\&. Note also that non Git tools can have problems with patches generated with options mentioned above, especially when they involve file copies (\*(Aq\-C\*(Aq) or criss\-cross renames (\*(Aq\-B\*(Aq)\&. .RE .SS "Some optional features and policies" .sp @@ -721,7 +721,7 @@ Some features cannot be overridden per project\&. For those features the structu .\} .sp .sp -As one can see it lacks the \(aqsub\(aq element\&. +As one can see it lacks the \*(Aqsub\*(Aq element\&. .sp The meaning of each part of feature configuration is described below: .PP @@ -731,7 +731,7 @@ List (array reference) of feature parameters (if there are any), used also to to .sp Note that it is currently \fBalways\fR -an array reference, even if feature doesn\(cqt accept any configuration parameters, and \(aqdefault\(aq is used only to turn it on or off\&. In such case you turn feature on by setting this element to +an array reference, even if feature doesn\(cqt accept any configuration parameters, and \*(Aqdefault\*(Aq is used only to turn it on or off\&. In such case you turn feature on by setting this element to \fB[1]\fR, and torn it off by setting it to \fB[0]\fR\&. See also the passage about the "blame" feature in the "Examples" section\&. .sp @@ -777,7 +777,7 @@ Enable and configure the "snapshot" action, which allows user to download a comp \fBgit-archive\fR(1) and possibly additionally compressed\&. This can potentially generate high traffic if you have large project\&. .sp -The value of \(aqdefault\(aq is a list of names of snapshot formats, defined in +The value of \*(Aqdefault\*(Aq is a list of names of snapshot formats, defined in \fB%known_snapshot_formats\fR hash, that you wish to offer\&. Supported formats include "tgz", "tbz2", "txz" (gzip/bzip2/xz compressed tar archive) and "zip"; please consult gitweb sources for a definitive list\&. By default only "tgz" is offered\&. .sp @@ -911,7 +911,7 @@ forks If this feature is enabled, gitweb considers projects in subdirectories of project root (basename) to be forks of existing projects\&. For each project \fB$projname\&.git\fR, projects in the \fB$projname/\fR -directory and its subdirectories will not be shown in the main projects list\&. Instead, a \(aq+\(aq mark is shown next to +directory and its subdirectories will not be shown in the main projects list\&. Instead, a \*(Aq+\*(Aq mark is shown next to \fB$projname\fR, which links to a "forks" view that lists all the forks (all projects in \fB$projname/\fR subdirectory)\&. Additionally a "forks" view for a project is linked from project summary page\&. @@ -932,7 +932,7 @@ expands to the project name, \fB%f\fR to the project path within the filesystem (i\&.e\&. "$projectroot/$project"), \fB%h\fR -to the current hash (\(aqh\(cq gitweb parameter) and \(oq%b` to the current hash base (\(aqhb\(cq gitweb parameter); \(oq%%` expands to \(aq%\(cq\&. +to the current hash (\*(Aqh\(cq gitweb parameter) and \(oq%b` to the current hash base (\*(Aqhb\(cq gitweb parameter); \(oq%%` expands to \*(Aq%\(cq\&. .sp For example, at the time this page was written, the \m[blue]\fBhttp://repo\&.or\&.cz\fR\m[] @@ -943,8 +943,8 @@ Git hosting site set it to the following to enable graphical log (using the thir .RS 4 .\} .nf -$feature{\(aqactions\(aq}{\(aqdefault\(aq} = - [ (\(aqgraphiclog\(aq, \(aq/git\-browser/by\-commit\&.html?r=%n\(aq, \(aqsummary\(aq)]; +$feature{\*(Aqactions\*(Aq}{\*(Aqdefault\*(Aq} = + [ (\*(Aqgraphiclog\*(Aq, \*(Aq/git\-browser/by\-commit\&.html?r=%n\*(Aq, \*(Aqsummary\*(Aq)]; .fi .if n \{\ .RE @@ -979,7 +979,7 @@ Typical gitweb config files will only change starting (default) time zone, and l .RS 4 .\} .nf -$feature{\(aqjavascript\-timezone\(aq}{\(aqdefault\(aq}[0] = "utc"; +$feature{\*(Aqjavascript\-timezone\*(Aq}{\*(Aqdefault\*(Aq}[0] = "utc"; .fi .if n \{\ .RE @@ -1000,8 +1000,8 @@ List of additional directories under "refs" which are going to be used as branch .RS 4 .\} .nf -$feature{\(aqextra\-branch\-refs\(aq}{\(aqdefault\(aq} = - [\(aqsandbox\(aq, \(aqwip\(aq, \(aqother\(aq]; +$feature{\*(Aqextra\-branch\-refs\*(Aq}{\*(Aqdefault\*(Aq} = + [\*(Aqsandbox\*(Aq, \*(Aqwip\*(Aq, \*(Aqother\*(Aq]; .fi .if n \{\ .RE @@ -1046,14 +1046,14 @@ To enable blame, pickaxe search, and snapshot support (allowing "tar\&.gz" and " .RS 4 .\} .nf -$feature{\(aqblame\(aq}{\(aqdefault\(aq} = [1]; -$feature{\(aqblame\(aq}{\(aqoverride\(aq} = 1; +$feature{\*(Aqblame\*(Aq}{\*(Aqdefault\*(Aq} = [1]; +$feature{\*(Aqblame\*(Aq}{\*(Aqoverride\*(Aq} = 1; -$feature{\(aqpickaxe\(aq}{\(aqdefault\(aq} = [1]; -$feature{\(aqpickaxe\(aq}{\(aqoverride\(aq} = 1; +$feature{\*(Aqpickaxe\*(Aq}{\*(Aqdefault\*(Aq} = [1]; +$feature{\*(Aqpickaxe\*(Aq}{\*(Aqoverride\*(Aq} = 1; -$feature{\(aqsnapshot\(aq}{\(aqdefault\(aq} = [\(aqzip\(aq, \(aqtgz\(aq]; -$feature{\(aqsnapshot\(aq}{\(aqoverride\(aq} = 1; +$feature{\*(Aqsnapshot\*(Aq}{\*(Aqdefault\*(Aq} = [\*(Aqzip\*(Aq, \*(Aqtgz\*(Aq]; +$feature{\*(Aqsnapshot\*(Aq}{\*(Aqoverride\*(Aq} = 1; .fi .if n \{\ .RE @@ -1066,8 +1066,8 @@ If you allow overriding for the snapshot feature, you can specify which snapshot .RS 4 .\} .nf -$known_snapshot_formats{\(aqzip\(aq}{\(aqdisabled\(aq} = 1; -$known_snapshot_formats{\(aqtgz\(aq}{\(aqcompressor\(aq} = [\(aqgzip\(aq,\(aq\-6\(aq]; +$known_snapshot_formats{\*(Aqzip\*(Aq}{\*(Aqdisabled\*(Aq} = 1; +$known_snapshot_formats{\*(Aqtgz\*(Aq}{\*(Aqcompressor\*(Aq} = [\*(Aqgzip\*(Aq,\*(Aq\-6\*(Aq]; .fi .if n \{\ .RE |