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 9B61D421171
\r
6 for <notmuch@notmuchmail.org>; Sat, 17 Aug 2013 05:11:54 -0700 (PDT)
\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
\r
8 X-Amavis-Alert: BAD HEADER SECTION, Duplicate header field: "References"
\r
12 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5
\r
13 tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled
\r
14 Received: from olra.theworths.org ([127.0.0.1])
\r
15 by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)
\r
16 with ESMTP id hkkCL3mSKfkL for <notmuch@notmuchmail.org>;
\r
17 Sat, 17 Aug 2013 05:11:50 -0700 (PDT)
\r
18 Received: from mail-bk0-f53.google.com (mail-bk0-f53.google.com
\r
19 [209.85.214.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits))
\r
20 (No client certificate requested)
\r
21 by olra.theworths.org (Postfix) with ESMTPS id 4ABD5429E4A
\r
22 for <notmuch@notmuchmail.org>; Sat, 17 Aug 2013 05:11:41 -0700 (PDT)
\r
23 Received: by mail-bk0-f53.google.com with SMTP id d7so913662bkh.26
\r
24 for <notmuch@notmuchmail.org>; Sat, 17 Aug 2013 05:11:40 -0700 (PDT)
\r
25 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
\r
26 d=google.com; s=20120113;
\r
27 h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to
\r
28 :references:in-reply-to:references;
\r
29 bh=sB51YMdzTimwYDfK+LkstuirW5oZMIeZ0qLaPCLa+Ec=;
\r
30 b=aZSaatEwUvOajwP176dTZ7EjvmaHEWHBZngVr0rgjfCdU20BsCN8JZH4zucpjQGDKQ
\r
31 SwIP7VOosZ/ACzTm729Uuk5hsGdydTpMlR3DQde4EHCYbgu/qyUiEbFPk3lT3trVCCfV
\r
32 x9ektlf5YbWGOiPIYhfM+I5CZa0EhqZ9ZTxl60K/3S+Lp216NAlBYsN7nJFqaM6bZcf6
\r
33 loOXT/Bxtz1P+799fwA8G/0wr5sPR0fkzi/UK1HqOM02xFoYAFg059S48UTzD6iOfYTF
\r
34 tbOa/Se8jmZAulMX7RXP/k9wD1NxY240n8HdXklfjaMaSA8O1AewGThonXB6VSlPPdxn
\r
37 ALoCoQn1OwLHo4GbJozm8CO4U2CYOVchrhhwnGxkFBC0ch9sVKaZugcGpUTn/u3s2VL2Z3BbXuQK
\r
38 X-Received: by 10.205.9.198 with SMTP id ox6mr1661198bkb.19.1376741499997;
\r
39 Sat, 17 Aug 2013 05:11:39 -0700 (PDT)
\r
40 Received: from localhost (dsl-hkibrasgw2-58c36f-91.dhcp.inet.fi.
\r
42 by mx.google.com with ESMTPSA id if11sm249815bkc.15.1969.12.31.16.00.00
\r
43 (version=TLSv1.2 cipher=RC4-SHA bits=128/128);
\r
44 Sat, 17 Aug 2013 05:11:38 -0700 (PDT)
\r
45 From: Jani Nikula <jani@nikula.org>
\r
46 To: notmuch@notmuchmail.org
\r
47 Subject: [PATCH v3 3/8] man: document notmuch search --duplicate=N
\r
48 Date: Sat, 17 Aug 2013 15:11:28 +0300
\r
50 <fbe62d787c8acb242aa29a3f0c0790e89951bf84.1376741447.git.jani@nikula.org>
\r
51 X-Mailer: git-send-email 1.7.10.4
\r
52 In-Reply-To: <cover.1376741447.git.jani@nikula.org>
\r
53 References: <cover.1376741447.git.jani@nikula.org>
\r
54 In-Reply-To: <cover.1376741447.git.jani@nikula.org>
\r
55 References: <cover.1376741447.git.jani@nikula.org>
\r
56 X-BeenThere: notmuch@notmuchmail.org
\r
57 X-Mailman-Version: 2.1.13
\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: Sat, 17 Aug 2013 12:11:55 -0000
\r
70 Document the notmuch search --duplicate=N option.
\r
74 v3: clarify dupe vs. folder prefix per Mark's suggestion
\r
76 man/man1/notmuch-search.1 | 20 ++++++++++++++++++++
\r
77 1 file changed, 20 insertions(+)
\r
79 diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1
\r
80 index 2d6ecaf..f69a4cd 100644
\r
81 --- a/man/man1/notmuch-search.1
\r
82 +++ b/man/man1/notmuch-search.1
\r
83 @@ -80,6 +80,10 @@ Output the filenames of all messages matching the search terms, either
\r
84 one per line (\-\-format=text), separated by null characters
\r
85 (\-\-format=text0), as a JSON array (\-\-format=json), or as an
\r
86 S-Expression list (\-\-format=sexp).
\r
88 +Note that each message may have multiple filenames associated with it.
\r
89 +All of them are included in the output, unless limited with the
\r
90 +\-\-duplicate=N option.
\r
94 @@ -158,6 +162,22 @@ but the "match count" is the number of matching non-excluded messages in the
\r
95 thread, rather than the number of matching messages.
\r
100 +.BR \-\-duplicate=N
\r
103 +.BR --output=files ,
\r
104 +output the Nth filename associated with each message matching the
\r
105 +query (N is 1-based). If N is greater than the number of files
\r
106 +associated with the message, don't print anything.
\r
108 +Note that this option is orthogonal with the
\r
110 +search prefix. The prefix matches messages based on filenames. This
\r
111 +option filters filenames of the matching messages.
\r
116 This command supports the following special exit status codes
\r