diff options
| author | Junio C Hamano <gitster@pobox.com> | 2024-07-18 08:30:27 -0700 |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2024-07-18 08:30:27 -0700 |
| commit | d07b5d9ad590657e0225fe3ddcb761046c3304b0 (patch) | |
| tree | a070f46648505b301f6069e55a0654628c7a3155 | |
| parent | Merge branch 'ps/pseudo-ref-terminology' (diff) | |
| parent | Documentation/gitpacking: make sample configs listing blocks (diff) | |
| download | git-d07b5d9ad590657e0225fe3ddcb761046c3304b0.tar.gz git-d07b5d9ad590657e0225fe3ddcb761046c3304b0.zip | |
Merge branch 'tb/pseudo-merge-reachability-bitmap'
Doc update.
* tb/pseudo-merge-reachability-bitmap:
Documentation/gitpacking: make sample configs listing blocks
| -rw-r--r-- | Documentation/gitpacking.txt | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/Documentation/gitpacking.txt b/Documentation/gitpacking.txt index 4a6fcba6f7..321154d4e6 100644 --- a/Documentation/gitpacking.txt +++ b/Documentation/gitpacking.txt @@ -143,14 +143,16 @@ include::config/bitmap-pseudo-merge.txt[] Suppose that you have a repository with a large number of references, and you want a bare-bones configuration of pseudo-merge bitmaps that will enhance bitmap coverage of the `refs/` namespace. You may start -wiht a configuration like so: +with a configuration like so: - [bitmapPseudoMerge "all"] +---- +[bitmapPseudoMerge "all"] pattern = "refs/" threshold = now stableThreshold = never sampleRate = 100 maxMerges = 64 +---- This will create pseudo-merge bitmaps for all references, regardless of their age, and group them into 64 pseudo-merge commits. @@ -159,8 +161,10 @@ If you wanted to separate tags from branches when generating pseudo-merge commits, you would instead define the pattern with a capture group, like so: - [bitmapPseudoMerge "all"] +---- +[bitmapPseudoMerge "all"] pattern = "refs/(heads/tags)/" +---- Suppose instead that you are working in a fork-network repository, with 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 fork) in the network. In this instance, you may instead write something like: - [bitmapPseudoMerge "all"] +---- +[bitmapPseudoMerge "all"] pattern = "refs/virtual/([0-9]+)/(heads|tags)/" threshold = now stableThreshold = never sampleRate = 100 maxMerges = 64 +---- Which would generate pseudo-merge group identifiers like "1234-heads", and "5678-tags" (for branches in fork "1234", and tags in remote "5678", |