94/1a46405182c685caa30bd0d8b5ed2a172a7a5e

   1 Return-Path: <bremner@tesseract.cs.unb.ca>\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 1B6E0431FB6\r
   6         for <notmuch@notmuchmail.org>; Sun, 18 Jan 2015 05:39:37 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: 2.438\r
  10 X-Spam-Level: **\r
  11 X-Spam-Status: No, score=2.438 tagged_above=-999 required=5\r
  12         tests=[DNS_FROM_AHBL_RHSBL=2.438] 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 KAcoMLjEYktR for <notmuch@notmuchmail.org>;\r
  16         Sun, 18 Jan 2015 05:39:36 -0800 (PST)\r
  17 Received: from mx.xen14.node3324.gplhost.com (gitolite.debian.net\r
  18         [87.98.215.224])\r
  19         (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))\r
  20         (No client certificate requested)\r
  21         by olra.theworths.org (Postfix) with ESMTPS id 95B41431FAF\r
  22         for <notmuch@notmuchmail.org>; Sun, 18 Jan 2015 05:39:36 -0800 (PST)\r
  23 Received: from remotemail by mx.xen14.node3324.gplhost.com with local (Exim\r
  24         4.80) (envelope-from <bremner@tesseract.cs.unb.ca>)\r
  25         id 1YCpSV-0006ay-1f; Sun, 18 Jan 2015 13:00:03 +0000\r
  26 Received: (nullmailer pid 29996 invoked by uid 1000); Sun, 18 Jan 2015\r
  27         12:59:36 -0000\r
  28 From: David Bremner <david@tethera.net>\r
  29 To: Jani Nikula <jani@nikula.org>, David Bremner <david@tethera.net>,\r
  30         notmuch@notmuchmail.org\r
  31 Subject: [PATCH 3/3] doc: add more information on operators.\r
  32 Date: Sun, 18 Jan 2015 13:59:31 +0100\r
  33 Message-Id: <1421585971-29949-3-git-send-email-david@tethera.net>\r
  34 X-Mailer: git-send-email 2.1.4\r
  35 In-Reply-To: <1421585971-29949-1-git-send-email-david@tethera.net>\r
  36 References: <87h9vojsa0.fsf@nikula.org>\r
  37         <1421585971-29949-1-git-send-email-david@tethera.net>\r
  38 X-BeenThere: notmuch@notmuchmail.org\r
  39 X-Mailman-Version: 2.1.13\r
  40 Precedence: list\r
  41 List-Id: "Use and development of the notmuch mail system."\r
  42         <notmuch.notmuchmail.org>\r
  43 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  44         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  45 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  46 List-Post: <mailto:notmuch@notmuchmail.org>\r
  47 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  48 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  49         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  50 X-List-Received-Date: Sun, 18 Jan 2015 13:39:37 -0000\r
  51 \r
  52 More material borrowed from the wiki page on "searching"\r
  53 ---\r
  54  doc/man7/notmuch-search-terms.rst | 43 ++++++++++++++++++++++++++++++++++-----\r
  55  1 file changed, 38 insertions(+), 5 deletions(-)\r
  56 \r
  57 diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst\r
  58 index 3b27053..a315fbe 100644\r
  59 --- a/doc/man7/notmuch-search-terms.rst\r
  60 +++ b/doc/man7/notmuch-search-terms.rst\r
  61 @@ -118,17 +118,50 @@ The time range can also be specified using timestamps with a syntax of:\r
  62  Each timestamp is a number representing the number of seconds since\r
  63  1970-01-01 00:00:00 UTC.\r
  64  \r
  65 -In addition to individual terms, multiple terms can be combined with\r
  66 -Boolean operators ( **and**, **or**, **not** , etc.). Each term in the\r
  67 -query will be implicitly connected by a logical AND if no explicit\r
  68 -operator is provided, (except that terms with a common prefix will be\r
  69 -implicitly combined with OR until we get Xapian defect #402 fixed).\r
  70 +Operators\r
  71 +---------\r
  72  \r
  73 +In addition to individual terms, multiple terms can be combined with\r
  74 +Boolean operators ( **and**, **or**, **not**, and **xor**). Each term\r
  75 +in the query will be implicitly connected by a logical AND if no\r
  76 +explicit operator is provided, (except that terms with a common prefix\r
  77 +will be implicitly combined with OR until we get Xapian defect #402\r
  78 +fixed).  The shorthand '-<term>' can be used for 'not <term>' but\r
  79 +unfortunately this does not work at the start of an expression.\r
  80  Parentheses can also be used to control the combination of the Boolean\r
  81  operators, but will have to be protected from interpretation by the\r
  82  shell, (such as by putting quotation marks around any parenthesized\r
  83  expression).\r
  84  \r
  85 +In addition to the standard boolean operators, Xapian provides several\r
  86 +operators specific to text searching.\r
  87 +\r
  88 +::\r
  89 +\r
  90 +        notmuch search term1 NEAR term2\r
  91 +\r
  92 +will return results where term1 is within 10 words of term2. The\r
  93 +threshold can be set like this:\r
  94 +\r
  95 +::\r
  96 +\r
  97 +        notmuch search term1 NEAR/2 term2\r
  98 +\r
  99 +The search\r
 100 +\r
 101 +::\r
 102 +\r
 103 +        notmuch search term1 ADJ term2\r
 104 +\r
 105 +will return results where term1 is within 10 words of term2, but in the\r
 106 +same order as in the query. The threshold can be set the same as with\r
 107 +NEAR:\r
 108 +\r
 109 +::\r
 110 +\r
 111 +        notmuch search term1 ADJ/7 term2\r
 112 +\r
 113 +\r
 114  Stemming\r
 115  --------\r
 116  \r
 117 -- \r
 118 2.1.4\r
 119 \r