aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMark Walters <markwalters1009@gmail.com>2012-07-24 19:23:29 +0100
committerDavid Bremner <bremner@debian.org>2012-07-24 15:49:21 -0300
commit52e50f78238fe1b2ed46fabcb203b37048a3ae44 (patch)
tree9fcd17faca5cb0669ddfc6443eb68d6b15fbff33
parent3ea77f9f1fbc4781da29d9eee2e92e6c143e7a4a (diff)
man: update man page for the new --body=true|false option
-rw-r--r--man/man1/notmuch-show.116
1 files changed, 16 insertions, 0 deletions
diff --git a/man/man1/notmuch-show.1 b/man/man1/notmuch-show.1
index b51a54c..506583a 100644
--- a/man/man1/notmuch-show.1
+++ b/man/man1/notmuch-show.1
@@ -152,6 +152,22 @@ The default is
.RE
+.RS 4
+.TP 4
+.B \-\-body=(true|false)
+
+If true (the default)
+.B notmuch show
+includes the bodies of the messages in the output; if false,
+bodies are omitted.
+.B --body=false
+is only implemented for the json format and it is incompatible with
+.B --part > 0.
+
+This is useful if the caller only needs the headers as body-less
+output is much faster and substantially smaller.
+.RE
+
A common use of
.B notmuch show
is to display a single thread of email messages. For this, use a