Re: doc: notmuch help search-terms, boolean operators

diff --git a/ad/bccc8da4519c4cb848bf99be1445f01b729620 b/ad/bccc8da4519c4cb848bf99be1445f01b729620
new file mode 100644 (file)
index 0000000..53f41c7
--- /dev/null
+++ b/ad/bccc8da4519c4cb848bf99be1445f01b729620
@@ -0,0 +1,82 @@
+Return-Path: <olly@survex.com>\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 0E679429E44\r
+       for <notmuch@notmuchmail.org>; Tue, 26 Apr 2011 16:29:17 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -2.3\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-2.3 tagged_above=-999 required=5\r
+       tests=[RCVD_IN_DNSWL_MED=-2.3] autolearn=unavailable\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 XjR9IlJW1+01 for <notmuch@notmuchmail.org>;\r
+       Tue, 26 Apr 2011 16:29:16 -0700 (PDT)\r
+Received: from atreus.tartarus.org (atreus.tartarus.org [80.252.125.10])\r
+       (using TLSv1 with cipher AES256-SHA (256/256 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id C11D3429E38\r
+       for <notmuch@notmuchmail.org>; Tue, 26 Apr 2011 16:29:16 -0700 (PDT)\r
+Received: from olly by atreus.tartarus.org with local (Exim 4.69)\r
+       (envelope-from <olly@survex.com>)\r
+       id 1QErgv-0003Ah-9I; Wed, 27 Apr 2011 00:29:13 +0100\r
+Date: Wed, 27 Apr 2011 00:29:13 +0100\r
+From: Olly Betts <olly@survex.com>\r
+To: Carl Worth <cworth@cworth.org>\r
+Subject: Re: doc: notmuch help search-terms, boolean operators\r
+Message-ID: <20110426232913.GM24964@survex.com>\r
+References: <87fwp4tzvd.fsf@eve.chaoflow.net>\r
+       <87d3k81ute.fsf@yoom.home.cworth.org>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+Content-Disposition: inline\r
+In-Reply-To: <87d3k81ute.fsf@yoom.home.cworth.org>\r
+User-Agent: Mutt/1.5.18 (2008-05-17)\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: Tue, 26 Apr 2011 23:29:17 -0000\r
+\r
+On Tue, Apr 26, 2011 at 04:01:17PM -0700, Carl Worth wrote:\r
+> On Wed, 27 Apr 2011 00:24:38 +0200, Florian Friesdorf <flo@chaoflow.net> wrote:\r
+> > Through playing with `notmuch tag` and `notmuch search\r
+> > --output=messages` I found:\r
+> > \r
+> > Complete list of boolean operators in order of precedence:\r
+> > - NOT\r
+> > - AND\r
+> > - XOR\r
+> > - OR\r
+> > \r
+> > Is this correct? If yes, I would extend the manpage accordingly.\r
+> \r
+> Currently, notmuch doesn't implement this behavior but relies on\r
+> Xapian's query parser to do so. As such, I'd really prefer to see\r
+> Xapian's documentation augmented here before we start documenting\r
+> any particular behavior in notmuch.\r
+> \r
+> Olly, is the above list of operators complete and in the correct order\r
+> of  precendence?\r
+\r
+Close, but actually AND and NOT have equal precedence.\r
+\r
+Also, NEAR and ADJ bind tighter than AND or NOT.\r
+\r
+And '+' and '-' tightest of all.\r
+\r
+I'll try to make sure this gets documented.\r
+\r
+Cheers,\r
+    Olly\r