lei q [OPTIONS] TERM [TERM...]
-lei q [OPTIONS] --stdin
+lei q [OPTIONS] (--stdin|-)
=head1 DESCRIPTION
Search for messages across the lei store and externals.
+=for comment
TODO: Give common prefixes, or at least a description/reference.
=head1 OPTIONS
+=for comment
TODO: mention curl options?
=over
=item -o MFOLDER, --output=MFOLDER, --mfolder=MFOLDER
+Warning: this clobbers and overwrites the output destination unless
+L</-a, --augment> is specified.
+
Destination for results (e.g., C<path/to/Maildir>,
C<imaps://user@mail.example.com/INBOX.test>, or
C<mboxcl2:path/to/mbox>). The prefix may be a supported protocol:
-C<imap://>, C<imaps://>, C<nntp://>, or C<nntps://>. URLs requiring
+C<imap://> or C<imaps://>. URLs requiring
authentication must use L<netrc(5)> and/or L<git-credential(1)> to
fill in the username and password.
(stdout), and C<maildir> is used for an existing directory or
non-existing path.
+=for comment
TODO: Provide description of formats?
-Default: -
+Default: C<-> (stdout)
=item -f FORMAT, --format=FORMAT
Augment output destination instead of clobbering it.
+=item --no-import-before
+
+Do not importing keywords before writing to an existing output
+destination.
+
=item -t, --threads
Return all messages in the same thread as the actual match(es).
Using this twice (C<-tt>) sets the C<flagged> (AKA "important")
-on messages which were actual messages. This is useful to distinguish
+on messages which were actual matches. This is useful to distinguish
messages which were direct hits from messages which were merely part
of the same thread.
Default: C<content>
+=for comment
TODO: Provide description of strategies?
=item --[no-]remote