diff options
author | Kyle Meyer <kyle@kyleam.com> | 2021-02-22 22:45:52 -0500 |
---|---|---|
committer | Eric Wong <e@80x24.org> | 2021-02-23 01:51:46 -0400 |
commit | 56b3493c79087979f10f5a3cae7deedaf4ec9fa3 (patch) | |
tree | 9d21bc5dc44497bf7baa2b97580071de654d327d /Documentation/lei-q.pod | |
parent | c1ad789a90c274f9912d53bb1c7f1a3cc07cb233 (diff) | |
download | public-inbox-56b3493c79087979f10f5a3cae7deedaf4ec9fa3.tar.gz |
The --format argument is redundant and may be dropped entirely. Update the lei manpages to prefer the format prefix. cf. https://public-inbox.org/meta/20210217044032.GA17934@dcvr/
Diffstat (limited to 'Documentation/lei-q.pod')
-rw-r--r-- | Documentation/lei-q.pod | 20 |
1 files changed, 14 insertions, 6 deletions
diff --git a/Documentation/lei-q.pod b/Documentation/lei-q.pod index c8df6fc7..75fdc613 100644 --- a/Documentation/lei-q.pod +++ b/Documentation/lei-q.pod @@ -26,17 +26,25 @@ Read search terms from stdin. =item -o MFOLDER, --output=MFOLDER, --mfolder=MFOLDER -Destination for results (e.g., C<path/to/Maildir> or - for stdout). +Destination for results (e.g., C<path/to/Maildir> or +C<mboxcl2:path/to/mbox>). The format can be specified by adding a +C<E<lt>formatE<gt>:> prefix with any of these values: C<maildir>, +C<mboxrd>, C<mboxcl2>, C<mboxcl>, C<mboxo>, C<json>, C<jsonl>, or +C<concatjson>. + +TODO: Provide description of formats? + +When a format isn't specified, it's chosen based on the destination. +C<json> is used for the default destination (stdout), and C<maildir> +is used for an existing directory or non-existing path. Default: - =item -f FORMAT, --format=FORMAT -Format of results: C<maildir>, C<mboxrd>, C<mboxcl2>, C<mboxcl>, -C<mboxo>, C<json>, C<jsonl>, or C<concatjson>. The default format -used depends on C<--output>. - -TODO: Provide description of formats? +Format of results. This option exists as a convenient way to specify +the format for the default stdout destination. Using a C<format:> +prefix with the C<--output> destination is preferred otherwise. =item --pretty |