bf/be6ea34a9a1996d9927cf7136009903ba84208

   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 97948429E29\r
   6         for <notmuch@notmuchmail.org>; Mon, 23 Feb 2015 12:17:38 -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 QD8pNmbPzBy8 for <notmuch@notmuchmail.org>;\r
  16         Mon, 23 Feb 2015 12:17:38 -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 3351D429E26\r
  22         for <notmuch@notmuchmail.org>; Mon, 23 Feb 2015 12:17:38 -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 1YPzHv-0001dC-59; Mon, 23 Feb 2015 20:07:31 +0000\r
  26 Received: (nullmailer pid 5902 invoked by uid 1000); Mon, 23 Feb 2015\r
  27         20:06:24 -0000\r
  28 From: David Bremner <david@tethera.net>\r
  29 To: David Bremner <david@tethera.net>, Jani Nikula <jani@nikula.org>,\r
  30         notmuch@notmuchmail.org\r
  31 Subject: [Patch v2 1/4] doc: add material on stemming and wildcards\r
  32 Date: Mon, 23 Feb 2015 21:05:34 +0100\r
  33 Message-Id: <1424721937-5797-2-git-send-email-david@tethera.net>\r
  34 X-Mailer: git-send-email 2.1.4\r
  35 In-Reply-To: <1424721937-5797-1-git-send-email-david@tethera.net>\r
  36 References: <87a9163fpf.fsf@maritornes.cs.unb.ca>\r
  37         <1424721937-5797-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: Mon, 23 Feb 2015 20:17:38 -0000\r
  51 \r
  52 This is lightly massaged from the searching page on the wiki.\r
  53 ---\r
  54  doc/man7/notmuch-search-terms.rst | 27 +++++++++++++++++++++++++++\r
  55  1 file changed, 27 insertions(+)\r
  56 \r
  57 diff --git a/doc/man7/notmuch-search-terms.rst b/doc/man7/notmuch-search-terms.rst\r
  58 index 54138d2..7fb4a27 100644\r
  59 --- a/doc/man7/notmuch-search-terms.rst\r
  60 +++ b/doc/man7/notmuch-search-terms.rst\r
  61 @@ -135,6 +135,33 @@ operators, but will have to be protected from interpretation by the\r
  62  shell, (such as by putting quotation marks around any parenthesized\r
  63  expression).\r
  64  \r
  65 +Stemming\r
  66 +--------\r
  67 +\r
  68 +**Stemming** in notmuch means that these searches\r
  69 +\r
  70 +::\r
  71 +\r
  72 +        notmuch search detailed\r
  73 +        notmuch search details\r
  74 +        notmuch search detail\r
  75 +\r
  76 +will all return identical results, because Xapian first "reduces" the\r
  77 +term to the common stem (here 'detail') and then performs the search.\r
  78 +\r
  79 +There are two ways to turn this off: a search for a capitalized word\r
  80 +will be performed unstemmed, so that one can search for "John" and not\r
  81 +get results for "Johnson"; phrase searches are also unstemmed (see\r
  82 +below for details).  Stemming is currently only supported for\r
  83 +English. Searches for words in other languages will be performed unstemmed.\r
  84 +\r
  85 +Wildcards\r
  86 +---------\r
  87 +\r
  88 +It is possible to use a trailing '\*' as a wildcard. A search for\r
  89 +'wildc\*' will match 'wildcard', 'wildcat', etc.\r
  90 +\r
  91 +\r
  92  Boolean and Probabilistic Prefixes\r
  93  ----------------------------------\r
  94  \r
  95 -- \r
  96 2.1.4\r
  97 \r