06/c2c64077898508886736bb4b05dba617a006df

   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 63029431FAE\r
   6         for <notmuch@notmuchmail.org>; Mon, 24 Dec 2012 21:58:18 -0800 (PST)\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 WmHJaKOpqKQs for <notmuch@notmuchmail.org>;\r
  16         Mon, 24 Dec 2012 21:58:17 -0800 (PST)\r
  17 Received: from dmz-mailsec-scanner-6.mit.edu (DMZ-MAILSEC-SCANNER-6.MIT.EDU\r
  18         [18.7.68.35])\r
  19         by olra.theworths.org (Postfix) with ESMTP id 3C9C5431FBC\r
  20         for <notmuch@notmuchmail.org>; Mon, 24 Dec 2012 21:58:14 -0800 (PST)\r
  21 X-AuditID: 12074423-b7ef96d000000725-46-50d94075281e\r
  22 Received: from mailhub-auth-1.mit.edu ( [18.9.21.35])\r
  23         by dmz-mailsec-scanner-6.mit.edu (Symantec Messaging Gateway) with SMTP\r
  24         id 3F.D0.01829.57049D05; Tue, 25 Dec 2012 00:58:13 -0500 (EST)\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 qBP5wCij011702; \r
  27         Tue, 25 Dec 2012 00:58:12 -0500\r
  28 Received: from drake.dyndns.org (c-76-21-105-205.hsd1.ca.comcast.net\r
  29         [76.21.105.205]) (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 qBP5w7is011709\r
  32         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
  33         Tue, 25 Dec 2012 00:58:10 -0500 (EST)\r
  34 Received: from amthrax by drake.dyndns.org with local (Exim 4.77)\r
  35         (envelope-from <amdragon@mit.edu>)\r
  36         id 1TnNWg-0001Xw-Uw; Tue, 25 Dec 2012 00:58:06 -0500\r
  37 From: Austin Clements <amdragon@MIT.EDU>\r
  38 To: notmuch@notmuchmail.org\r
  39 Subject: [PATCH 5/5] man: Update notmuch-dump(1) for new batch-tag format\r
  40 Date: Tue, 25 Dec 2012 00:57:56 -0500\r
  41 Message-Id: <1356415076-5692-6-git-send-email-amdragon@mit.edu>\r
  42 X-Mailer: git-send-email 1.7.10.4\r
  43 In-Reply-To: <1356415076-5692-1-git-send-email-amdragon@mit.edu>\r
  44 References: <1356415076-5692-1-git-send-email-amdragon@mit.edu>\r
  45 X-Brightmail-Tracker:\r
  46  H4sIAAAAAAAAA+NgFjrPIsWRmVeSWpSXmKPExsUixCmqrFvqcDPAYM5yPYsbrd2MFk3TnS1W\r
  47         z+WxuH5zJrMDi8fOWXfZPW7df83u8WzVLWaPLYfeMwewRHHZpKTmZJalFunbJXBldE3pYS1Y\r
  48         xFXR25XSwLiGo4uRk0NCwETi4KWjLBC2mMSFe+vZuhi5OIQE9jFKdG26xgzhbGCU2L/gH1Tm\r
  49         IpPE9rkgLSDOXEaJt49PM4L0swloSGzbvxzMFhGQlth5dzYriM0skCfx8NFWdhBbWMBT4nvr\r
  50         TSYQm0VAVeLrglawGl4Be4lZnxtZIe5QlOh+NoENxOYUcJCY+2cl2H1CQDVf525mmcDIv4CR\r
  51         YRWjbEpulW5uYmZOcWqybnFyYl5eapGumV5uZoleakrpJkZQuLG7KO9g/HNQ6RCjAAejEg/v\r
  52         iak3AoRYE8uKK3MPMUpyMCmJ8r62uxkgxJeUn1KZkVicEV9UmpNafIhRgoNZSYTXhAcox5uS\r
  53         WFmVWpQPk5LmYFES572WctNfSCA9sSQ1OzW1ILUIJivDwaEkwfsHZKhgUWp6akVaZk4JQpqJ\r
  54         gxNkOA/QcEl7kOHFBYm5xZnpEPlTjIpS4rw/QZoFQBIZpXlwvbB08IpRHOgVYd7ZIFU8wFQC\r
  55         1/0KaDAT0OBYvhsgg0sSEVJSDYzsN9xM3sctWbvXyKp1f7TuttOXXBmX2hfnnpkr8H+SS6nv\r
  56         Ovlb84xFePt+TKk/cizqt0DG2Ux+27Wd/7tmSztmNN7a+G6l1aIVTrvNb30JN5L2D16gdUVp\r
  57         a868ucHuUz0368zoaHi1rqGs/MvTYumsCK+bP2ZP9sk62PVi9rxisf9qxnImf6SVWIozEg21\r
  58         mIuKEwFMQQ964gIAAA==\r
  59 X-BeenThere: notmuch@notmuchmail.org\r
  60 X-Mailman-Version: 2.1.13\r
  61 Precedence: list\r
  62 List-Id: "Use and development of the notmuch mail system."\r
  63         <notmuch.notmuchmail.org>\r
  64 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  65         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  66 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  67 List-Post: <mailto:notmuch@notmuchmail.org>\r
  68 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  69 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  70         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  71 X-List-Received-Date: Tue, 25 Dec 2012 05:58:18 -0000\r
  72 \r
  73 ---\r
  74  man/man1/notmuch-dump.1 |   11 +++++++----\r
  75  1 file changed, 7 insertions(+), 4 deletions(-)\r
  76 \r
  77 diff --git a/man/man1/notmuch-dump.1 b/man/man1/notmuch-dump.1\r
  78 index 770b00f..7bd6def 100644\r
  79 --- a/man/man1/notmuch-dump.1\r
  80 +++ b/man/man1/notmuch-dump.1\r
  81 @@ -64,13 +64,16 @@ and tags containing whitespace or non-\fBascii\fR(7) characters.\r
  82  Each line has the form\r
  83  \r
  84  .RS 4\r
  85 -.RI "+<" "encoded-tag" "> " "" "+<" "encoded-tag" "> ... -- " "" " id:<" encoded-message-id >\r
  86 +.RI "+<" "encoded-tag" "> " "" "+<" "encoded-tag" "> ... -- " "" " id:<" quoted-message-id >\r
  87  \r
  88 -where encoded means that every byte not matching the regex\r
  89 +Tags are hex-encoded by replacing every byte not matching the regex\r
  90  .B [A-Za-z0-9@=.,_+-]\r
  91 -is replace by\r
  92 +with\r
  93  .B %nn\r
  94 -where nn is the two digit hex encoding.\r
  95 +where nn is the two digit hex encoding.  The message ID is a valid Xapian\r
  96 +query, quoted using Xapian boolean term quoting rules: if the ID contains\r
  97 +whitespace or a close paren or starts with a double quote, it must be\r
  98 +enclosed in double quotes and double quotes inside the ID must be doubled.\r
  99  The astute reader will notice this is a special case of the batch input\r
 100  format for \fBnotmuch-tag\fR(1); note that the single message-id query is\r
 101  mandatory for \fBnotmuch-restore\fR(1).\r
 102 -- \r
 103 1.7.10.4\r
 104 \r