61/aca387f6e4fe67504b06e843ef9ea9ea686c3b

   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 0E38F431FC7\r
   6         for <notmuch@notmuchmail.org>; Sun, 18 Jan 2015 01:34:10 -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 hyn3bYo6oF98 for <notmuch@notmuchmail.org>;\r
  16         Sun, 18 Jan 2015 01:34:07 -0800 (PST)\r
  17 Received: from yantan.tethera.net (yantan.tethera.net [199.188.72.155])\r
  18         (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id 2B649431FAF\r
  21         for <notmuch@notmuchmail.org>; Sun, 18 Jan 2015 01:34:07 -0800 (PST)\r
  22 Received: from remotemail by yantan.tethera.net with local (Exim 4.80)\r
  23         (envelope-from <bremner@tesseract.cs.unb.ca>)\r
  24         id 1YCmFC-0005FN-Nc; Sun, 18 Jan 2015 05:34:06 -0400\r
  25 Received: (nullmailer pid 9469 invoked by uid 1000); Sun, 18 Jan 2015\r
  26         09:34:01 -0000\r
  27 From: David Bremner <david@tethera.net>\r
  28 To: notmuch@notmuchmail.org\r
  29 Subject: [PATCH] doc: add details about Xapian search syntax\r
  30 Date: Sun, 18 Jan 2015 10:33:55 +0100\r
  31 Message-Id: <1421573635-9427-1-git-send-email-david@tethera.net>\r
  32 X-Mailer: git-send-email 2.1.4\r
  33 X-BeenThere: notmuch@notmuchmail.org\r
  34 X-Mailman-Version: 2.1.13\r
  35 Precedence: list\r
  36 List-Id: "Use and development of the notmuch mail system."\r
  37         <notmuch.notmuchmail.org>\r
  38 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  39         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  40 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  41 List-Post: <mailto:notmuch@notmuchmail.org>\r
  42 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  43 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  44         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  45 X-List-Received-Date: Sun, 18 Jan 2015 09:34:10 -0000\r
  46 \r
  47 Questions related to the way that probabilistic prefixes and phrases\r
  48 are handled come up quite often and it is nicer to have the documentation self contained.  Hopefully putting it in subsections prevents it from being overwhelming.\r
  49 ---\r
  50  doc/man7/notmuch-search-terms.rst | 46 +++++++++++++++++++++++++++++++++++++++\r
  51  1 file changed, 46 insertions(+)\r
  52 \r
  53 diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst\r
  54 index 1acdaa0..5c65938 100644\r
  55 --- a/doc/man7/notmuch-search-terms.rst\r
  56 +++ b/doc/man7/notmuch-search-terms.rst\r
  57 @@ -129,6 +129,52 @@ operators, but will have to be protected from interpretation by the\r
  58  shell, (such as by putting quotation marks around any parenthesized\r
  59  expression).\r
  60  \r
  61 +Boolean and Probabilistic Prefixes\r
  62 +----------------------------------\r
  63 +\r
  64 +Xapian (and hence notmuch) prefixes are either **boolean**, supporting\r
  65 +exact matches like "tag:inbox"  or **probabilistic**, supporting a most flexible **term** based searching. The pre\r
  66 +\r
  67 ++------------------+-----------------------+\r
  68 +|Boolean           |Probabilistic          |\r
  69 ++------------------+-----------------------+\r
  70 +| **tag:** **id:** | **from:** **to:**     |\r
  71 +|**thread:**       |**subject:**           |\r
  72 +|**folder:**       |**attachment**         |\r
  73 +|**path:**         |                       |\r
  74 +|                  |                       |\r
  75 ++------------------+-----------------------+\r
  76 +\r
  77 +Terms and phrases\r
  78 +-----------------\r
  79 +\r
  80 +In general Xapian distinguishes between lists of terms and\r
  81 +**phrases**. Phrases are indicated by double quotes (but beware you\r
  82 +probably need to protect those from your shell) and insist that those\r
  83 +unstemmed words occur in that order. One useful, but initially\r
  84 +surprising feature is that the following are equivalant ways to write\r
  85 +the same phrase.\r
  86 +\r
  87 +- "a list of words"\r
  88 +- a-list-of-words\r
  89 +- a/list/of/words\r
  90 +- a.list.of.words\r
  91 +\r
  92 +Both parenthesised lists of terms and quoted phrases are ok with\r
  93 +probabilisitic prefixes such as **to:**, **from:**, and **subject:**. In particular\r
  94 +\r
  95 +   subject:(pizza free)\r
  96 +\r
  97 +is equivalent to\r
  98 +\r
  99 +   subject:pizza and subject:free\r
 100 +\r
 101 +Both of these will match a subject "Free Delicious Pizza" while\r
 102 +\r
 103 +   subject:"pizza free"\r
 104 +\r
 105 +will not.\r
 106 +\r
 107  DATE AND TIME SEARCH\r
 108  ====================\r
 109  \r
 110 -- \r
 111 2.1.4\r
 112 \r