From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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.