Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documen...
authorAustin Clements <amdragon@MIT.EDU>
Thu, 15 Mar 2012 21:11:08 +0000 (17:11 +2000)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 17:45:32 +0000 (09:45 -0800)
a7/f7e89e656db597cbe2fc01af3521864aeba296 [new file with mode: 0644]

diff --git a/a7/f7e89e656db597cbe2fc01af3521864aeba296 b/a7/f7e89e656db597cbe2fc01af3521864aeba296
new file mode 100644 (file)
index 0000000..a2df438
--- /dev/null
@@ -0,0 +1,128 @@
+Return-Path: <amdragon@mit.edu>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id 94AE4431FAF\r
+       for <notmuch@notmuchmail.org>; Thu, 15 Mar 2012 14:11:12 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.7\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.7 tagged_above=-999 required=5\r
+       tests=[RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id JZCy88ZZrPXO for <notmuch@notmuchmail.org>;\r
+       Thu, 15 Mar 2012 14:11:10 -0700 (PDT)\r
+Received: from dmz-mailsec-scanner-3.mit.edu (DMZ-MAILSEC-SCANNER-3.MIT.EDU\r
+       [18.9.25.14])\r
+       by olra.theworths.org (Postfix) with ESMTP id ADFCA431FAE\r
+       for <notmuch@notmuchmail.org>; Thu, 15 Mar 2012 14:11:10 -0700 (PDT)\r
+X-AuditID: 1209190e-b7f7c6d0000008c3-ce-4f625aeee464\r
+Received: from mailhub-auth-3.mit.edu ( [18.9.21.43])\r
+       by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP\r
+       id 47.53.02243.EEA526F4; Thu, 15 Mar 2012 17:11:10 -0400 (EDT)\r
+Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
+       by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id q2FLB9fg024011; \r
+       Thu, 15 Mar 2012 17:11:10 -0400\r
+Received: from awakening.csail.mit.edu (awakening.csail.mit.edu [18.26.4.91])\r
+       (authenticated bits=0)\r
+       (User authenticated as amdragon@ATHENA.MIT.EDU)\r
+       by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id q2FLB8in022978\r
+       (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
+       Thu, 15 Mar 2012 17:11:09 -0400 (EDT)\r
+Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.77)\r
+       (envelope-from <amdragon@mit.edu>)\r
+       id 1S8Hwy-00011k-2Q; Thu, 15 Mar 2012 17:11:08 -0400\r
+Date: Thu, 15 Mar 2012 17:11:08 -0400\r
+From: Austin Clements <amdragon@MIT.EDU>\r
+To: Andrei POPESCU <andreimpopescu@gmail.com>\r
+Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving\r
+       notmuch query documentation]\r
+Message-ID: <20120315211107.GA2670@mit.edu>\r
+References: <20120115220600.GO7037@think.nuvreauspam>\r
+       <877h0sa207.fsf@fester.com>\r
+       <20120116202103.GA14329@think.nuvreauspam>\r
+       <20120117023431.GF16740@mit.edu>\r
+       <20120117221435.GN3272@think.nuvreauspam>\r
+       <20120117222923.GU16740@mit.edu>\r
+       <20120315093941.GK2981@sid.nuvreauspam>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+Content-Disposition: inline\r
+In-Reply-To: <20120315093941.GK2981@sid.nuvreauspam>\r
+User-Agent: Mutt/1.5.21 (2010-09-15)\r
+X-Brightmail-Tracker:\r
+ H4sIAAAAAAAAA+NgFupnleLIzCtJLcpLzFFi42IR4hTV1n0XleRvMPMmr8WqCdIW12/OZHZg\r
+       8tg56y67x7NVt5gDmKK4bFJSczLLUov07RK4Mi6vqCh4yFux+VsjWwPjZ64uRk4OCQETiYN/\r
+       zzFB2GISF+6tZ+ti5OIQEtjHKNGw6isLhLOBUeLozl2MEM5JJonulxehMksYJTb9+c8K0s8i\r
+       oCoxZWsXG4jNJqAhsW3/ckYQW0RAV6Lz1QGwHcwC0hLffjeD2cIC6RLPNkwDq+EV0JY4vu0/\r
+       1O45TBKdT1pZIRKCEidnPmGBaNaSuPHvJVAzB9ig5f84QMKcQD+s+n2OHcQWFVCRmHJyG9sE\r
+       RqFZSLpnIemehdC9gJF5FaNsSm6Vbm5iZk5xarJucXJiXl5qka6xXm5miV5qSukmRnBYS/Lt\r
+       YPx6UOkQowAHoxIPbyBvkr8Qa2JZcWXuIUZJDiYlUd414UAhvqT8lMqMxOKM+KLSnNTiQ4wS\r
+       HMxKIrwZBon+QrwpiZVVqUX5MClpDhYlcV41rXd+QgLpiSWp2ampBalFMFkZDg4lCV4PYPwK\r
+       CRalpqdWpGXmlCCkmTg4QYbzAA23BanhLS5IzC3OTIfIn2LU5ehb+OgSoxBLXn5eqpQ4byhI\r
+       kQBIUUZpHtwcWDp6xSgO9JYwrxNIFQ8wlcFNegW0hAloScm3OJAlJYkIKakGRqnM1U8W1vzp\r
+       Ur6f5+4vd2Bj21R/jXcCRWv/trzZ2n86+UXdy+B46/riOsv9uerThS8ZzPpfcbuZsaHvjvPH\r
+       +DXLF+lNaI7K1H9fwVky4WzGzbTD/VUVpU5f39xU3lV0JcThVpm3i9WspWpTc65vvLhJmtHF\r
+       dV535MyF2nXtXHJmYeEVTe7/lViKMxINtZiLihMBjklQsyIDAAA=\r
+Cc: notmuch@notmuchmail.org\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Thu, 15 Mar 2012 21:11:12 -0000\r
+\r
+Quoth Andrei POPESCU on Mar 15 at 11:39 am:\r
+> On Ma, 17 ian 12, 17:29:23, Austin Clements wrote:\r
+> > Quoth Andrei Popescu on Jan 18 at 12:14 am:\r
+> > > \r
+> > > If I get around to write something myself where do you suggest I should \r
+> > > start, the wiki or the manpage?\r
+> > \r
+> > Probably expanding man/man7/notmuch-search-terms.7 would be the way to\r
+> > go.\r
+> \r
+> I went against your advice and created a new wiki page[1]. It is \r
+> currently not linked from anywhere on purpose, but IMVHO it would be \r
+> nice to have it linked from the home page.\r
+> \r
+> [1] http://notmuchmail.org/searching/\r
+> \r
+> Before that I would appreciate comments, corrections, etc. and \r
+> especially something to put in the 'Synonyms' section.\r
+\r
+I think having two divergent documents covering the same thing is less\r
+than ideal, but perhaps they could be merged in the near future.\r
+\r
+A few comments:\r
+\r
+The section on "Languages other than English" isn't quite correct.\r
+Xapian has no idea what language is being used, so it will still stem\r
+terms in other languages, but using English stemming rules.\r
+\r
+Notmuch doesn't use synonyms.\r
+\r
+It might be worth pointing out that "+term1" and "term1" are\r
+equivalent.\r
+\r
+"notmuch search -term2" doesn't actually work.  I've never looked in\r
+to why, but I've found that Xapian ignores '-' at the beginning of a\r
+query or a parenthesized expression.  "notmuch search term1 -term2"\r
+will work.\r
+\r
+In the brackets section, you'll need shell escaping for those queries\r
+to work.  It might be worth pointing out the need for shell escaping\r
+at the beginning.\r
+\r
+XOR, NEAR, and ADJ were intentionally undocumented in\r
+notmuch-search-terms because they may go away some day and we don't\r
+want people thinking they can depend on them.\r