=head1 NAME lei-q - search for messages matching terms =head1 SYNOPSIS lei q [OPTIONS] TERM [TERM...] lei q [OPTIONS] --stdin =head1 DESCRIPTION Search for messages across the lei store and externals. TODO: Give common prefixes, or at least a description/reference. =head1 OPTIONS TODO: mention curl options? =over =item --stdin Read search terms from stdin. =item -o MFOLDER, --output=MFOLDER, --mfolder=MFOLDER Destination for results (e.g., C or - for stdout). Default: - =item -f FORMAT, --format=FORMAT Format of results: C, C, C, C, C, C, C, or C. The default format used depends on C<--output>. TODO: Provide description of formats? =item --pretty Pretty print C or C output. If stdout is opened to a tty and used as the C<--output> destination, C<--pretty> is enabled by default. =item --mua=COMMAND A command to run on C<--output> Maildir or mbox (e.g., C). For a subset of MUAs known to accept a mailbox via C<-f>, COMMAND can be abbreviated to the name of the program: C, C, C, or C. =item --alert=COMMAND[,COMMAND...] Run C after writing to output. C<:WINCH> indicates to send C to the C<--mua> process. C<:bell> indicates to print a bell code. Any other value is interpreted as a command to execute as is. This option may be given multiple times. Default: C<:WINCH,:bell> when C<--mua> is specified and C<--output> doesn't point to stdout, nothing otherwise. =item -a, --augment Augment output destination instead of clobbering it. =item -t, --threads Return all messages in the same thread as the actual match(es). =item -d STRATEGY, --dedupe=STRATEGY Strategy for deduplicating messages: C, C, C, or C. Default: C TODO: Provide description of strategies? =item --[no-]remote Whether to include results requiring network access. When local externals are configured, C<--remote> must be explicitly passed to enable reporting of results from remote externals. =item --no-local Limit operations to those requiring network access. =item --no-external Don't include results from externals. =item -I LOCATION, --include=LOCATION Include specified external in search. This option may be given multiple times. =item --exclude=LOCATION Exclude specified external from search. This option may be given multiple times. =item --only=LOCATION Use only the specified external for search. This option may be given multiple times, in which case the search uses only the specified set. =item -g, --globoff Do not match locations using C<*?> wildcards and C<[]> ranges. This option applies to C<--include>, C<--exclude>, and C<--only>. =item -NUMBER, -n NUMBER, --limit=NUMBER Limit the number of matches. Default: 10000 =item --offset=NUMBER Shift start of search results. Default: 0 =item -r, --reverse Reverse the results. Note that this applies before C<--limit>. =item -s KEY, --sort=KEY Order the results by KEY. Valid keys are C, C, and C. Default: C =item -v, --verbose Provide more feedback on stderr. =item -q, --quiet Suppress feedback messages. =item --torsocks=auto|no|yes, --no-torsocks Whether to wrap L and L commands with torsocks. Default: C =back =head1 CONTACT Feedback welcome via plain-text mail to L The mail archives are hosted at L and L =head1 COPYRIGHT Copyright 2021 all contributors L License: AGPL-3.0+ L =head1 SEE ALSO L, L