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 4FDBA431FAF
\r
6 for <notmuch@notmuchmail.org>; Mon, 10 Dec 2012 13:34:17 -0800 (PST)
\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
\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 ILTU9gjMOrJ7 for <notmuch@notmuchmail.org>;
\r
16 Mon, 10 Dec 2012 13:34:16 -0800 (PST)
\r
17 Received: from mail-lb0-f181.google.com (mail-lb0-f181.google.com
\r
18 [209.85.217.181]) (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 9B178431FAE
\r
21 for <notmuch@notmuchmail.org>; Mon, 10 Dec 2012 13:34:16 -0800 (PST)
\r
22 Received: by mail-lb0-f181.google.com with SMTP id ge1so2521210lbb.26
\r
23 for <notmuch@notmuchmail.org>; Mon, 10 Dec 2012 13:34:15 -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=n7Acnqu+zh2kyQUu2VXRXq9AZc8ZNiNJe4rxeICMUtE=;
\r
29 b=K0Dc3thfdVPENJxo3z0TLKfEOdq6Fwey2H38sKHCFgvAOofoCdeqaA/xlvH6bvspaX
\r
30 vc3/buYHhnLZTQ1O9a+rkdnIZh4BUKJ/O9quLyRo9jxDc0o3LMVlXOlgG9wfCyg6L00n
\r
31 +/zx7l2FQRSz6L0xUHB1AFqurn7ppw3kH+4Q1xY750gNMCdlij3bgC7l1v36Zz220wP9
\r
32 y33NuACHSiCFalDbVo/Qof+Mw6/WcCAKrdjMV07mnqH7i7swTwKNNufNbuSVGu9bvj6p
\r
33 wnJRwL0WaH9ur3+dWHD73A/lMN+ankvz0LSzPpbU2khq9mXjO/cwsDhlmjb0ulQ6lhxj
\r
35 Received: by 10.152.108.48 with SMTP id hh16mr14995602lab.25.1355175255093;
\r
36 Mon, 10 Dec 2012 13:34:15 -0800 (PST)
\r
37 Received: from localhost (dsl-hkibrasgw4-fe51df00-27.dhcp.inet.fi.
\r
39 by mx.google.com with ESMTPS id ps11sm8383115lab.12.2012.12.10.13.34.13
\r
40 (version=SSLv3 cipher=OTHER); Mon, 10 Dec 2012 13:34:14 -0800 (PST)
\r
41 From: Jani Nikula <jani@nikula.org>
\r
42 To: david@tethera.net, notmuch@notmuchmail.org
\r
43 Subject: Re: [Patch v6 6/6] man: document notmuch tag --batch, --input options
\r
44 In-Reply-To: <1355096008-4544-7-git-send-email-david@tethera.net>
\r
45 References: <1355096008-4544-1-git-send-email-david@tethera.net>
\r
46 <1355096008-4544-7-git-send-email-david@tethera.net>
\r
47 User-Agent: Notmuch/0.14+138~g7041c56 (http://notmuchmail.org) Emacs/23.4.1
\r
49 Date: Mon, 10 Dec 2012 23:34:12 +0200
\r
50 Message-ID: <878v95a8x7.fsf@nikula.org>
\r
52 Content-Type: text/plain; charset=us-ascii
\r
54 ALoCoQluDRFVUaYhs3iBjJUK59ZIYaOzzPagmDilByGBfu2DuECSBMpKkrv7ShSz43OV/tVGb/ki
\r
55 X-BeenThere: notmuch@notmuchmail.org
\r
56 X-Mailman-Version: 2.1.13
\r
58 List-Id: "Use and development of the notmuch mail system."
\r
59 <notmuch.notmuchmail.org>
\r
60 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
\r
61 <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
\r
62 List-Archive: <http://notmuchmail.org/pipermail/notmuch>
\r
63 List-Post: <mailto:notmuch@notmuchmail.org>
\r
64 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
\r
65 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
\r
66 <mailto:notmuch-request@notmuchmail.org?subject=subscribe>
\r
67 X-List-Received-Date: Mon, 10 Dec 2012 21:34:17 -0000
\r
72 On Mon, 10 Dec 2012, david@tethera.net wrote:
\r
73 > From: Jani Nikula <jani@nikula.org>
\r
76 > man/man1/notmuch-tag.1 | 50 ++++++++++++++++++++++++++++++++++++++++++++++++
\r
77 > 1 file changed, 50 insertions(+)
\r
79 > diff --git a/man/man1/notmuch-tag.1 b/man/man1/notmuch-tag.1
\r
80 > index d23700d..c4e60d3 100644
\r
81 > --- a/man/man1/notmuch-tag.1
\r
82 > +++ b/man/man1/notmuch-tag.1
\r
83 > @@ -6,6 +6,11 @@ notmuch-tag \- add/remove tags for all messages matching the search terms
\r
85 > .RI "+<" tag ">|\-<" tag "> [...] [\-\-] <" search-term "> [...]"
\r
89 > +.RI "[ --input=<" filename "> ]"
\r
94 > Add/remove tags for all messages matching the search terms.
\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
99 > +Supported options for
\r
106 > +Read batch tagging operations from a file (stdin by default). This is more
\r
107 > +efficient than repeated
\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
117 > +.BR "\-\-input=" <filename>
\r
119 > +Read input from given file, instead of from stdin. Implies
\r
122 > +.SH TAG FILE FORMAT
\r
124 > +The input must consist of lines of the format:
\r
126 > +.RI "+<" tag ">|\-<" tag "> [...] [\-\-] <" search-term "> [...]"
\r
128 > +Each line is interpreted similarly to
\r
130 > +command line arguments. The delimiter is one or more spaces ' '. Any
\r
131 > +characters in <tag> and <search-term>
\r
133 > +be hex encoded with %NN where NN is the hexadecimal value of the
\r
134 > +character. Any ' ' and '%' characters in <tag> and <search-terms>
\r
136 > +be hex encoded (using %20 and %25, respectively). Any characters that
\r
137 > +are not part of <tag> or <search-terms>
\r
141 > +Leading and trailing space ' ' is ignored. Empty lines and lines
\r
142 > +beginning with '#' are ignored.
\r
146 > \fBnotmuch\fR(1), \fBnotmuch-config\fR(1), \fBnotmuch-count\fR(1),
\r