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 74229431FDD
\r
6 for <notmuch@notmuchmail.org>; Mon, 23 Feb 2015 10:31:28 -0800 (PST)
\r
7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org
\r
11 X-Spam-Status: No, score=1.738 tagged_above=-999 required=5
\r
12 tests=[DNS_FROM_AHBL_RHSBL=2.438, RCVD_IN_DNSWL_LOW=-0.7]
\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 1TWLpeBKbM2s for <notmuch@notmuchmail.org>;
\r
17 Mon, 23 Feb 2015 10:31:25 -0800 (PST)
\r
18 Received: from mail-wi0-f181.google.com (mail-wi0-f181.google.com
\r
19 [209.85.212.181]) (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 0FE98431FDA
\r
22 for <notmuch@notmuchmail.org>; Mon, 23 Feb 2015 10:31:25 -0800 (PST)
\r
23 Received: by mail-wi0-f181.google.com with SMTP id r20so19617560wiv.2
\r
24 for <notmuch@notmuchmail.org>; Mon, 23 Feb 2015 10:23:10 -0800 (PST)
\r
25 X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
\r
26 d=1e100.net; s=20130820;
\r
27 h=x-gm-message-state:from:to:subject:in-reply-to:references
\r
28 :user-agent:date:message-id:mime-version:content-type;
\r
29 bh=6UqMrN2Ojx+WuHI3398iTeVXP6bOQB9gCu3y+hArWLw=;
\r
30 b=KoSYeYdYeNGB6meZj2PewZygMqr5zUU4YA9F7ASHhndURmho/SV9UeXO+Bp0gWFXLB
\r
31 RT+t7E6HFTxOzksSB0O2ofmMVVJGBLm+9PrTtu4LffCXQlAo2K7jFk7a9Urr7qsdE4pS
\r
32 DtvXkks4eNpFEJb2Nm9aalmDFTGMUh9FwLvZyVqQ6FAcmybQXFnofpZzHR1P7TrjB7eS
\r
33 ok1mzlzaQWmwVN9hDfqFtnJSqh8C6uqKwJHLBKPcVfxBQZ0lagLgp1muttWoXlN+UiSq
\r
34 KQlc5yIZOZHdry0/cc27Nt7QlHChvSPH2hXkcWfYsIIIMc8HlM8jxPWS4Gk/k710rD/g
\r
37 ALoCoQmTzFPmwppx8wTpr3q+zI1WyETbo68c+zwzWYJwubNWLyMbvD235zyyYM+Qk1qJCeKClk90
\r
38 X-Received: by 10.180.86.227 with SMTP id s3mr23216446wiz.58.1424715790218;
\r
39 Mon, 23 Feb 2015 10:23:10 -0800 (PST)
\r
40 Received: from localhost (mobile-internet-bcee3b-76.dhcp.inet.fi.
\r
41 [188.238.59.76]) by mx.google.com with ESMTPSA id
\r
42 uo6sm56675405wjc.49.2015.02.23.10.23.09
\r
43 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
\r
44 Mon, 23 Feb 2015 10:23:09 -0800 (PST)
\r
45 From: Jani Nikula <jani@nikula.org>
\r
46 To: David Bremner <david@tethera.net>, David Bremner <david@tethera.net>,
\r
47 notmuch@notmuchmail.org
\r
48 Subject: Re: [PATCH 3/3] doc: add more information on operators.
\r
49 In-Reply-To: <1421585971-29949-3-git-send-email-david@tethera.net>
\r
50 References: <87h9vojsa0.fsf@nikula.org>
\r
51 <1421585971-29949-1-git-send-email-david@tethera.net>
\r
52 <1421585971-29949-3-git-send-email-david@tethera.net>
\r
53 User-Agent: Notmuch/0.19+49~g2049205 (http://notmuchmail.org) Emacs/24.4.1
\r
54 (x86_64-pc-linux-gnu)
\r
55 Date: Mon, 23 Feb 2015 20:23:27 +0200
\r
56 Message-ID: <87385w5vxc.fsf@nikula.org>
\r
58 Content-Type: text/plain
\r
59 X-BeenThere: notmuch@notmuchmail.org
\r
60 X-Mailman-Version: 2.1.13
\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: Mon, 23 Feb 2015 18:31:28 -0000
\r
73 On Sun, 18 Jan 2015, David Bremner <david@tethera.net> wrote:
\r
74 > More material borrowed from the wiki page on "searching"
\r
76 > doc/man7/notmuch-search-terms.rst | 43 ++++++++++++++++++++++++++++++++++-----
\r
77 > 1 file changed, 38 insertions(+), 5 deletions(-)
\r
79 > diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst
\r
80 > index 3b27053..a315fbe 100644
\r
81 > --- a/doc/man7/notmuch-search-terms.rst
\r
82 > +++ b/doc/man7/notmuch-search-terms.rst
\r
83 > @@ -118,17 +118,50 @@ The time range can also be specified using timestamps with a syntax of:
\r
84 > Each timestamp is a number representing the number of seconds since
\r
85 > 1970-01-01 00:00:00 UTC.
\r
87 > -In addition to individual terms, multiple terms can be combined with
\r
88 > -Boolean operators ( **and**, **or**, **not** , etc.). Each term in the
\r
89 > -query will be implicitly connected by a logical AND if no explicit
\r
90 > -operator is provided, (except that terms with a common prefix will be
\r
91 > -implicitly combined with OR until we get Xapian defect #402 fixed).
\r
95 > +In addition to individual terms, multiple terms can be combined with
\r
96 > +Boolean operators ( **and**, **or**, **not**, and **xor**). Each term
\r
98 Extra space after (.
\r
100 > +in the query will be implicitly connected by a logical AND if no
\r
101 > +explicit operator is provided, (except that terms with a common prefix
\r
102 > +will be implicitly combined with OR until we get Xapian defect #402
\r
103 > +fixed). The shorthand '-<term>' can be used for 'not <term>' but
\r
104 > +unfortunately this does not work at the start of an expression.
\r
106 I think people expect tag:inbox tag:unread to have implicit OR by now,
\r
107 so we could just drop the reference to the xapian defect.
\r
109 Otherwise these patches LGTM, and I like getting this info into the man
\r
110 page rather than the wiki.
\r
117 > Parentheses can also be used to control the combination of the Boolean
\r
118 > operators, but will have to be protected from interpretation by the
\r
119 > shell, (such as by putting quotation marks around any parenthesized
\r
122 > +In addition to the standard boolean operators, Xapian provides several
\r
123 > +operators specific to text searching.
\r
127 > + notmuch search term1 NEAR term2
\r
129 > +will return results where term1 is within 10 words of term2. The
\r
130 > +threshold can be set like this:
\r
134 > + notmuch search term1 NEAR/2 term2
\r
140 > + notmuch search term1 ADJ term2
\r
142 > +will return results where term1 is within 10 words of term2, but in the
\r
143 > +same order as in the query. The threshold can be set the same as with
\r
148 > + notmuch search term1 ADJ/7 term2
\r