a7/f7e89e656db597cbe2fc01af3521864aeba296

   1 Return-Path: <amdragon@mit.edu>\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 94AE4431FAF\r
   6         for <notmuch@notmuchmail.org>; Thu, 15 Mar 2012 14:11:12 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.7\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_LOW=-0.7] 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 JZCy88ZZrPXO for <notmuch@notmuchmail.org>;\r
  16         Thu, 15 Mar 2012 14:11:10 -0700 (PDT)\r
  17 Received: from dmz-mailsec-scanner-3.mit.edu (DMZ-MAILSEC-SCANNER-3.MIT.EDU\r
  18         [18.9.25.14])\r
  19         by olra.theworths.org (Postfix) with ESMTP id ADFCA431FAE\r
  20         for <notmuch@notmuchmail.org>; Thu, 15 Mar 2012 14:11:10 -0700 (PDT)\r
  21 X-AuditID: 1209190e-b7f7c6d0000008c3-ce-4f625aeee464\r
  22 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43])\r
  23         by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP\r
  24         id 47.53.02243.EEA526F4; Thu, 15 Mar 2012 17:11:10 -0400 (EDT)\r
  25 Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
  26         by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id q2FLB9fg024011; \r
  27         Thu, 15 Mar 2012 17:11:10 -0400\r
  28 Received: from awakening.csail.mit.edu (awakening.csail.mit.edu [18.26.4.91])\r
  29         (authenticated bits=0)\r
  30         (User authenticated as amdragon@ATHENA.MIT.EDU)\r
  31         by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q2FLB8in022978\r
  32         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
  33         Thu, 15 Mar 2012 17:11:09 -0400 (EDT)\r
  34 Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.77)\r
  35         (envelope-from <amdragon@mit.edu>)\r
  36         id 1S8Hwy-00011k-2Q; Thu, 15 Mar 2012 17:11:08 -0400\r
  37 Date: Thu, 15 Mar 2012 17:11:08 -0400\r
  38 From: Austin Clements <amdragon@MIT.EDU>\r
  39 To: Andrei POPESCU <andreimpopescu@gmail.com>\r
  40 Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving\r
  41         notmuch query documentation]\r
  42 Message-ID: <20120315211107.GA2670@mit.edu>\r
  43 References: <20120115220600.GO7037@think.nuvreauspam>\r
  44         <877h0sa207.fsf@fester.com>\r
  45         <20120116202103.GA14329@think.nuvreauspam>\r
  46         <20120117023431.GF16740@mit.edu>\r
  47         <20120117221435.GN3272@think.nuvreauspam>\r
  48         <20120117222923.GU16740@mit.edu>\r
  49         <20120315093941.GK2981@sid.nuvreauspam>\r
  50 MIME-Version: 1.0\r
  51 Content-Type: text/plain; charset=us-ascii\r
  52 Content-Disposition: inline\r
  53 In-Reply-To: <20120315093941.GK2981@sid.nuvreauspam>\r
  54 User-Agent: Mutt/1.5.21 (2010-09-15)\r
  55 X-Brightmail-Tracker:\r
  56  H4sIAAAAAAAAA+NgFupnleLIzCtJLcpLzFFi42IR4hTV1n0XleRvMPMmr8WqCdIW12/OZHZg\r
  57         8tg56y67x7NVt5gDmKK4bFJSczLLUov07RK4Mi6vqCh4yFux+VsjWwPjZ64uRk4OCQETiYN/\r
  58         zzFB2GISF+6tZ+ti5OIQEtjHKNGw6isLhLOBUeLozl2MEM5JJonulxehMksYJTb9+c8K0s8i\r
  59         oCoxZWsXG4jNJqAhsW3/ckYQW0RAV6Lz1QGwHcwC0hLffjeD2cIC6RLPNkwDq+EV0JY4vu0/\r
  60         1O45TBKdT1pZIRKCEidnPmGBaNaSuPHvJVAzB9ig5f84QMKcQD+s+n2OHcQWFVCRmHJyG9sE\r
  61         RqFZSLpnIemehdC9gJF5FaNsSm6Vbm5iZk5xarJucXJiXl5qka6xXm5miV5qSukmRnBYS/Lt\r
  62         YPx6UOkQowAHoxIPbyBvkr8Qa2JZcWXuIUZJDiYlUd414UAhvqT8lMqMxOKM+KLSnNTiQ4wS\r
  63         HMxKIrwZBon+QrwpiZVVqUX5MClpDhYlcV41rXd+QgLpiSWp2ampBalFMFkZDg4lCV4PYPwK\r
  64         CRalpqdWpGXmlCCkmTg4QYbzAA23BanhLS5IzC3OTIfIn2LU5ehb+OgSoxBLXn5eqpQ4byhI\r
  65         kQBIUUZpHtwcWDp6xSgO9JYwrxNIFQ8wlcFNegW0hAloScm3OJAlJYkIKakGRqnM1U8W1vzp\r
  66         Ur6f5+4vd2Bj21R/jXcCRWv/trzZ2n86+UXdy+B46/riOsv9uerThS8ZzPpfcbuZsaHvjvPH\r
  67         +DXLF+lNaI7K1H9fwVky4WzGzbTD/VUVpU5f39xU3lV0JcThVpm3i9WspWpTc65vvLhJmtHF\r
  68         dV535MyF2nXtXHJmYeEVTe7/lViKMxINtZiLihMBjklQsyIDAAA=\r
  69 Cc: notmuch@notmuchmail.org\r
  70 X-BeenThere: notmuch@notmuchmail.org\r
  71 X-Mailman-Version: 2.1.13\r
  72 Precedence: list\r
  73 List-Id: "Use and development of the notmuch mail system."\r
  74         <notmuch.notmuchmail.org>\r
  75 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  76         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  77 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  78 List-Post: <mailto:notmuch@notmuchmail.org>\r
  79 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  80 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  81         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  82 X-List-Received-Date: Thu, 15 Mar 2012 21:11:12 -0000\r
  83 \r
  84 Quoth Andrei POPESCU on Mar 15 at 11:39 am:\r
  85 > On Ma, 17 ian 12, 17:29:23, Austin Clements wrote:\r
  86 > > Quoth Andrei Popescu on Jan 18 at 12:14 am:\r
  87 > > > \r
  88 > > > If I get around to write something myself where do you suggest I should \r
  89 > > > start, the wiki or the manpage?\r
  90 > > \r
  91 > > Probably expanding man/man7/notmuch-search-terms.7 would be the way to\r
  92 > > go.\r
  93 > \r
  94 > I went against your advice and created a new wiki page[1]. It is \r
  95 > currently not linked from anywhere on purpose, but IMVHO it would be \r
  96 > nice to have it linked from the home page.\r
  97 > \r
  98 > [1] http://notmuchmail.org/searching/\r
  99 > \r
 100 > Before that I would appreciate comments, corrections, etc. and \r
 101 > especially something to put in the 'Synonyms' section.\r
 102 \r
 103 I think having two divergent documents covering the same thing is less\r
 104 than ideal, but perhaps they could be merged in the near future.\r
 105 \r
 106 A few comments:\r
 107 \r
 108 The section on "Languages other than English" isn't quite correct.\r
 109 Xapian has no idea what language is being used, so it will still stem\r
 110 terms in other languages, but using English stemming rules.\r
 111 \r
 112 Notmuch doesn't use synonyms.\r
 113 \r
 114 It might be worth pointing out that "+term1" and "term1" are\r
 115 equivalent.\r
 116 \r
 117 "notmuch search -term2" doesn't actually work.  I've never looked in\r
 118 to why, but I've found that Xapian ignores '-' at the beginning of a\r
 119 query or a parenthesized expression.  "notmuch search term1 -term2"\r
 120 will work.\r
 121 \r
 122 In the brackets section, you'll need shell escaping for those queries\r
 123 to work.  It might be worth pointing out the need for shell escaping\r
 124 at the beginning.\r
 125 \r
 126 XOR, NEAR, and ADJ were intentionally undocumented in\r
 127 notmuch-search-terms because they may go away some day and we don't\r
 128 want people thinking they can depend on them.\r