From f310a5054fb8e215885f0b48afac44ff32ca1d56 Mon Sep 17 00:00:00 2001 From: Kyle Meyer Date: Wed, 10 Feb 2021 23:04:15 -0500 Subject: doc: lei: update manpages Catch up with recent developments. --- Documentation/lei-q.pod | 44 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 44 insertions(+) (limited to 'Documentation/lei-q.pod') diff --git a/Documentation/lei-q.pod b/Documentation/lei-q.pod index 405cf48f..c8df6fc7 100644 --- a/Documentation/lei-q.pod +++ b/Documentation/lei-q.pod @@ -6,6 +6,8 @@ lei-q - search for messages matching terms lei q [OPTIONS] TERM [TERM...] +lei q [OPTIONS] --stdin + =head1 DESCRIPTION Search for messages across the lei store and externals. @@ -14,8 +16,14 @@ 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). @@ -43,6 +51,18 @@ 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. @@ -74,6 +94,26 @@ Limit operations to those requiring network access. 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. @@ -101,6 +141,10 @@ Default: C 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. -- cgit v1.2.3-24-ge0c7