diff options
author | Eric Wong <e@80x24.org> | 2021-09-24 12:51:09 +0000 |
---|---|---|
committer | Eric Wong <e@80x24.org> | 2021-09-25 03:22:04 +0000 |
commit | 3ecfe7b4d2bfc24a38076b628ee81ec4589af5d8 (patch) | |
tree | f916a01916425d8c60aae19559edcad4279c6204 | |
parent | 2074d96eaa930e330624786b13e7cfebeebb1b2d (diff) | |
download | public-inbox-3ecfe7b4d2bfc24a38076b628ee81ec4589af5d8.tar.gz |
Something is better than nothing.
-rw-r--r-- | Documentation/lei-export-kw.pod | 52 | ||||
-rw-r--r-- | Documentation/lei-refresh-mail-sync.pod | 57 | ||||
-rw-r--r-- | MANIFEST | 2 | ||||
-rw-r--r-- | Makefile.PL | 5 |
4 files changed, 115 insertions, 1 deletions
diff --git a/Documentation/lei-export-kw.pod b/Documentation/lei-export-kw.pod new file mode 100644 index 00000000..cf482ca0 --- /dev/null +++ b/Documentation/lei-export-kw.pod @@ -0,0 +1,52 @@ +=head1 NAME + +lei-export-kw - export keywords (flags) to Maildir and IMAP folders + +=head1 SYNOPSIS + +lei export-kw --all=[<remote|local>] + +lei export-kw MFOLDER [MFOLDER...] + +=head1 DESCRIPTION + +C<lei export-kw> propagates keywords (e.g. C<seen>, C<answered>, +C<flagged>, etc.) from lei/store to IMAP folders and/or Maildirs. + +It does not delete, write, nor modify messages themselves; +it only sets metadata on Maildirs and IMAP folders. + +=head1 OPTIONS + +=over + +=item --all + +Export to all local Maildirs and remote IMAP folders + +=item --all=local + +Export all local Maildirs + +=item --all=remote + +Export all remote IMAP folders + +=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-refresh-mail-sync(1)>, L<lei-tag(1)> diff --git a/Documentation/lei-refresh-mail-sync.pod b/Documentation/lei-refresh-mail-sync.pod new file mode 100644 index 00000000..aefd516f --- /dev/null +++ b/Documentation/lei-refresh-mail-sync.pod @@ -0,0 +1,57 @@ +=head1 NAME + +lei-refresh-mail-sync - refresh sync info with Maildir, IMAP + +=head1 SYNOPSIS + +lei refresh-mail-sync --all[=<remote|local>] + +lei refresh-mail-sync MFOLDER [MFOLDER...] + +=head1 DESCRIPTION + +C<lei refresh-mail-sync> is intended to to keep old messages +indexed with L<lei-index(1)> retrievable if Maildir flags change +a filename. It will prune invalid entries for messages which no +longer exist in a Maildir. + +It is also useful for ensuring L<lei-export-kw(1)> can propagate +keyword (flag) changes to Maildirs and IMAP folders. + +It only needs read-only access to Maildirs and IMAP folders +and will not attempt to write to them at all. + +=head1 OPTIONS + +=over + +=item --all + +Refresh all local Maildirs and remote IMAP folders + +=item --all=local + +Refresh all local Maildirs + +=item --all=remote + +Refresh all remote IMAP folders + +=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-index(1)>, L<lei-export-kw(1)> @@ -28,6 +28,7 @@ Documentation/lei-convert.pod Documentation/lei-daemon-kill.pod Documentation/lei-daemon-pid.pod Documentation/lei-edit-search.pod +Documentation/lei-export-kw.pod Documentation/lei-forget-external.pod Documentation/lei-forget-search.pod Documentation/lei-import.pod @@ -43,6 +44,7 @@ Documentation/lei-overview.pod Documentation/lei-p2q.pod Documentation/lei-q.pod Documentation/lei-rediff.pod +Documentation/lei-refresh-mail-sync.pod Documentation/lei-rm.pod Documentation/lei-security.pod Documentation/lei-store-format.pod diff --git a/Makefile.PL b/Makefile.PL index f56445ae..00a558d1 100644 --- a/Makefile.PL +++ b/Makefile.PL @@ -46,9 +46,12 @@ $v->{-m1} = [ map { } @EXE_FILES, qw( lei-add-external lei-blob lei-config lei-convert lei-edit-search + lei-export-kw lei-daemon-kill lei-daemon-pid lei-forget-external lei-forget-search lei-import lei-index lei-init lei-lcat lei-ls-external lei-ls-label - lei-ls-mail-sync lei-ls-search lei-p2q lei-q lei-rediff lei-rm lei-tag + lei-ls-mail-sync lei-ls-search lei-p2q lei-q lei-rediff + lei-refresh-mail-sync + lei-rm lei-tag lei-up)]; $v->{-m5} = [ qw(public-inbox-config public-inbox-v1-format public-inbox-v2-format public-inbox-extindex-format |