e9/9e6ba2e659470096d33c5055d89523001c43b8

   1 Return-Path: <amdragon@mit.edu>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id C8524431FB6\r
   6         for <notmuch@notmuchmail.org>; Mon, 23 Jul 2012 09:52:24 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.7\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
  13 Received: from olra.theworths.org ([127.0.0.1])\r
  14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15         with ESMTP id on-F8TC9CvNw for <notmuch@notmuchmail.org>;\r
  16         Mon, 23 Jul 2012 09:52:23 -0700 (PDT)\r
  17 Received: from dmz-mailsec-scanner-2.mit.edu (DMZ-MAILSEC-SCANNER-2.MIT.EDU\r
  18         [18.9.25.13])\r
  19         by olra.theworths.org (Postfix) with ESMTP id 4F2E2431FAE\r
  20         for <notmuch@notmuchmail.org>; Mon, 23 Jul 2012 09:52:23 -0700 (PDT)\r
  21 X-AuditID: 1209190d-b7fd56d000000933-37-500d8146fe6c\r
  22 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35])\r
  23         by dmz-mailsec-scanner-2.mit.edu (Symantec Messaging Gateway) with SMTP\r
  24         id C7.5A.02355.6418D005; Mon, 23 Jul 2012 12:52:22 -0400 (EDT)\r
  25 Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
  26         by mailhub-auth-1.mit.edu (8.13.8/8.9.2) with ESMTP id q6NGqLN1031381; \r
  27         Mon, 23 Jul 2012 12:52:22 -0400\r
  28 Received: from awakening.csail.mit.edu (awakening.csail.mit.edu [18.26.4.91])\r
  29         (authenticated bits=0)\r
  30         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
  31         by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q6NGqKiD022403\r
  32         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
  33         Mon, 23 Jul 2012 12:52:21 -0400 (EDT)\r
  34 Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.77)\r
  35         (envelope-from <amdragon@mit.edu>)\r
  36         id 1StLro-0002hN-Eu; Mon, 23 Jul 2012 12:52:20 -0400\r
  37 Date: Mon, 23 Jul 2012 12:52:20 -0400\r
  38 From: Austin Clements <amdragon@MIT.EDU>\r
  39 To: Mark Walters <markwalters1009@gmail.com>\r
  40 Subject: Re: [PATCH 3/4] man: update man page for the new --body=true|false\r
  41         option\r
  42 Message-ID: <20120723165220.GH31834@mit.edu>\r
  43 References: <1343060241-18283-1-git-send-email-markwalters1009@gmail.com>\r
  44         <1343060241-18283-4-git-send-email-markwalters1009@gmail.com>\r
  45 MIME-Version: 1.0\r
  46 Content-Type: text/plain; charset=us-ascii\r
  47 Content-Disposition: inline\r
  48 In-Reply-To: <1343060241-18283-4-git-send-email-markwalters1009@gmail.com>\r
  49 User-Agent: Mutt/1.5.21 (2010-09-15)\r
  50 X-Brightmail-Tracker:\r
  51  H4sIAAAAAAAAA+NgFmpgleLIzCtJLcpLzFFi42IR4hRV1nVr5A0wuPRGyWL1XB6L6zdnMjsw\r
  52         eeycdZfd49mqW8wBTFFcNimpOZllqUX6dglcGfvufmUsOMJVcfTSMuYGxukcXYycHBICJhL/\r
  53         PjxghbDFJC7cW8/WxcjFISSwj1Hi05nVTBDOBkaJjRf+sYFUCQmcZJJY/TQMwl7CKHHhiUIX\r
  54         IwcHi4CqxJZ9PiBhNgENiW37lzOC2CICOhK3Dy1gB7GZBaQlvv1uZgKxhQVCJLbPWgNm8wLV\r
  55         LF++CGp8J6PEvy0VEHFBiZMzn7BA9GpJ3Pj3kglkFcic5f/A7ucU8JK43dcCNl5UQEViyslt\r
  56         bBMYhWYh6Z6FpHsWQvcCRuZVjLIpuVW6uYmZOcWpybrFyYl5ealFukZ6uZkleqkppZsYwQEt\r
  57         ybuD8d1BpUOMAhyMSjy8uxp4A4RYE8uKK3MPMUpyMCmJ8opWAIX4kvJTKjMSizPii0pzUosP\r
  58         MUpwMCuJ8K6uBsrxpiRWVqUW5cOkpDlYlMR5r6Tc9BcSSE8sSc1OTS1ILYLJynBwKEnw8oPs\r
  59         ESxKTU+tSMvMKUFIM3FwggznARquA1LDW1yQmFucmQ6RP8WoKCXO+6seKCEAksgozYPrhSWc\r
  60         V4ziQK8I85qBtPMAkxVc9yugwUxAg6WzuEAGlyQipKQaGO0X6H25s/sA27OZDxlv/SjJcfvP\r
  61         s0HvmcjKbKn6tX8OmyibCshwhz9QPfr0eU/Mlq+ik59mHFeyfv7i3PLupycNfh2Qyq93kOpS\r
  62         rAy/EbXVs2Z2L2N+/q5jt/wVYoOerVleejJ+2dk//NO4Jv9/eTKGpecRz6KquSnOO1w8Zmi8\r
  63         yFRaHbY88qoSS3FGoqEWc1FxIgDMS3ASEwMAAA==\r
  64 Cc: notmuch@notmuchmail.org\r
  65 X-BeenThere: notmuch@notmuchmail.org\r
  66 X-Mailman-Version: 2.1.13\r
  67 Precedence: list\r
  68 List-Id: "Use and development of the notmuch mail system."\r
  69         <notmuch.notmuchmail.org>\r
  70 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  71         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  72 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  73 List-Post: <mailto:notmuch@notmuchmail.org>\r
  74 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  75 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  76         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  77 X-List-Received-Date: Mon, 23 Jul 2012 16:52:24 -0000\r
  78 \r
  79 Quoth Mark Walters on Jul 23 at  5:17 pm:\r
  80 > ---\r
  81 >  man/man1/notmuch-show.1 |   16 ++++++++++++++++\r
  82 >  1 files changed, 16 insertions(+), 0 deletions(-)\r
  83 > \r
  84 > diff --git a/man/man1/notmuch-show.1 b/man/man1/notmuch-show.1\r
  85 > index 5fa590e..d781c47 100644\r
  86 > --- a/man/man1/notmuch-show.1\r
  87 > +++ b/man/man1/notmuch-show.1\r
  88 > @@ -154,6 +154,22 @@ The default is\r
  89 >  \r
  90 >  .RE\r
  91 >  \r
  92 > +.RS 4\r
  93 > +.TP 4\r
  94 > +.B \-\-body=(true|false)\r
  95 > +\r
  96 > +If true,\r
  97 \r
  98 "If true (the default)"?\r
  99 \r
 100 > +.B notmuch show\r
 101 > +includes the bodies of the messages in the output whereas, if false,\r
 102 \r
 103 The "whereas" is a bit awkward.  Perhaps just a semicolon?  "... in\r
 104 the output; if false, bodies are omitted."?\r
 105 \r
 106 > +they are omitted. It defaults to true.  Note that\r
 107 \r
 108 "Note that" is unnecessary here.\r
 109 \r
 110 > +.B --body=false\r
 111 > +is only implemented for the json format.\r
 112 > +\r
 113 > +This is useful if the caller is only interested in the headers as it\r
 114 \r
 115 s/is only interested in/only needs/?\r
 116 \r
 117 The "it" is a bit awkward, since it's not the option that's much\r
 118 faster, but the output.  "as body-less output is much faster and\r
 119 substantially reduces the amount of output"?\r
 120 \r
 121 > +is much faster and the amount of output data is substantially\r
 122 > +reduced.\r
 123 > +.RE\r
 124 > +\r
 125 >  A common use of\r
 126 >  .B notmuch show\r
 127 >  is to display a single thread of email messages. For this, use a\r