1 Return-Path: <markwalters1009@gmail.com>
\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 39D0B431FC9
\r
6 for <notmuch@notmuchmail.org>; Sat, 11 May 2013 12:50:39 -0700 (PDT)
\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
\r
11 X-Spam-Status: No, score=0.201 tagged_above=-999 required=5
\r
12 tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,
\r
13 FREEMAIL_ENVFROM_END_DIGIT=1, FREEMAIL_FROM=0.001,
\r
14 RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled
\r
15 Received: from olra.theworths.org ([127.0.0.1])
\r
16 by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)
\r
17 with ESMTP id 4ZfbI-5-MuT5 for <notmuch@notmuchmail.org>;
\r
18 Sat, 11 May 2013 12:50:34 -0700 (PDT)
\r
19 Received: from mail-wg0-f45.google.com (mail-wg0-f45.google.com
\r
20 [74.125.82.45]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) (No client
\r
21 certificate requested) by olra.theworths.org (Postfix) with ESMTPS id
\r
22 351A0431FC7 for <notmuch@notmuchmail.org>; Sat, 11 May 2013 12:50:25 -0700
\r
24 Received: by mail-wg0-f45.google.com with SMTP id l18so5281117wgh.24
\r
25 for <notmuch@notmuchmail.org>; Sat, 11 May 2013 12:50:24 -0700 (PDT)
\r
26 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
\r
27 h=x-received:from:to:cc:subject:date:message-id:x-mailer:in-reply-to
\r
28 :references; bh=Jj5IWQfMnFvi1I9BpR+LCYlaQEgb+8RTKMhbFAuRivg=;
\r
29 b=AaMmfZuNQbZwwBe0yAF7GYpInZH6qeeKgI01kBHNzIlSPfJj5Tnc+KMwNb3Trnl2lg
\r
30 1Op2EDb7cPZaj3KRELp6/v3DqJgMz4zbQ8zgK57catD+Xspd4gQqUTZUEO43L3j8bJBn
\r
31 flAYbMP2Kc5hUYT2nvfkNO5VtC48QkK/1JOWQsPGnt5+qKWkPufgGnBJpPVFbqOjAuJv
\r
32 zDPEMF65+o7BcdMIXA7YzgrhL2px/gK2CMJv4UVI/JyKCpBdcucL0sYpbdgGFKZi8tBV
\r
33 ZmHU5cPu/vbydipND/g/CbJE0FOBwJs5rZ80+x9m8wHMeen3gOyeZ3L15fLVWXT8NCID
\r
35 X-Received: by 10.194.62.233 with SMTP id b9mr31340441wjs.37.1368301824151;
\r
36 Sat, 11 May 2013 12:50:24 -0700 (PDT)
\r
37 Received: from localhost (93-97-24-31.zone5.bethere.co.uk. [93.97.24.31])
\r
38 by mx.google.com with ESMTPSA id dq8sm6258943wib.1.2013.05.11.12.50.23
\r
39 for <multiple recipients>
\r
40 (version=TLSv1.2 cipher=RC4-SHA bits=128/128);
\r
41 Sat, 11 May 2013 12:50:23 -0700 (PDT)
\r
42 From: Mark Walters <markwalters1009@gmail.com>
\r
43 To: notmuch@notmuchmail.org
\r
44 Subject: [PATCH v2 4/8] man: clarify search --exclude documentation
\r
45 Date: Sat, 11 May 2013 20:50:05 +0100
\r
46 Message-Id: <1368301809-12532-5-git-send-email-markwalters1009@gmail.com>
\r
47 X-Mailer: git-send-email 1.7.9.1
\r
48 In-Reply-To: <1368301809-12532-1-git-send-email-markwalters1009@gmail.com>
\r
49 References: <1368301809-12532-1-git-send-email-markwalters1009@gmail.com>
\r
50 X-BeenThere: notmuch@notmuchmail.org
\r
51 X-Mailman-Version: 2.1.13
\r
53 List-Id: "Use and development of the notmuch mail system."
\r
54 <notmuch.notmuchmail.org>
\r
55 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,
\r
56 <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>
\r
57 List-Archive: <http://notmuchmail.org/pipermail/notmuch>
\r
58 List-Post: <mailto:notmuch@notmuchmail.org>
\r
59 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>
\r
60 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,
\r
61 <mailto:notmuch-request@notmuchmail.org?subject=subscribe>
\r
62 X-List-Received-Date: Sat, 11 May 2013 19:50:40 -0000
\r
64 From: Peter Wang <novalazy@gmail.com>
\r
66 Highlight "excluded messages" as a term with a meaning that
\r
69 Be explicit about the effects of search --exclude=true and
\r
72 man/man1/notmuch-search.1 | 15 +++++++++++++--
\r
73 1 files changed, 13 insertions(+), 2 deletions(-)
\r
75 diff --git a/man/man1/notmuch-search.1 b/man/man1/notmuch-search.1
\r
76 index d3391f8..59e8f34 100644
\r
77 --- a/man/man1/notmuch-search.1
\r
78 +++ b/man/man1/notmuch-search.1
\r
79 @@ -132,8 +132,19 @@ Limit the number of displayed results to N.
\r
81 .BR \-\-exclude=(true|false|flag)
\r
83 -Specify whether to omit messages matching search.tag_exclude from the
\r
84 -search results (the default) or not. The extra option
\r
85 +A message is called "excluded" if it matches at least one tag in
\r
86 +search.tag_exclude that does not appear explicitly in the search terms.
\r
87 +This option specifies whether to omit excluded messages in the search
\r
92 +prevents excluded messages from matching the search terms.
\r
95 +allows excluded messages to match search terms and appear in displayed
\r
96 +results. Excluded messages are still marked in the relevant outputs.
\r
99 only has an effect when
\r
100 .B --output=summary
\r