Documentation/gitpacking: make sample configs listing blocks
This document contains a few sample config snippets. At least with Asciidoctor, the section headers are rendered *more* indented than the variables that follow: [bitmapPseudoMerge "all"] pattern = "refs/" ... To address this, wrap these listings in AsciiDoc listing blocks. Remove the indentation from the section headings. This is similar to how we handle such sample config elsewhere, e.g., in config.txt. While we're here, fix the nearby "wiht" typo. Signed-off-by: Martin Ågren <martin.agren@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Martin Ågren committed
Jul 17, 2024 at 12:54 UTC
df8b05672c08ace3db9da80fb2d7cab559fa9a5e
1 file changed
+10
-4
Documentation/gitpacking.txt
+10
-4
@@ -143,14 +143,16 @@ include::config/bitmap-pseudo-merge.txt[]
143
Suppose that you have a repository with a large number of references,
144
and you want a bare-bones configuration of pseudo-merge bitmaps that
145
will enhance bitmap coverage of the `refs/` namespace. You may start
146
-wiht a configuration like so:
146
+with a configuration like so:
147
148
- [bitmapPseudoMerge "all"]
148
+----
149
+[bitmapPseudoMerge "all"]
150
pattern = "refs/"
151
threshold = now
152
stableThreshold = never
153
sampleRate = 100
154
maxMerges = 64
155
+----
156
157
This will create pseudo-merge bitmaps for all references, regardless of
158
their age, and group them into 64 pseudo-merge commits.
@@ -159,8 +161,10 @@ If you wanted to separate tags from branches when generating
161
pseudo-merge commits, you would instead define the pattern with a
162
capture group, like so:
163
162
- [bitmapPseudoMerge "all"]
164
+----
165
+[bitmapPseudoMerge "all"]
166
pattern = "refs/(heads/tags)/"
167
+----
168
169
Suppose instead that you are working in a fork-network repository, with
170
each fork specified by some numeric ID, and whose refs reside in
@@ -168,12 +172,14 @@ each fork specified by some numeric ID, and whose refs reside in
172
fork) in the network. In this instance, you may instead write something
173
like:
174
171
- [bitmapPseudoMerge "all"]
175
+----
176
+[bitmapPseudoMerge "all"]
177
pattern = "refs/virtual/([0-9]+)/(heads|tags)/"
178
threshold = now
179
stableThreshold = never
180
sampleRate = 100
181
maxMerges = 64
182
+----
183
184
Which would generate pseudo-merge group identifiers like "1234-heads",
185
and "5678-tags" (for branches in fork "1234", and tags in remote "5678",