From 69b5ab18a594fa434d79cacee35c4d9a0df7b55c Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Fri, 24 Sep 2021 10:56:41 +0000 Subject: clone|--mirror: support --epoch=RANGE for partial clones 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 Link: https://public-inbox.org/meta/20210917002204.GA13112@dcvr/T/#u --- Documentation/public-inbox-clone.pod | 15 +++++++++++++++ 1 file changed, 15 insertions(+) (limited to 'Documentation/public-inbox-clone.pod') diff --git a/Documentation/public-inbox-clone.pod b/Documentation/public-inbox-clone.pod index fdb57663..efee01ee 100644 --- a/Documentation/public-inbox-clone.pod +++ b/Documentation/public-inbox-clone.pod @@ -31,6 +31,21 @@ file to speed up subsequent L. =over +=item --epoch=RANGE + +Restrict clones of L inboxes to the +given range of epochs. The range may be a single non-negative +integer or a (possibly open-ended) C 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 -q =item --quiet -- cgit v1.2.3-24-ge0c7