From 52e50f78238fe1b2ed46fabcb203b37048a3ae44 Mon Sep 17 00:00:00 2001 From: Mark Walters Date: Tue, 24 Jul 2012 19:23:29 +0100 Subject: [PATCH] man: update man page for the new --body=true|false option --- man/man1/notmuch-show.1 | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/man/man1/notmuch-show.1 b/man/man1/notmuch-show.1 index b51a54c3..506583a6 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 -- 2.43.0