about summary refs log tree commit homepage
path: root/Documentation/lei-up.pod
blob: 8fba0953b1ef4948bb089da6b777b95e2b3b5d7f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
=head1 NAME

lei-up - update a saved search

=head1 SYNOPSIS

lei up [OPTIONS] OUTPUT

lei up [OPTIONS] --all[=<local|remote>]

=head1 DESCRIPTION

Update the saved search at C<OUTPUT> or all saved searches.

=head1 OPTIONS

=over

=item --all[=<local|remote>]

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

=item --no-external

=item --no-local

=item --no-remote

These disable the use of all externals, local externals, or
remote externals respectively.  They are useful during
temporary network or mount-point outages.

Unlike C<lei q>, these switches override the original C<lei q --only>
options saved as C<lei.q.only>.

The combination C<--all=remote --no-remote> is supported for
offline use in case a user is updating an IMAP folder on localhost.

=item --exclude=LOCATION

As with L<lei-q(1)>, but may also exclude externals originally
specified via C<lei q --only>.

=item --lock=METHOD

=item --alert=CMD

=item --mua=CMD

C<--lock>, C<--alert>, and C<--mua> are all supported and
documented in L<lei-q(1)>.

C<--mua> is incompatible with C<--all>.

=back

=head1 CONTACT

Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>

The mail archives are hosted at L<https://public-inbox.org/meta/>
and L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>

=head1 COPYRIGHT

Copyright all contributors L<mailto:meta@public-inbox.org>

License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>

=head1 SEE ALSO

L<lei-q(1)>, L<lei-ls-search(1)>, L<lei-edit-search(1)>,
L<lei-forget-search(1)>