a3/10069aad6adecede2bdc796e36786df1b9c489

   1 Return-Path: <jani@nikula.org>\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 252C7431FAF\r
   6         for <notmuch@notmuchmail.org>; Sun,  2 Dec 2012 05:22:02 -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 vYsMDR6N7BAK for <notmuch@notmuchmail.org>;\r
  16         Sun,  2 Dec 2012 05:21:57 -0800 (PST)\r
  17 Received: from mail-la0-f53.google.com (mail-la0-f53.google.com\r
  18         [209.85.215.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id 7ED2A431FAE\r
  21         for <notmuch@notmuchmail.org>; Sun,  2 Dec 2012 05:21:57 -0800 (PST)\r
  22 Received: by mail-la0-f53.google.com with SMTP id w12so1639843lag.26\r
  23         for <notmuch@notmuchmail.org>; Sun, 02 Dec 2012 05:21:54 -0800 (PST)\r
  24 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;\r
  25         d=google.com; s=20120113;\r
  26         h=from:to:subject:in-reply-to:references:user-agent:date:message-id\r
  27         :mime-version:content-type:x-gm-message-state;\r
  28         bh=11uQ54r1cpfNUCO1Mlvw9TcOisMtCt2OqBRmZZ7u8jw=;\r
  29         b=Q9Z5fpL6uLsAJ3SJ3fKOOHYEWvFrzkO+trlODOxuXYznWeOsKZXf5iXfAJBBT9im3c\r
  30         aqljaV1MXoDVosABquGb+LnyWwKvpL94o7hrmC1i6S5os7yihujKMxAi3aWMYCDfPunM\r
  31         0TmDQ818u/dH7GqcL0GvkT4ldoVaFasxEn9gR9wG2PgjS5anAae8DuM0h85nwz7B0i4S\r
  32         l7VI06h7QEEFYs0WSTR3QVV8FUiD8fBrmlN9+9RP+F3vXOpT3NHZuPM28RWUwO4xKtcu\r
  33         6WnxRHZYU4feAVJ5Wf8uf4haJoLRecyAZBoYn3sTqcRwXKFlvoi5Lp8yRp+inDwJh5tG\r
  34         KO4A==\r
  35 Received: by 10.112.88.7 with SMTP id bc7mr1143102lbb.108.1354454514081;\r
  36         Sun, 02 Dec 2012 05:21:54 -0800 (PST)\r
  37 Received: from localhost (dsl-hkibrasgw4-fe51df00-27.dhcp.inet.fi.\r
  38         [80.223.81.27])\r
  39         by mx.google.com with ESMTPS id fb1sm4132562lbb.15.2012.12.02.05.21.52\r
  40         (version=SSLv3 cipher=OTHER); Sun, 02 Dec 2012 05:21:53 -0800 (PST)\r
  41 From: Jani Nikula <jani@nikula.org>\r
  42 To: david@tethera.net, notmuch@notmuchmail.org\r
  43 Subject: Re: [Patch v2 12/17] man: document notmuch tag --batch,\r
  44         --input options\r
  45 In-Reply-To: <1353792017-31459-13-git-send-email-david@tethera.net>\r
  46 References: <1353792017-31459-1-git-send-email-david@tethera.net>\r
  47         <1353792017-31459-13-git-send-email-david@tethera.net>\r
  48 User-Agent: Notmuch/0.14+124~g3b17402 (http://notmuchmail.org) Emacs/23.4.1\r
  49         (i686-pc-linux-gnu)\r
  50 Date: Sun, 02 Dec 2012 15:21:51 +0200\r
  51 Message-ID: <871uf8egi8.fsf@nikula.org>\r
  52 MIME-Version: 1.0\r
  53 Content-Type: text/plain; charset=us-ascii\r
  54 X-Gm-Message-State:\r
  55  ALoCoQnfGw6hJ0J1/ncrhKxRhmLOA0Mc5Jr2s72I3cF87cOP4wZ2OtNAwLprGsh/NrigJSmp3nnW\r
  56 X-BeenThere: notmuch@notmuchmail.org\r
  57 X-Mailman-Version: 2.1.13\r
  58 Precedence: list\r
  59 List-Id: "Use and development of the notmuch mail system."\r
  60         <notmuch.notmuchmail.org>\r
  61 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  62         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  63 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  64 List-Post: <mailto:notmuch@notmuchmail.org>\r
  65 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  66 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  67         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  68 X-List-Received-Date: Sun, 02 Dec 2012 13:22:02 -0000\r
  69 \r
  70 On Sat, 24 Nov 2012, david@tethera.net wrote:\r
  71 > From: Jani Nikula <jani@nikula.org>\r
  72 >\r
  73 > ---\r
  74 >  man/man1/notmuch-tag.1 |   52 +++++++++++++++++++++++++++++++++++++++++++++++-\r
  75 >  1 file changed, 51 insertions(+), 1 deletion(-)\r
  76 >\r
  77 > diff --git a/man/man1/notmuch-tag.1 b/man/man1/notmuch-tag.1\r
  78 > index 0f86582..751db7b 100644\r
  79 > --- a/man/man1/notmuch-tag.1\r
  80 > +++ b/man/man1/notmuch-tag.1\r
  81 > @@ -4,7 +4,12 @@ notmuch-tag \- add/remove tags for all messages matching the search terms\r
  82 >  \r
  83 >  .SH SYNOPSIS\r
  84 >  .B notmuch tag\r
  85 > -.RI  "+<" tag> "|\-<" tag "> [...] [\-\-] <" search-term ">..."\r
  86 > +.RI "+<" tag ">|\-<" tag "> [...] [\-\-] <" search-terms ">"\r
  87 > +\r
  88 > +.B notmuch tag\r
  89 > +.RI "--batch"\r
  90 > +.RI "[ --input=<" filename "> ]"\r
  91 > +\r
  92 >  \r
  93 >  .SH DESCRIPTION\r
  94 >  \r
  95 > @@ -29,6 +34,51 @@ updates the maildir flags according to tag changes if the\r
  96 >  configuration option is enabled. See \fBnotmuch-config\fR(1) for\r
  97 >  details.\r
  98 >  \r
  99 > +Supported options for\r
 100 > +.B tag\r
 101 > +include\r
 102 > +.RS 4\r
 103 > +.TP 4\r
 104 > +.BR \-\-batch\r
 105 > +\r
 106 > +Read batch tagging operations from standard input. This is more\r
 107 > +efficient than repeated\r
 108 > +.B notmuch tag\r
 109 > +invocations. See\r
 110 > +.B TAG FILE FORMAT\r
 111 > +below for the input format. This option is not compatible with\r
 112 > +specifying tagging on the command line.\r
 113 > +.RE\r
 114 > +\r
 115 > +.RS 4\r
 116 > +.TP 4\r
 117 > +.BR "\-\-input=" <filename>\r
 118 > +\r
 119 > +Read input from given file, instead of from stdin. Implies\r
 120 > +.BR --batch .\r
 121 > +\r
 122 > +.SH TAG FILE FORMAT\r
 123 > +\r
 124 > +The input must consist of lines of the format:\r
 125 > +\r
 126 > +.RI "T +<" tag ">|\-<" tag "> [...] [\-\-] <" search-terms ">"\r
 127 \r
 128 I think we should replace "<search-terms>" with "<search-term> [...]",\r
 129 and ditch the plural below...\r
 130 \r
 131 > +\r
 132 > +Each line is interpreted similarly to\r
 133 > +.B notmuch tag\r
 134 > +command line arguments. The delimiter is one or more spaces ' '. Any\r
 135 > +characters in <tag> and <search-terms>\r
 136 > +.B may\r
 137 > +be hex encoded with %NN where NN is the hexadecimal value of the\r
 138 > +character. Any ' ' and '%' characters in <tag> and <search-terms>\r
 139 > +.B must\r
 140 > +be hex encoded (using %20 and %25, respectively). Any characters that\r
 141 \r
 142 ...so it would make the above description more accurately depict\r
 143 reality. We don't care about hex encoding spaces between individual\r
 144 search terms.\r
 145 \r
 146 BR,\r
 147 Jani.\r
 148 \r
 149 > +are not part of <tag> or <search-terms>\r
 150 > +.B must not\r
 151 > +be hex encoded.\r
 152 > +\r
 153 > +Leading and trailing space ' ' is ignored. Empty lines and lines\r
 154 > +beginning with '#' are ignored.\r
 155 > +\r
 156 >  .SH SEE ALSO\r
 157 >  \r
 158 >  \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),\r
 159 > -- \r
 160 > 1.7.10.4\r