diff options
Diffstat (limited to 'Documentation/lei-import.pod')
-rw-r--r-- | Documentation/lei-import.pod | 34 |
1 files changed, 28 insertions, 6 deletions
diff --git a/Documentation/lei-import.pod b/Documentation/lei-import.pod index 9322dfa8..25f1daf5 100644 --- a/Documentation/lei-import.pod +++ b/Documentation/lei-import.pod @@ -4,7 +4,7 @@ lei-import - one-time import of messages into local store =head1 SYNOPSIS -lei import [OPTIONS] LOCATION [LOCATION...] +lei import [OPTIONS] LOCATION [LOCATION...] [+L:LABEL] lei import [OPTIONS] (--stdin|-) @@ -16,8 +16,8 @@ source of messages: a directory (Maildir), a file, or a URL authentication use L<git-credential(1)> to fill in the username and password. -For a regular file, the location must have a C<E<lt>formatE<gt>:> -prefix specifying one of the following formats: C<eml>, C<mboxrd>, +For a regular file, the C<LOCATION> must have a C<E<lt>formatE<gt>:> +prefix specifying one of the following formats: C<mboxrd>, C<mboxcl2>, C<mboxcl>, or C<mboxo>. =head1 OPTIONS @@ -42,6 +42,29 @@ C<none>. Default: fcntl,dotlock +=item +L:LABEL + +Add the given C<LABEL> to all messages imported, where C<LABEL> +is an arbitrary user-defined value consisting of lowercase and digits. +See L<lei-tag(1)> for more info on labels. + +For example, specifying C<+L:inbox> applies the C<inbox> label +to all messages being imported. + +May be specified multiple times to apply multiple labels. + +Default: none + +=item +kw:KEYWORD + +Apply C<KEYWORD> to all messages being imported in addition +to any per-message keywords from the store (unless C<--no-kw> +is specified). See L<lei-tag(1)> for more info on keywords. + +May be specified multiple times to apply multiple keywords. + +Default: none + =item --no-kw Don't import message keywords (or "flags" in IMAP terminology). @@ -73,11 +96,10 @@ L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/> =head1 COPYRIGHT -Copyright 2021 all contributors L<mailto:meta@public-inbox.org> +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-add-external(1)> +L<lei-index(1)> |