a5/0d30ff0a2758739e7b32c277f436b199255fc7

   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 49107431FB6\r
   6         for <notmuch@notmuchmail.org>; Fri, 18 Apr 2014 12:33:46 -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 sIFQIaWDsvwG for <notmuch@notmuchmail.org>;\r
  16         Fri, 18 Apr 2014 12:33:21 -0700 (PDT)\r
  17 Received: from dmz-mailsec-scanner-5.mit.edu (dmz-mailsec-scanner-5.mit.edu\r
  18         [18.7.68.34])\r
  19         by olra.theworths.org (Postfix) with ESMTP id D59CF431FAF\r
  20         for <notmuch@notmuchmail.org>; Fri, 18 Apr 2014 12:33:20 -0700 (PDT)\r
  21 X-AuditID: 12074422-f79186d00000135a-c5-53517e00d78f\r
  22 Received: from mailhub-auth-2.mit.edu ( [18.7.62.36])\r
  23         (using TLS with cipher AES256-SHA (256/256 bits))\r
  24         (Client did not present a certificate)\r
  25         by dmz-mailsec-scanner-5.mit.edu (Symantec Messaging Gateway) with SMTP\r
  26         id BF.21.04954.00E71535; Fri, 18 Apr 2014 15:33:20 -0400 (EDT)\r
  27 Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11])\r
  28         by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id s3IJXI2V021022; \r
  29         Fri, 18 Apr 2014 15:33:20 -0400\r
  30 Received: from awakening.csail.mit.edu (awakening.csail.mit.edu [18.26.4.91])\r
  31         (authenticated bits=0)\r
  32         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
  33         by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id s3IJXGvQ028487\r
  34         (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT);\r
  35         Fri, 18 Apr 2014 15:33:18 -0400\r
  36 Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.80)\r
  37         (envelope-from <amdragon@mit.edu>)\r
  38         id 1WbEXE-0003PB-7W; Fri, 18 Apr 2014 15:33:16 -0400\r
  39 Date: Fri, 18 Apr 2014 15:33:15 -0400\r
  40 From: Austin Clements <amdragon@MIT.EDU>\r
  41 To: Mark Walters <markwalters1009@gmail.com>\r
  42 Subject: Re: [PATCH 1/4] doc: Clarify notmuch show --format=raw description\r
  43 Message-ID: <20140418193315.GB9395@mit.edu>\r
  44 References: <1397834332-25175-1-git-send-email-amdragon@mit.edu>\r
  45         <1397834332-25175-2-git-send-email-amdragon@mit.edu>\r
  46         <87lhv2h26m.fsf@qmul.ac.uk>\r
  47 MIME-Version: 1.0\r
  48 Content-Type: text/plain; charset=us-ascii\r
  49 Content-Disposition: inline\r
  50 In-Reply-To: <87lhv2h26m.fsf@qmul.ac.uk>\r
  51 User-Agent: Mutt/1.5.21 (2010-09-15)\r
  52 X-Brightmail-Tracker:\r
  53  H4sIAAAAAAAAA+NgFmpmleLIzCtJLcpLzFFi42IRYrdT0WWoCww2OLFe0GL1XB6L6zdnMjsw\r
  54         eeycdZfd49mqW8wBTFFcNimpOZllqUX6dglcGZu2XGMq2CxdMXvqIfYGxv3CXYycHBICJhJL\r
  55         /k9lg7DFJC7cWw9kc3EICcxmktg6eQ0rhLORUeLDzf/MEM5pJomJPfuhnCWMEs9//mIH6WcR\r
  56         UJW4em4lE4jNJqAhsW3/ckYQW0RAR+L2oQVgNcwC0hLffjeD1QgLeEusbdnNCmLzCmhLLPi8\r
  57         gQVi6FRGif+XJjNCJAQlTs58wgLRrCVx499LoGYOsEHL/3GAmJxAuw5+dwWpEBVQkZhychvb\r
  58         BEahWUiaZyFpnoXQvICReRWjbEpulW5uYmZOcWqybnFyYl5eapGuqV5uZoleakrpJkZwWLso\r
  59         7WD8eVDpEKMAB6MSD++GgMBgIdbEsuLK3EOMkhxMSqK8cyuBQnxJ+SmVGYnFGfFFpTmpxYcY\r
  60         JTiYlUR45/sC5XhTEiurUovyYVLSHCxK4rxvra2ChQTSE0tSs1NTC1KLYLIyHBxKErzFtUCN\r
  61         gkWp6akVaZk5JQhpJg5OkOE8QMPLQGp4iwsSc4sz0yHypxgVpcR5b9UAJQRAEhmleXC9sLTz\r
  62         ilEc6BVhXhuQdh5gyoLrfgU0mAlo8N8zASCDSxIRUlINjHUZHwKF4xVbTrNsmib3buW0gAxD\r
  63         EYlvSae3z4idw3vw/guG0JP15/sKJAVtUxb6/t76J3diVUHo9s+e0jN/uYWW3Pn9MXjVKoO9\r
  64         m72nBYSJ1iU7Pb8V/tN4954Fk5zsHvisWaof8aS/bPYr7YWvjfKKzm49vYa35N9epm0dc1KF\r
  65         YzjDFn5fq6LEUpyRaKjFXFScCACk4WFsFgMAAA==\r
  66 Cc: notmuch@notmuchmail.org\r
  67 X-BeenThere: notmuch@notmuchmail.org\r
  68 X-Mailman-Version: 2.1.13\r
  69 Precedence: list\r
  70 List-Id: "Use and development of the notmuch mail system."\r
  71         <notmuch.notmuchmail.org>\r
  72 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  73         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  74 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  75 List-Post: <mailto:notmuch@notmuchmail.org>\r
  76 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  77 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  78         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  79 X-List-Received-Date: Fri, 18 Apr 2014 19:33:46 -0000\r
  80 \r
  81 Quoth Mark Walters on Apr 18 at  8:23 pm:\r
  82 > \r
  83 > On Fri, 18 Apr 2014, Austin Clements <amdragon@MIT.EDU> wrote:\r
  84 > > In addition to being generally more precise, this is explicit that\r
  85 > > there is no charset conversion.\r
  86 > > ---\r
  87 > >  doc/man1/notmuch-show.rst | 36 ++++++++++++++++++++----------------\r
  88 > >  1 file changed, 20 insertions(+), 16 deletions(-)\r
  89 > >\r
  90 > > diff --git a/doc/man1/notmuch-show.rst b/doc/man1/notmuch-show.rst\r
  91 > > index bad868b..2c0f64c 100644\r
  92 > > --- a/doc/man1/notmuch-show.rst\r
  93 > > +++ b/doc/man1/notmuch-show.rst\r
  94 > > @@ -76,22 +76,26 @@ Supported options for **show** include\r
  95 > >  \r
  96 > >         http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/mail-mbox-formats.html\r
  97 > >  \r
  98 > > -        **raw** (default for a single part, see --part)\r
  99 > > -            For a message or an attached message part, the original, raw\r
 100 > > -            content of the email message is output. Consumers of this\r
 101 > > -            format should expect to implement MIME decoding and similar\r
 102 > > -            functions.\r
 103 > > -\r
 104 > > -            For a single part (--part) the raw part content is output\r
 105 > > -            after performing any necessary MIME decoding. Note that\r
 106 > > -            messages with a simple body still have two parts: part 0 is\r
 107 > > -            the whole message and part 1 is the body.\r
 108 > > -\r
 109 > > -            For a multipart part, the part headers and body (including\r
 110 > > -            all child parts) is output.\r
 111 > > -\r
 112 > > -            The raw format must only be used with search terms matching\r
 113 > > -            single message.\r
 114 > > +        **raw** (default if --part is given)\r
 115 > > +            Write the raw bytes of the given MIME part of a message to\r
 116 > > +            standard out. For this format, it is an error to specify a\r
 117 > > +            query that matches more than one message.\r
 118 > > +\r
 119 > > +            If the specified part is a leaf part, this outputs the\r
 120 > > +            body of the part after performing content transfer\r
 121 > > +            decoding (but no charset conversion). This is suitable for\r
 122 > > +            saving attachments, for example.\r
 123 > > +\r
 124 > > +            For a multipart or message part, the output includes the\r
 125 > > +            part headers as well as the body (including all child\r
 126 > > +            parts). No decoding is performed because multipart and\r
 127 > > +            message parts cannot have non-trivial content transfer\r
 128 > > +            encoding. Consumers of this may need to implement MIME\r
 129 > > +            decoding and similar functions.\r
 130 > > +\r
 131 > > +            Note that even a message with a simple body has two parts:\r
 132 > > +            part 0 is the whole message and part 1 is the body of the\r
 133 > > +            message.\r
 134 > \r
 135 > Generally this looks good. I wonder whether the paragraph above could be\r
 136 > expanded slightly: my (quite possibly flawed) understanding is that\r
 137 > simple messages don't need to be MIME encoded (at least some messages\r
 138 > don't contain any mention of MIME). If this is correct then I think it\r
 139 > would be worth clarifying that this paragraph applies even to non-MIME\r
 140 > encoded messages.\r
 141 \r
 142 It's true that even "non-MIME" messages have two MIME parts.  Are you\r
 143 thinking something like\r
 144 \r
 145 Note that even a message with no MIME structure or a single body part\r
 146 still has two MIME parts: part 0 is the whole message (headers and\r
 147 body) and part 1 is just the body.\r
 148 \r
 149 ?\r
 150 \r
 151 I wonder if this would be better in the documentation for --part.\r
 152 \r
 153 > Best wishes\r
 154 > \r
 155 > Mark\r