From: Jani Nikula Date: Mon, 23 Feb 2015 18:23:27 +0000 (+0200) Subject: Re: [PATCH 3/3] doc: add more information on operators. X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=37e81617e44925c9d60999ae7cb129cbcf2bfce4;p=notmuch-archives.git Re: [PATCH 3/3] doc: add more information on operators. --- diff --git a/b3/7985909d5ce408bca0af87cabc79c39b0e5181 b/b3/7985909d5ce408bca0af87cabc79c39b0e5181 new file mode 100644 index 000000000..8cc229105 --- /dev/null +++ b/b3/7985909d5ce408bca0af87cabc79c39b0e5181 @@ -0,0 +1,155 @@ +Return-Path: +X-Original-To: notmuch@notmuchmail.org +Delivered-To: notmuch@notmuchmail.org +Received: from localhost (localhost [127.0.0.1]) + by olra.theworths.org (Postfix) with ESMTP id 74229431FDD + for ; Mon, 23 Feb 2015 10:31:28 -0800 (PST) +X-Virus-Scanned: Debian amavisd-new at olra.theworths.org +X-Spam-Flag: NO +X-Spam-Score: 1.738 +X-Spam-Level: * +X-Spam-Status: No, score=1.738 tagged_above=-999 required=5 + tests=[DNS_FROM_AHBL_RHSBL=2.438, RCVD_IN_DNSWL_LOW=-0.7] + autolearn=disabled +Received: from olra.theworths.org ([127.0.0.1]) + by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024) + with ESMTP id 1TWLpeBKbM2s for ; + Mon, 23 Feb 2015 10:31:25 -0800 (PST) +Received: from mail-wi0-f181.google.com (mail-wi0-f181.google.com + [209.85.212.181]) (using TLSv1 with cipher RC4-SHA (128/128 bits)) + (No client certificate requested) + by olra.theworths.org (Postfix) with ESMTPS id 0FE98431FDA + for ; Mon, 23 Feb 2015 10:31:25 -0800 (PST) +Received: by mail-wi0-f181.google.com with SMTP id r20so19617560wiv.2 + for ; Mon, 23 Feb 2015 10:23:10 -0800 (PST) +X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; + d=1e100.net; s=20130820; + h=x-gm-message-state:from:to:subject:in-reply-to:references + :user-agent:date:message-id:mime-version:content-type; + bh=6UqMrN2Ojx+WuHI3398iTeVXP6bOQB9gCu3y+hArWLw=; + b=KoSYeYdYeNGB6meZj2PewZygMqr5zUU4YA9F7ASHhndURmho/SV9UeXO+Bp0gWFXLB + RT+t7E6HFTxOzksSB0O2ofmMVVJGBLm+9PrTtu4LffCXQlAo2K7jFk7a9Urr7qsdE4pS + DtvXkks4eNpFEJb2Nm9aalmDFTGMUh9FwLvZyVqQ6FAcmybQXFnofpZzHR1P7TrjB7eS + ok1mzlzaQWmwVN9hDfqFtnJSqh8C6uqKwJHLBKPcVfxBQZ0lagLgp1muttWoXlN+UiSq + KQlc5yIZOZHdry0/cc27Nt7QlHChvSPH2hXkcWfYsIIIMc8HlM8jxPWS4Gk/k710rD/g + CtLA== +X-Gm-Message-State: + ALoCoQmTzFPmwppx8wTpr3q+zI1WyETbo68c+zwzWYJwubNWLyMbvD235zyyYM+Qk1qJCeKClk90 +X-Received: by 10.180.86.227 with SMTP id s3mr23216446wiz.58.1424715790218; + Mon, 23 Feb 2015 10:23:10 -0800 (PST) +Received: from localhost (mobile-internet-bcee3b-76.dhcp.inet.fi. + [188.238.59.76]) by mx.google.com with ESMTPSA id + uo6sm56675405wjc.49.2015.02.23.10.23.09 + (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); + Mon, 23 Feb 2015 10:23:09 -0800 (PST) +From: Jani Nikula +To: David Bremner , David Bremner , + notmuch@notmuchmail.org +Subject: Re: [PATCH 3/3] doc: add more information on operators. +In-Reply-To: <1421585971-29949-3-git-send-email-david@tethera.net> +References: <87h9vojsa0.fsf@nikula.org> + <1421585971-29949-1-git-send-email-david@tethera.net> + <1421585971-29949-3-git-send-email-david@tethera.net> +User-Agent: Notmuch/0.19+49~g2049205 (http://notmuchmail.org) Emacs/24.4.1 + (x86_64-pc-linux-gnu) +Date: Mon, 23 Feb 2015 20:23:27 +0200 +Message-ID: <87385w5vxc.fsf@nikula.org> +MIME-Version: 1.0 +Content-Type: text/plain +X-BeenThere: notmuch@notmuchmail.org +X-Mailman-Version: 2.1.13 +Precedence: list +List-Id: "Use and development of the notmuch mail system." + +List-Unsubscribe: , + +List-Archive: +List-Post: +List-Help: +List-Subscribe: , + +X-List-Received-Date: Mon, 23 Feb 2015 18:31:28 -0000 + +On Sun, 18 Jan 2015, David Bremner wrote: +> More material borrowed from the wiki page on "searching" +> --- +> doc/man7/notmuch-search-terms.rst | 43 ++++++++++++++++++++++++++++++++++----- +> 1 file changed, 38 insertions(+), 5 deletions(-) +> +> diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst +> index 3b27053..a315fbe 100644 +> --- a/doc/man7/notmuch-search-terms.rst +> +++ b/doc/man7/notmuch-search-terms.rst +> @@ -118,17 +118,50 @@ The time range can also be specified using timestamps with a syntax of: +> Each timestamp is a number representing the number of seconds since +> 1970-01-01 00:00:00 UTC. +> +> -In addition to individual terms, multiple terms can be combined with +> -Boolean operators ( **and**, **or**, **not** , etc.). Each term in the +> -query will be implicitly connected by a logical AND if no explicit +> -operator is provided, (except that terms with a common prefix will be +> -implicitly combined with OR until we get Xapian defect #402 fixed). +> +Operators +> +--------- +> +> +In addition to individual terms, multiple terms can be combined with +> +Boolean operators ( **and**, **or**, **not**, and **xor**). Each term + +Extra space after (. + +> +in the query will be implicitly connected by a logical AND if no +> +explicit operator is provided, (except that terms with a common prefix +> +will be implicitly combined with OR until we get Xapian defect #402 +> +fixed). The shorthand '-' can be used for 'not ' but +> +unfortunately this does not work at the start of an expression. + +I think people expect tag:inbox tag:unread to have implicit OR by now, +so we could just drop the reference to the xapian defect. + +Otherwise these patches LGTM, and I like getting this info into the man +page rather than the wiki. + +BR, +Jani. + + + +> Parentheses can also be used to control the combination of the Boolean +> operators, but will have to be protected from interpretation by the +> shell, (such as by putting quotation marks around any parenthesized +> expression). +> +> +In addition to the standard boolean operators, Xapian provides several +> +operators specific to text searching. +> + +> +:: +> + +> + notmuch search term1 NEAR term2 +> + +> +will return results where term1 is within 10 words of term2. The +> +threshold can be set like this: +> + +> +:: +> + +> + notmuch search term1 NEAR/2 term2 +> + +> +The search +> + +> +:: +> + +> + notmuch search term1 ADJ term2 +> + +> +will return results where term1 is within 10 words of term2, but in the +> +same order as in the query. The threshold can be set the same as with +> +NEAR: +> + +> +:: +> + +> + notmuch search term1 ADJ/7 term2 +> + +> + +> Stemming +> -------- +> +> -- +> 2.1.4