From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS3215 2.0.0.0/16 X-Spam-Status: No, score=-3.2 required=3.0 tests=AWL,BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from out2.migadu.com (out2.migadu.com [IPv6:2001:41d0:2:aacc::]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by dcvr.yhbt.net (Postfix) with ESMTPS id C038D1F5AE for ; Mon, 17 May 2021 03:35:54 +0000 (UTC) X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kyleam.com; s=key1; t=1621222553; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=BNYTU4fDIYTHzYPN3jJ/05hOzsah06zJE6ofKdBS7K8=; b=IWqm3T9BVWbhQ3tClnW5WGH+2sYWyGxOe1/6PDSMJNqP8ltWzd3P2tx12M3lH8ySq6RTlC lJuIjhU4IFkIkOEEHT2k//YW3u3WU/ypAfPfj1cz8DxYhFekyCaD+6Uqqvf6LCBt3WCiof a5K7+hqK5KJiOjhL0vwGvFCAW9ecfk84b3EA47NQy+4ldJ8MF0xVQEBGxg7aOC6L4D9S4E GXALA9n8dH5TJWUQKrVS8FqkMWIR6REigCMJu6pjyv/fAhbVuzN6U9Nw+dtJ3qjTd88zx2 1mNIht+aX4F6C9QZAPLXvyASHgtQPKKs+YdF/5CwBK2tj3/P72DFF6OjzXuWpw== From: Kyle Meyer To: meta@public-inbox.org Subject: [PATCH 7/9] doc lei: add manpage for convert Date: Sun, 16 May 2021 23:35:26 -0400 Message-Id: <20210517033528.18966-8-kyle@kyleam.com> In-Reply-To: <20210517033528.18966-1-kyle@kyleam.com> References: <20210517033528.18966-1-kyle@kyleam.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Migadu-Flow: FLOW_OUT X-Migadu-Auth-User: kyle@kyleam.com List-Id: Link: https://public-inbox.org/meta/20210429015738.GA30172@dcvr/ --- Documentation/lei-convert.pod | 73 +++++++++++++++++++++++++++++++++++ Documentation/lei.pod | 2 + Documentation/txt2pre | 1 + MANIFEST | 1 + Makefile.PL | 6 +-- 5 files changed, 80 insertions(+), 3 deletions(-) create mode 100644 Documentation/lei-convert.pod diff --git a/Documentation/lei-convert.pod b/Documentation/lei-convert.pod new file mode 100644 index 00000000..e8a71393 --- /dev/null +++ b/Documentation/lei-convert.pod @@ -0,0 +1,73 @@ +=head1 NAME + +lei-convert - one-time conversion from URL or filesystem to another format + +=head1 SYNOPSIS + +lei convert [OPTIONS] LOCATION + +lei convert [OPTIONS] (--stdin|-) + +=head1 DESCRIPTION + +Convert messages to another format. C is a source of +messages: a directory (Maildir), a file, or a URL (C, +C, C, or C). URLs requiring +authentication must use L and/or L to +fill in the username and password. + +For a regular file, the location must have a CformatE:> +prefix specifying one of the following formats: C, C, +C, C, or C. + +=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 is preferred. + +=back + +The following options are also supported and are described in +L. + +=over + +=item -o MFOLDER, --output=MFOLDER + +=item --lock METHOD + +=item --no-kw + +=item --no-import-remote + +=item --torsocks=auto|no|yes + +=item --no-torsocks + +=item --proxy=PROTO://HOST[:PORT] + +=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 diff --git a/Documentation/lei.pod b/Documentation/lei.pod index 58646577..78e1fb1e 100644 --- a/Documentation/lei.pod +++ b/Documentation/lei.pod @@ -84,6 +84,8 @@ Other subcommands include =item * L +=item * L + =item * L =item * L diff --git a/Documentation/txt2pre b/Documentation/txt2pre index 25d81cf9..201566ee 100755 --- a/Documentation/txt2pre +++ b/Documentation/txt2pre @@ -14,6 +14,7 @@ for (qw[lei(1) lei-add-external(1) lei-blob(1) lei-config(1) + lei-convert(1) lei-daemon-kill(1) lei-daemon-pid(1) lei-forget-external(1) diff --git a/MANIFEST b/MANIFEST index a6d94c77..29e62880 100644 --- a/MANIFEST +++ b/MANIFEST @@ -24,6 +24,7 @@ Documentation/include.mk Documentation/lei-add-external.pod Documentation/lei-blob.pod Documentation/lei-config.pod +Documentation/lei-convert.pod Documentation/lei-daemon-kill.pod Documentation/lei-daemon-pid.pod Documentation/lei-forget-external.pod diff --git a/Makefile.PL b/Makefile.PL index b06b6ab8..d149a164 100644 --- a/Makefile.PL +++ b/Makefile.PL @@ -45,9 +45,9 @@ $v->{-m1} = [ map { } } @EXE_FILES, qw( - lei-add-external lei-blob lei-config lei-daemon-kill lei-daemon-pid - lei-forget-external lei-import lei-init lei-ls-external lei-ls-label - lei-p2q lei-q lei-tag)]; + lei-add-external lei-blob lei-config lei-convert lei-daemon-kill + lei-daemon-pid lei-forget-external lei-import lei-init lei-ls-external + lei-ls-label lei-p2q lei-q lei-tag)]; $v->{-m5} = [ qw(public-inbox-config public-inbox-v1-format public-inbox-v2-format public-inbox-extindex-format lei-mail-formats lei-store-format -- 2.31.1