diff options
author | Eric Wong <e@80x24.org> | 2021-09-24 10:56:41 +0000 |
---|---|---|
committer | Eric Wong <e@80x24.org> | 2021-09-24 23:22:05 +0000 |
commit | 69b5ab18a594fa434d79cacee35c4d9a0df7b55c (patch) | |
tree | 051f0118b39ff5e5f59c177e7cde5c936eb90513 /Documentation/lei-add-external.pod | |
parent | b319bb7276457d01ab4bc779d867368f884bd522 (diff) | |
download | public-inbox-69b5ab18a594fa434d79cacee35c4d9a0df7b55c.tar.gz |
Partial (v2) clones should be useful addition for users wanting to conserve storage while having fast access to recent messages. Continuing work started in 876e74283ff3 (fetch: ignore non-writable epoch dirs, 2021-09-17), this creates bare, read-only epoch git repos. These git repos have the remotes pre-configured, but does not fetch any objects. The goal is to allow users to set the writable bit on a previously-skipped epoch and start fetching it. Shell completion support may not be necessary given how short the epoch ranges are, here. Cc: Luis Chamberlain <mcgrof@kernel.org> Link: https://public-inbox.org/meta/20210917002204.GA13112@dcvr/T/#u
Diffstat (limited to 'Documentation/lei-add-external.pod')
-rw-r--r-- | Documentation/lei-add-external.pod | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/Documentation/lei-add-external.pod b/Documentation/lei-add-external.pod index 9c8bde0f..1ab65a16 100644 --- a/Documentation/lei-add-external.pod +++ b/Documentation/lei-add-external.pod @@ -30,6 +30,21 @@ Default: 0 Create C<LOCATION> by mirroring the public-inbox at C<URL>. +=item --epoch=RANGE + +Restrict clones of L<public-inbox-v2-format(5)> inboxes to the +given range of epochs. The range may be a single non-negative +integer or a (possibly open-ended) C<LOW..HIGH> range of +non-negative integers. C<~> may be prefixed to either (or both) +integer values to represent the offset from the maximum possible +value. + +For example, C<--epoch=~0> alone clones only the latest epoch, +C<--epoch=~2..> clones the three latest epochs. + +Default: C<0..~0> or C<0..> or C<..~0> +(all epochs, all three examples are equivalent) + =item -v =item --verbose |