about summary refs log tree commit homepage
path: root/Documentation
diff options
context:
space:
mode:
authorEric Wong <e@80x24.org>2021-09-18 09:33:32 +0000
committerEric Wong <e@80x24.org>2021-09-18 20:28:16 +0000
commitf3d0e746c6a35c8600b91af99958a52cbc114a4b (patch)
tree77d4a48575562c953f4bb1de8c1455fa749391b9 /Documentation
parent9d54d6260497a2a08bdefd25f02e817ad6505264 (diff)
downloadpublic-inbox-f3d0e746c6a35c8600b91af99958a52cbc114a4b.tar.gz
Since we can't use maxuid for remote externals, automatically
maintaining the last time we got results and appending a dt:
range to the query will prevent HTTP(S) responses from getting
too big.

We could be using "rt:", but no stable release of public-inbox
supports it, yet, so we'll use dt:, instead.

By default, there's a two day fudge factor to account for MTA
downtime and delays; which is hopefully enough.  The fudge
factor may be changed per-invocation with the
--remote-fudge-factor=INTERVAL option

Since different externals can have different message transport
routes, "lastresult" entries are stored on a per-external basis.
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/lei-up.pod15
1 files changed, 15 insertions, 0 deletions
diff --git a/Documentation/lei-up.pod b/Documentation/lei-up.pod
index e5d97f43..f06ee5eb 100644
--- a/Documentation/lei-up.pod
+++ b/Documentation/lei-up.pod
@@ -22,6 +22,21 @@ C<--all> updates all saved searches (listed in L<lei-ls-search(1)>).
 C<--all=local> only updates local mailboxes, C<--all=remote> only
 updates remote mailboxes (currently C<imap://> and C<imaps://>).
 
+=item --remote-fudge-time=INTERVAL
+
+Look for mail older than the time of the last successful query.
+Using a small interval will reduce bandwidth use.  A larger
+interval reduces the likelyhood of missing a result due to MTA
+delays or downtime.
+
+The time(s) of the last successful queries are the C<lastresult>
+values visible from L<lei-edit-search(1)>.
+
+Date formats understood by L<git-rev-parse(1)> may be used.
+e.g C<1.hour> or C<3.days>
+
+Default: 2.days
+
 =back
 
 The following options, described in L<lei-q(1)>, are supported.