debian/notmuch
1
0
Fork 0
mirror of https://git.notmuchmail.org/git/notmuch synced 2024-11-22 02:48:08 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

doc: Clarify notmuch show --format=raw description

Browse source 
In addition to being generally more precise, this is explicit that
there is no charset conversion.
This commit is contained in:
Austin Clements 2014-04-18 18:42:05 -04:00 committed by David Bremner
parent ae2888015e
commit 56871c628b
1 changed files with 18 additions and 14 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
doc/man1/notmuch-show.rst
View file

@ -76,22 +76,22 @@ Supported options for **show** include
http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/mail-mbox-formats.html http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/mail-mbox-formats.html
**raw** (default for a single part, see --part) **raw** (default if --part is given)
For a message or an attached message part, the original, raw Write the raw bytes of the given MIME part of a message to
content of the email message is output. Consumers of this standard out. For this format, it is an error to specify a
format should expect to implement MIME decoding and similar query that matches more than one message.
functions.
For a single part (--part) the raw part content is output If the specified part is a leaf part, this outputs the
after performing any necessary MIME decoding. Note that body of the part after performing content transfer
messages with a simple body still have two parts: part 0 is decoding (but no charset conversion). This is suitable for
the whole message and part 1 is the body. saving attachments, for example.
For a multipart part, the part headers and body (including For a multipart or message part, the output includes the
all child parts) is output. part headers as well as the body (including all child
parts). No decoding is performed because multipart and
The raw format must only be used with search terms matching message parts cannot have non-trivial content transfer
single message. encoding. Consumers of this may need to implement MIME
decoding and similar functions.
``--format-version=N`` ``--format-version=N``
Use the specified structured output format version. This is Use the specified structured output format version. This is
@ -105,6 +105,10 @@ Supported options for **show** include
and are identified in the 'json', 'sexp' or 'text' output and are identified in the 'json', 'sexp' or 'text' output
formats. formats.
Note that even a message with no MIME structure or a single
body part still has two MIME parts: part 0 is the whole
message (headers and body) and part 1 is just the body.
``--verify`` ``--verify``
Compute and report the validity of any MIME cryptographic Compute and report the validity of any MIME cryptographic
signatures found in the selected content (ie. "multipart/signed" signatures found in the selected content (ie. "multipart/signed"