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

diff --git a/a6/0baa611de2ae0b53f67de883d123944193116e b/a6/0baa611de2ae0b53f67de883d123944193116e
new file mode 100644 (file)
index 0000000..5968d33
--- /dev/null
+++ b/a6/0baa611de2ae0b53f67de883d123944193116e
@@ -0,0 +1,73 @@
+Return-Path: <bremner@unb.ca>\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 1015B431FAF\r
+       for <notmuch@notmuchmail.org>; Mon, 19 Mar 2012 14:46:49 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
+       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 B2qy-MqFmFKh for <notmuch@notmuchmail.org>;\r
+       Mon, 19 Mar 2012 14:46:46 -0700 (PDT)\r
+Received: from tesseract.cs.unb.ca (tesseract.cs.unb.ca [131.202.240.238])\r
+       (using TLSv1 with cipher AES256-SHA (256/256 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id DA1C8431FAE\r
+       for <notmuch@notmuchmail.org>; Mon, 19 Mar 2012 14:46:46 -0700 (PDT)\r
+Received: from fctnnbsc30w-142166230117.dhcp-dynamic.fibreop.nb.bellaliant.net\r
+       ([142.166.230.117] helo=rocinante.cs.unb.ca)\r
+       by tesseract.cs.unb.ca with esmtpsa (TLS1.0:RSA_AES_256_CBC_SHA1:32)\r
+       (Exim 4.72) (envelope-from <bremner@unb.ca>)\r
+       id 1S9kPc-0008JK-DN; Mon, 19 Mar 2012 18:46:44 -0300\r
+Received: from bremner by rocinante.cs.unb.ca with local (Exim 4.77)\r
+       (envelope-from <bremner@unb.ca>)\r
+       id 1S8gvn-0006Bh-V6; Fri, 16 Mar 2012 19:51:35 -0400\r
+From: David Bremner <david@tethera.net>\r
+To: Andrei POPESCU <andreimpopescu@gmail.com>,\r
+       Austin Clements <amdragon@MIT.EDU>\r
+Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving\r
+       notmuch query documentation]\r
+In-Reply-To: <20120316222952.GA4510@sid.nuvreauspam>\r
+References: <20120316222952.GA4510@sid.nuvreauspam>\r
+User-Agent: Notmuch/0.11.1+166~gd2ef4ed (http://notmuchmail.org) Emacs/23.3.1\r
+       (x86_64-pc-linux-gnu)\r
+Date: Fri, 16 Mar 2012 19:51:35 -0400\r
+Message-ID: <87mx7gxfy0.fsf@rocinante.cs.unb.ca>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+X-Spam_bar: -\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: Mon, 19 Mar 2012 21:46:49 -0000\r
+\r
+On Sat, 17 Mar 2012 00:29:52 +0200, Andrei POPESCU <andreimpopescu@gmail.com> wrote:\r
+> On Jo, 15 mar 12, 22:11:24, Austin Clements wrote:\r
+\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
+> Does this make sense?\r
+> \r
+\r
+I don't see that happening in the near future since all notmuch help\r
+does is call man. As Austin said, you're welcome to improve the man\r
+pages, but making them diverge from the help would require a complete\r
+rewrite of all of the help.\r
+\r
+d\r