From: Austin Clements Date: Thu, 15 Mar 2012 21:15:36 +0000 (+2000) Subject: Re: Improving notmuch query documentation [was: Re: Partial words on notmuch search?] X-Git-Url: http://git.tremily.us/gitweb.cgi?a=commitdiff_plain;h=dfba7ae784fa8c1100463cf2017ed3bae73e5ef5;p=notmuch-archives.git Re: Improving notmuch query documentation [was: Re: Partial words on notmuch search?] --- diff --git a/98/9800da4ea14b17609c77c1acfb24f8868aa70d b/98/9800da4ea14b17609c77c1acfb24f8868aa70d new file mode 100644 index 000000000..ba2be1d64 --- /dev/null +++ b/98/9800da4ea14b17609c77c1acfb24f8868aa70d @@ -0,0 +1,112 @@ +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 53251431FAF + for ; Thu, 15 Mar 2012 14:15:40 -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 4akZIXLZOqLB for ; + Thu, 15 Mar 2012 14:15:40 -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 D4735431FAE + for ; Thu, 15 Mar 2012 14:15:39 -0700 (PDT) +X-AuditID: 1209190e-b7f7c6d0000008c3-c1-4f625bfb36f0 +Received: from mailhub-auth-4.mit.edu ( [18.7.62.39]) + by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP + id C7.C3.02243.BFB526F4; Thu, 15 Mar 2012 17:15:39 -0400 (EDT) +Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) + by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id q2FLFcM2021256; + Thu, 15 Mar 2012 17:15:38 -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 q2FLFaWW024628 + (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT); + Thu, 15 Mar 2012 17:15:37 -0400 (EDT) +Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.77) + (envelope-from ) + id 1S8I1I-000127-J3; Thu, 15 Mar 2012 17:15:36 -0400 +Date: Thu, 15 Mar 2012 17:15:36 -0400 +From: Austin Clements +To: Mark Anderson +Subject: Re: Improving notmuch query documentation [was: Re: Partial words on + notmuch search?] +Message-ID: <20120315211536.GB2670@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> + <3wd62g6mbtd.fsf@testarossa.amd.com> +MIME-Version: 1.0 +Content-Type: text/plain; charset=us-ascii +Content-Disposition: inline +In-Reply-To: <3wd62g6mbtd.fsf@testarossa.amd.com> +User-Agent: Mutt/1.5.21 (2010-09-15) +X-Brightmail-Tracker: + H4sIAAAAAAAAA+NgFupmleLIzCtJLcpLzFFi42IRYrdT1/0dneRvcPedrMWqCdIWH8/dZbW4 + fnMmswOzR+ulv2weO2fdZfd4tuoWcwBzFJdNSmpOZllqkb5dAlfG3K29rAUruSpad7xna2D8 + xd7FyMkhIWAiMaunF8oWk7hwbz1bFyMXh5DAPkaJidt6WUASQgIbGCUut8tD2CeZJDb8dIIo + WsIo8eH8SWaQBIuAqsTcA61gNpuAhsS2/csZQWwRAS2JO6/XsIHYzALZEjtP9ILZwgIJEmcm + bwar4RXQlnj6cQcbxIKZTBKTNudAxAUlTs58wgLRqyVx499Lpi5GDiBbWmL5Pw6QMKeAocS8 + v/fAHhAVUJGYcnIb2wRGoVlIumch6Z6F0L2AkXkVo2xKbpVubmJmTnFqsm5xcmJeXmqRrrFe + bmaJXmpK6SZGUJhzSvLtYPx6UOkQowAHoxIPbyBvkr8Qa2JZcWXuIUZJDiYlUd5fUUAhvqT8 + lMqMxOKM+KLSnNTiQ4wSHMxKIrwZBon+QrwpiZVVqUX5MClpDhYlcV41rXd+QgLpiSWp2amp + BalFMFkZDg4lCd5CYDwLCRalpqdWpGXmlCCkmTg4QYbzAA3PAqnhLS5IzC3OTIfIn2JUlBLn + 7QZJCIAkMkrz4HphaegVozjQK8K8+SBVPMAUBtf9CmgwE9Dgkm9xIINLEhFSUg2Mzh9m3Fl+ + a9+OLoktz25bXJtz546pXaPWZebuvSxvThSfMPseMYFpvutM7tlTf8jmMTKHee55+u3k0mcF + G448n3yBmeX9pjdmdl9TDBp+f+a9tS9eoXThRAYHH6n4grenDP63FSxdeNx9dufnW2KJqfvs + jot/8tUT1z2y4doVR10Jk8SP/v+PsiixFGckGmoxFxUnAgAXIqZQHgMAAA== +Cc: "notmuch@notmuchmail.org" , + Andrei Popescu +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:15:40 -0000 + +Quoth Mark Anderson on Jan 20 at 12:08 pm: +> On Tue, 17 Jan 2012 16:29:23 -0600, Austin Clements wrote: +> > Quoth Andrei Popescu on Jan 18 at 12:14 am: +> > > On Lu, 16 ian 12, 21:34:31, Austin Clements wrote: +> > > > Quoth Andrei Popescu on Jan 16 at 10:21 pm: +> > > > > Where can I read more about this? (except the source :) +> > > > +> > > > Most of this is in the Xapian query syntax document you found. Really +> > > > we ought to beef-up Notmuch's query syntax documentation. +> > > +> > > 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 would appreciate it if the limitations of id: search were explained +> there too. I have some rules that I would love to make based on pattern +> matching the message-id of the message, because I have a tool that +> generates scads of email and I want to be able to delete a lot of it. +> +> I think that id: is only matchable as an entire string, and a +> confirmation of that would be nice to see. + +This is true. thread:, id:, tag:, and is: are "boolean prefixes", +which means they only match on entire strings. + +What sorts of message-id patterns did you want to search for?