Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documen...

diff --git a/e1/eb46ac24e25dfb877a47e99d67a1a9fe3f8c94 b/e1/eb46ac24e25dfb877a47e99d67a1a9fe3f8c94
new file mode 100644 (file)
index 0000000..87e814f
--- /dev/null
+++ b/e1/eb46ac24e25dfb877a47e99d67a1a9fe3f8c94
@@ -0,0 +1,93 @@
+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 7F59E431FAF\r
+       for <notmuch@notmuchmail.org>; Sat, 17 Mar 2012 10:16:50 -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 tP-xk4YnTMy9 for <notmuch@notmuchmail.org>;\r
+       Sat, 17 Mar 2012 10:16:50 -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 CDA59431FAE\r
+       for <notmuch@notmuchmail.org>; Sat, 17 Mar 2012 10:16:49 -0700 (PDT)\r
+X-AuditID: 1209190e-b7f7c6d0000008c3-60-4f64c701d356\r
+Received: from mailhub-auth-4.mit.edu ( [18.7.62.39])\r
+       by dmz-mailsec-scanner-3.mit.edu (Symantec Messaging Gateway) with SMTP\r
+       id 0D.16.02243.107C46F4; Sat, 17 Mar 2012 13:16:49 -0400 (EDT)\r
+Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103])\r
+       by mailhub-auth-4.mit.edu (8.13.8/8.9.2) with ESMTP id q2HHGmqp021565; \r
+       Sat, 17 Mar 2012 13:16:49 -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 q2HHGliA015883\r
+       (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
+       Sat, 17 Mar 2012 13:16:48 -0400 (EDT)\r
+Received: from amthrax by awakening.csail.mit.edu with local (Exim 4.77)\r
+       (envelope-from <amdragon@mit.edu>)\r
+       id 1S8xFH-0004Dn-8Y; Sat, 17 Mar 2012 13:16:47 -0400\r
+Date: Sat, 17 Mar 2012 13:16:47 -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: <20120317171647.GL2670@mit.edu>\r
+References: <87r4wso5d8.fsf@convex-new.cs.unb.ca>\r
+       <20120316021124.GD2670@mit.edu>\r
+       <20120316222952.GA4510@sid.nuvreauspam>\r
+       <20120317002017.GG2670@mit.edu>\r
+       <20120317144008.GB4510@sid.nuvreauspam>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+Content-Disposition: inline\r
+In-Reply-To: <20120317144008.GB4510@sid.nuvreauspam>\r
+User-Agent: Mutt/1.5.21 (2010-09-15)\r
+X-Brightmail-Tracker:\r
+ H4sIAAAAAAAAA+NgFuplleLIzCtJLcpLzFFi42IRYrdT12U8nuJvsPeJpMWqCdIWN1q7GS2u\r
+       35zJ7MDssXPWXXaPZ6tuMXtsOfSeOYA5issmJTUnsyy1SN8ugSvj7/nDjAWnWCquNyk0MF5l\r
+       7mLk5JAQMJFomjeRHcIWk7hwbz1bFyMXh5DAPkaJ93O+MkE4GxglPr1cAeWcZJJ4+bODFcJZ\r
+       wiix/OwrNpB+FgFViRuPXjGC2GwCGhLb9i8Hs0UEdCU6Xx1gArGZBewkjnzvAosLC6RLPNsw\r
+       DczmFdCWeHZjGgvUBkaJYw/PsEIkBCVOznzCAtGsJXHj30ugQRxAtrTE8n8cIGFOoB86p/0C\r
+       +0FUQEViysltbBMYhWYh6Z6FpHsWQvcCRuZVjLIpuVW6uYmZOcWpybrFyYl5ealFusZ6uZkl\r
+       eqkppZsYQaHOKcm3g/HrQaVDjAIcjEo8vBwTkv2FWBPLiitzDzFKcjApifIyHkjxF+JLyk+p\r
+       zEgszogvKs1JLT7EKMHBrCTCK7UcKMebklhZlVqUD5OS5mBREudV03rnJySQnliSmp2aWpBa\r
+       BJOV4eBQkuBNPwbUKFiUmp5akZaZU4KQZuLgBBnOAzR8NkgNb3FBYm5xZjpE/hSjopQ4bwhI\r
+       QgAkkVGaB9cLS0WvGMWBXhHmrQGp4gGmMbjuV0CDmYAGzyxLBhlckoiQkmpg9NB/eOqrZezz\r
+       P8W1LyMXfMq+4q0b1+kYmv2r89TVqLvnHZaWVTZ5hiy6s3pW9wK3G8/O2/es5F/nIHH0YNvi\r
+       E5LLVrwynGIgwDuZ7e+S2aJnJ67lF3GU7zzs/eUFU4LJudSawgaO0rk/1XK9y4I2eSxN+FZl\r
+       PY179cPI1coK25e6uOfyyn7IVmIpzkg01GIuKk4EAAUHrb0gAwAA\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: Sat, 17 Mar 2012 17:16:50 -0000\r
+\r
+Quoth Andrei POPESCU on Mar 17 at  4:40 pm:\r
+> > > As I see it, the manpage (specifically section 'SEARCH SYNTAX' needs to \r
+> > > be expanded somewhat and 'help search-terms' shortened (a lot).\r
+\r
+I realized that I didn't have a 'SEARCH SYNTAX' section and went\r
+digging into notmuch's code history.  Are you running from git or\r
+0.11?\r
+\r
+We completely restructured and unified the documentation several\r
+months ago, but it looks like we did so just days after the 0.11\r
+freeze, which means there hasn't been a stable release with the new\r
+documentation yet (though one is imminent).\r