doc: Simplify and clarify notmuch show --format=sexp description

Previously, this was a verbatim copy of the --format=json text.
Change it to instead reference the JSON text and actually describe how
the S-expression format works.
This commit is contained in:
Austin Clements 2014-04-18 18:42:08 -04:00 committed by David Bremner
parent a39a69ca0f
commit 827a69f639

View file

@ -57,14 +57,12 @@ Supported options for **show** include
UTF-8. UTF-8.
**sexp** **sexp**
The output is formatted as an S-Expression (sexp). This The output is formatted as the Lisp s-expression (sexp)
format is more robust than the text format for automated equivalent of the JSON format above. Objects are formatted
processing. The nested structure of multipart MIME messages as property lists whose keys are keywords (symbols preceded
is reflected in nested S-Expression output. By default, by a colon). True is formatted as ``t`` and both false and
S-Expression output includes all messages in a matching null are formatted as ``nil``. As for JSON, the s-expression
thread; that is, by default, output is always encoded as UTF-8.
``--format=sexp`` sets ``--entire-thread``. The caller can
disable this behaviour by setting ``--entire-thread=false``.
**mbox** **mbox**
All matching messages are output in the traditional, Unix All matching messages are output in the traditional, Unix