[PATCH v2 8/8] man: Update raw format documentation

diff --git a/1e/acc76146caa37eae57f16f153c0ebae7c3806b b/1e/acc76146caa37eae57f16f153c0ebae7c3806b
new file mode 100644 (file)
index 0000000..a2b8227
--- /dev/null
+++ b/1e/acc76146caa37eae57f16f153c0ebae7c3806b
@@ -0,0 +1,105 @@
+Return-Path: <amthrax@drake.mit.edu>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id EABB9431E64\r
+       for <notmuch@notmuchmail.org>; Tue,  6 Mar 2012 10:48:54 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.7\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
+       tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id lsQADvI8FmEL for <notmuch@notmuchmail.org>;\r
+       Tue,  6 Mar 2012 10:48:53 -0800 (PST)\r
+Received: from dmz-mailsec-scanner-2.mit.edu (DMZ-MAILSEC-SCANNER-2.MIT.EDU\r
+       [18.9.25.13])\r
+       by olra.theworths.org (Postfix) with ESMTP id 3FF88431FCB\r
+       for <notmuch@notmuchmail.org>; Tue,  6 Mar 2012 10:48:52 -0800 (PST)\r
+X-AuditID: 1209190d-b7fbf6d0000008ba-ae-4f565c137c13\r
+Received: from mailhub-auth-4.mit.edu ( [18.7.62.39])\r
+       by dmz-mailsec-scanner-2.mit.edu (Symantec Messaging Gateway) with SMTP\r
+       id 2F.81.02234.31C565F4; Tue,  6 Mar 2012 13:48:51 -0500 (EST)\r
+Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
+       by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id q26ImpBg020740; \r
+       Tue, 6 Mar 2012 13:48:51 -0500\r
+Received: from drake.mit.edu (firewall.royalsociety.org [193.63.75.2])\r
+       (authenticated bits=0)\r
+       (User authenticated as amdragon@ATHENA.MIT.EDU)\r
+       by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q26Imnw1016472\r
+       (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
+       Tue, 6 Mar 2012 13:48:51 -0500 (EST)\r
+Received: from amthrax by drake.mit.edu with local (Exim 4.77)\r
+       (envelope-from <amthrax@drake.mit.edu>)\r
+       id 1S4zRI-0003pb-MQ; Tue, 06 Mar 2012 18:48:48 +0000\r
+From: Austin Clements <amdragon@MIT.EDU>\r
+To: notmuch@notmuchmail.org\r
+Subject: [PATCH v2 8/8] man: Update raw format documentation\r
+Date: Tue,  6 Mar 2012 18:48:44 +0000\r
+Message-Id: <1331059724-14653-9-git-send-email-amdragon@mit.edu>\r
+X-Mailer: git-send-email 1.7.7.3\r
+In-Reply-To: <1331059724-14653-1-git-send-email-amdragon@mit.edu>\r
+References: <1330752025-2542-1-git-send-email-amdragon@mit.edu>\r
+       <1331059724-14653-1-git-send-email-amdragon@mit.edu>\r
+X-Brightmail-Tracker:\r
+ H4sIAAAAAAAAA+NgFtrBIsWRmVeSWpSXmKPExsUixG6nriscE+ZvsHqipsWefV4W12/OZHZg\r
+       8rh7msvj2apbzAFMUVw2Kak5mWWpRfp2CVwZ3w96FrzirLi9ZTJTA2MnRxcjB4eEgInExuW2\r
+       XYycQKaYxIV769lAbCGBfYwSXf9Luhi5gOz1jBItLbPZIZyDTBJb1yxhg3DmM0rsWfqXBaSF\r
+       TUBDYtv+5YwgtoiAtMTOu7NZQTYwCzhJtLV5gYSFBWwkpt85BVbOIqAq0Xj5Hdg2XgEHic+f\r
+       D7BCXKEgcW71OXYQm1PAUWLP002MEBeVSVy6eYFlAiP/AkaGVYyyKblVurmJmTnFqcm6xcmJ\r
+       eXmpRbpGermZJXqpKaWbGEEBxCnJu4Px3UGlQ4wCHIxKPLxVumH+QqyJZcWVuYcYJTmYlER5\r
+       c6KAQnxJ+SmVGYnFGfFFpTmpxYcYJTiYlUR4v70P9RfiTUmsrEotyodJSXOwKInzqmq98xMS\r
+       SE8sSc1OTS1ILYLJynBwKEnw6kQDDRUsSk1PrUjLzClBSDNxcIIM5wEabgRSw1tckJhbnJkO\r
+       kT/FqCglzusHkhAASWSU5sH1wiL8FaM40CvCvI4gVTzA5ADX/QpoMBPQ4DblYJDBJYkIKakG\r
+       RtcbPud2PFvI//i+/uU7n340d56IEqndPWFH9aPzL+fadpbIldqqzBF6+o4pOCkyi1OtfspS\r
+       K7OL89oigptdfp54soWxh3ev62O+f2HaEXE7TTfKiDe+W76ott1Kpb38c9yfJ8kGB07sffbW\r
+       SiubO+9qmYhhNeeG3PtvzU+uOugpxhm9Rn0NrxJLcUaioRZzUXEiAI3ua5/LAgAA\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Tue, 06 Mar 2012 18:48:55 -0000\r
+\r
+---\r
+ man/man1/notmuch-show.1 |   13 +++++++++----\r
+ 1 files changed, 9 insertions(+), 4 deletions(-)\r
+\r
+diff --git a/man/man1/notmuch-show.1 b/man/man1/notmuch-show.1\r
+index 4c5db94..9506367 100644\r
+--- a/man/man1/notmuch-show.1\r
++++ b/man/man1/notmuch-show.1\r
+@@ -84,12 +84,17 @@ http://homepage.ntlworld.com/jonathan.deboynepollard/FGA/mail-mbox-formats.html\r
+ .TP 4\r
+ .BR raw " (default for a single part, see \-\-part)"\r
+ \r
+-For a message, the original, raw content of the email message is\r
+-output. Consumers of this format should expect to implement MIME\r
+-decoding and similar functions.\r
++For a message or an attached message part, the original, raw content\r
++of the email message is output. Consumers of this format should expect\r
++to implement MIME decoding and similar functions.\r
+ \r
+ For a single part (\-\-part) the raw part content is output after\r
+-performing any necessary MIME decoding.\r
++performing any necessary MIME decoding.  Note that messages with a\r
++simple body still have two parts: part 0 is the whole message and part\r
++1 is the body.\r
++\r
++For a multipart part, the part headers and body (including all child\r
++parts) is output.\r
+ \r
+ The raw format must only be used with search terms matching single\r
+ message.\r
+-- \r
+1.7.7.3\r
+\r