diff options
Diffstat (limited to 'Documentation/lei-import.pod')
-rw-r--r-- | Documentation/lei-import.pod | 111 |
1 files changed, 111 insertions, 0 deletions
diff --git a/Documentation/lei-import.pod b/Documentation/lei-import.pod new file mode 100644 index 00000000..31d6db13 --- /dev/null +++ b/Documentation/lei-import.pod @@ -0,0 +1,111 @@ +=head1 NAME + +lei-import - one-time import of messages into local store + +=head1 SYNOPSIS + +lei import [OPTIONS] LOCATION [LOCATION...] [+L:LABEL] + +lei import [OPTIONS] (--stdin|-) + +=head1 DESCRIPTION + +Import messages into the local storage of L<lei(1)> +(aka L<leiE<sol>store|lei-store-format(5)>). C<LOCATION> is a +source of messages: a directory (Maildir), a file, or a URL +(C<imap://>, C<imaps://>, C<nntp://>, or C<nntps://>). URLs requiring +authentication use L<git-credential(1)> to +fill in the username and password. + +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 + +=over + +=item -F MAIL_FORMAT + +=item --in-format=MAIL_FORMAT + +Message input format. Unless messages are given on stdin, using a +format prefix with C<LOCATION> is preferred. + +=item --stdin + +Read messages from stdin. + +=item --lock + +L<mbox(5)> locking method(s) to use: C<dotlock>, C<fcntl>, C<flock> or +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). + +=item --no-incremental + +Import already seen IMAP and NNTP articles. + +=item --torsocks=auto|no|yes + +=item --no-torsocks + +Whether to wrap L<git(1)> and L<curl(1)> commands with L<torsocks(1)>. + +Default: C<auto> + +=item --proxy=PROTOCOL://HOST[:PORT] + +Use the specified proxy (e.g., C<socks5h://0:9050>). + +Consider L<imap.proxy> and L<nntp.proxy> which can be persistently +configured on a per-host basis in L<lei-config(1)>. + +=back + +See L<lei-config(1)> for various C<imap.*> and C<nntp.*> options. + +=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-config(1)>, L<lei-index(1)>, L<lei-store-format(5)> |