aboutsummaryrefslogtreecommitdiff
path: root/docs/cmdline-opts
diff options
context:
space:
mode:
authorPatrick Monnerat <patrick@monnerat.net>2017-09-05 17:11:59 +0100
committerPatrick Monnerat <patrick@monnerat.net>2017-09-05 17:55:51 +0100
commit63ef436ea15dd93343a2040ffb7c3bb2c9681b87 (patch)
tree3d60cf99bb9f54b2511a711b7f2fb4dad15136fd /docs/cmdline-opts
parent3bbe894fd26114e6835c697008b61beeffd084bf (diff)
mime: implement encoders.
curl_mime_encoder() is operational and documented. curl tool -F option is extended with ";encoder=". curl tool --libcurl option generates calls to curl_mime_encoder(). New encoder tests 648 & 649. Test 1404 extended with an encoder specification.
Diffstat (limited to 'docs/cmdline-opts')
-rw-r--r--docs/cmdline-opts/form.d14
1 files changed, 14 insertions, 0 deletions
diff --git a/docs/cmdline-opts/form.d b/docs/cmdline-opts/form.d
index 14261d3ad..232d30c07 100644
--- a/docs/cmdline-opts/form.d
+++ b/docs/cmdline-opts/form.d
@@ -101,6 +101,20 @@ text file:
.br
-F '=)' -F '=@textfile.txt' ... smtp://example.com
+Data can be encoded for transfer using encoder=. Available encodings are
+\fIbinary\fP and \fI8bit\fP that do nothing else than adding the corresponding
+Content-Transfer-Encoding header, \fI7bit\fP that only rejects 8-bit characters
+with a transfer error, \fIquoted-printable\fP and \fIbase64\fP that encodes
+data according to the corresponding schemes, limiting lines length to
+76 characters.
+
+Example: send multipart mail with a quoted-printable text message and a
+base64 attached file:
+
+ curl -F '=text message;encoder=quoted-printable' \\
+.br
+ -F '=@localfile;encoder=base64' ... smtp://example.com
+
See further examples and details in the MANUAL.
This option can be used multiple times.