From 8d64ce65d1e86bcf7a0ad535e8840f6a7727e52f Mon Sep 17 00:00:00 2001 From: Austin Clements Date: Tue, 24 Jul 2012 12:52:20 +2000 Subject: [PATCH] Re: [PATCH 3/4] man: update man page for the new --body=true|false option --- e9/9e6ba2e659470096d33c5055d89523001c43b8 | 127 ++++++++++++++++++++++ 1 file changed, 127 insertions(+) create mode 100644 e9/9e6ba2e659470096d33c5055d89523001c43b8 diff --git a/e9/9e6ba2e659470096d33c5055d89523001c43b8 b/e9/9e6ba2e659470096d33c5055d89523001c43b8 new file mode 100644 index 000000000..d5072196e --- /dev/null +++ b/e9/9e6ba2e659470096d33c5055d89523001c43b8 @@ -0,0 +1,127 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by olra.theworths.org (Postfix) with ESMTP id C8524431FB6 + for ; Mon, 23 Jul 2012 09:52:24 -0700 (PDT) +X-Virus-Scanned: Debian amavisd-new at olra.theworths.org +X-Spam-Flag: NO +X-Spam-Score: -0.7 +X-Spam-Level: +X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5 + tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled +Received: from olra.theworths.org ([127.0.0.1]) + by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) + with ESMTP id on-F8TC9CvNw for ; + Mon, 23 Jul 2012 09:52:23 -0700 (PDT) +Received: from dmz-mailsec-scanner-2.mit.edu (DMZ-MAILSEC-SCANNER-2.MIT.EDU + [18.9.25.13]) + by olra.theworths.org (Postfix) with ESMTP id 4F2E2431FAE + for ; Mon, 23 Jul 2012 09:52:23 -0700 (PDT) +X-AuditID: 1209190d-b7fd56d000000933-37-500d8146fe6c +Received: from mailhub-auth-1.mit.edu ( [18.9.21.35]) + by dmz-mailsec-scanner-2.mit.edu (Symantec Messaging Gateway) with SMTP + id C7.5A.02355.6418D005; Mon, 23 Jul 2012 12:52:22 -0400 (EDT) +Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) + by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id q6NGqLN1031381; + Mon, 23 Jul 2012 12:52:22 -0400 +Received: from awakening.csail.mit.edu (awakening.csail.mit.edu [18.26.4.91]) + (authenticated bits=0) + (User authenticated as amdragon@ATHENA.MIT.EDU) + by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q6NGqKiD022403 + (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT); + Mon, 23 Jul 2012 12:52:21 -0400 (EDT) +Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.77) + (envelope-from ) + id 1StLro-0002hN-Eu; Mon, 23 Jul 2012 12:52:20 -0400 +Date: Mon, 23 Jul 2012 12:52:20 -0400 +From: Austin Clements +To: Mark Walters +Subject: Re: [PATCH 3/4] man: update man page for the new --body=true|false + option +Message-ID: <20120723165220.GH31834@mit.edu> +References: <1343060241-18283-1-git-send-email-markwalters1009@gmail.com> + <1343060241-18283-4-git-send-email-markwalters1009@gmail.com> +MIME-Version: 1.0 +Content-Type: text/plain; charset=us-ascii +Content-Disposition: inline +In-Reply-To: <1343060241-18283-4-git-send-email-markwalters1009@gmail.com> +User-Agent: Mutt/1.5.21 (2010-09-15) +X-Brightmail-Tracker: + H4sIAAAAAAAAA+NgFmpgleLIzCtJLcpLzFFi42IR4hRV1nVr5A0wuPRGyWL1XB6L6zdnMjsw + eeycdZfd49mqW8wBTFFcNimpOZllqUX6dglcGfvufmUsOMJVcfTSMuYGxukcXYycHBICJhL/ + PjxghbDFJC7cW8/WxcjFISSwj1Hi05nVTBDOBkaJjRf+sYFUCQmcZJJY/TQMwl7CKHHhiUIX + IwcHi4CqxJZ9PiBhNgENiW37lzOC2CICOhK3Dy1gB7GZBaQlvv1uZgKxhQVCJLbPWgNm8wLV + LF++CGp8J6PEvy0VEHFBiZMzn7BA9GpJ3Pj3kglkFcic5f/A7ucU8JK43dcCNl5UQEViyslt + bBMYhWYh6Z6FpHsWQvcCRuZVjLIpuVW6uYmZOcWpybrFyYl5ealFukZ6uZkleqkppZsYwQEt + ybuD8d1BpUOMAhyMSjy8uxp4A4RYE8uKK3MPMUpyMCmJ8opWAIX4kvJTKjMSizPii0pzUosP + MUpwMCuJ8K6uBsrxpiRWVqUW5cOkpDlYlMR5r6Tc9BcSSE8sSc1OTS1ILYLJynBwKEnw8oPs + ESxKTU+tSMvMKUFIM3FwggznARquA1LDW1yQmFucmQ6RP8WoKCXO+6seKCEAksgozYPrhSWc + V4ziQK8I85qBtPMAkxVc9yugwUxAg6WzuEAGlyQipKQaGO0X6H25s/sA27OZDxlv/SjJcfvP + s0HvmcjKbKn6tX8OmyibCshwhz9QPfr0eU/Mlq+ik59mHFeyfv7i3PLupycNfh2Qyq93kOpS + rAy/EbXVs2Z2L2N+/q5jt/wVYoOerVleejJ+2dk//NO4Jv9/eTKGpecRz6KquSnOO1w8Zmi8 + yFRaHbY88qoSS3FGoqEWc1FxIgDMS3ASEwMAAA== +Cc: notmuch@notmuchmail.org +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.13 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Mon, 23 Jul 2012 16:52:24 -0000 + +Quoth Mark Walters on Jul 23 at 5:17 pm: +> --- +> man/man1/notmuch-show.1 | 16 ++++++++++++++++ +> 1 files changed, 16 insertions(+), 0 deletions(-) +> +> diff --git a/man/man1/notmuch-show.1 b/man/man1/notmuch-show.1 +> index 5fa590e..d781c47 100644 +> --- a/man/man1/notmuch-show.1 +> +++ b/man/man1/notmuch-show.1 +> @@ -154,6 +154,22 @@ The default is +> +> .RE +> +> +.RS 4 +> +.TP 4 +> +.B \-\-body=(true|false) +> + +> +If true, + +"If true (the default)"? + +> +.B notmuch show +> +includes the bodies of the messages in the output whereas, if false, + +The "whereas" is a bit awkward. Perhaps just a semicolon? "... in +the output; if false, bodies are omitted."? + +> +they are omitted. It defaults to true. Note that + +"Note that" is unnecessary here. + +> +.B --body=false +> +is only implemented for the json format. +> + +> +This is useful if the caller is only interested in the headers as it + +s/is only interested in/only needs/? + +The "it" is a bit awkward, since it's not the option that's much +faster, but the output. "as body-less output is much faster and +substantially reduces the amount of output"? + +> +is much faster and the amount of output data is substantially +> +reduced. +> +.RE +> + +> A common use of +> .B notmuch show +> is to display a single thread of email messages. For this, use a -- 2.26.2