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