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

diff --git a/6b/839334b3302cf028bfa8b77aaafb487bce3cf5 b/6b/839334b3302cf028bfa8b77aaafb487bce3cf5
new file mode 100644 (file)
index 0000000..815f9b2
--- /dev/null
+++ b/6b/839334b3302cf028bfa8b77aaafb487bce3cf5
@@ -0,0 +1,80 @@
+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 72FE9431FAF\r
+       for <notmuch@notmuchmail.org>; Fri, 16 Mar 2012 09:52: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 mxXeGuh0n6LV for <notmuch@notmuchmail.org>;\r
+       Fri, 16 Mar 2012 09:52:48 -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 CE7A5431FAE\r
+       for <notmuch@notmuchmail.org>; Fri, 16 Mar 2012 09:52:48 -0700 (PDT)\r
+Received: from [131.202.13.154] (helo=convex-new.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 1S8aOO-00051W-SR; Fri, 16 Mar 2012 13:52:45 -0300\r
+Received: from bremner by convex-new.cs.unb.ca with local (Exim 4.72)\r
+       (envelope-from <bremner@unb.ca>)\r
+       id 1S8aOJ-0007ch-Os; Fri, 16 Mar 2012 13:52:35 -0300\r
+From: David Bremner <david@tethera.net>\r
+To: Andrei POPESCU <andreimpopescu@gmail.com>, notmuch@notmuchmail.org\r
+Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving\r
+       notmuch query documentation]\r
+In-Reply-To: <20120316003053.GR2981@sid.nuvreauspam>\r
+References: <20120115220600.GO7037@think.nuvreauspam>\r
+       <877h0sa207.fsf@fester.com>\r
+       <20120116202103.GA14329@think.nuvreauspam>\r
+       <20120117023431.GF16740@mit.edu>\r
+       <20120117221435.GN3272@think.nuvreauspam>\r
+       <20120117222923.GU16740@mit.edu>\r
+       <20120315093941.GK2981@sid.nuvreauspam>\r
+       <20120315211107.GA2670@mit.edu>\r
+       <20120316003053.GR2981@sid.nuvreauspam>\r
+User-Agent: Notmuch/0.11.1+276~g1aa4abe (http://notmuchmail.org) Emacs/23.3.1\r
+       (x86_64-pc-linux-gnu)\r
+Date: Fri, 16 Mar 2012 13:52:35 -0300\r
+Message-ID: <87r4wso5d8.fsf@convex-new.cs.unb.ca>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=us-ascii\r
+X-Spam_bar: -\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: Fri, 16 Mar 2012 16:52:49 -0000\r
+\r
+On Fri, 16 Mar 2012 02:30:53 +0200, Andrei POPESCU <andreimpopescu@gmail.com> wrote:\r
+\r
+> \r
+> Regarding 'notmuch help search-terms':\r
+> \r
+> $ notmuch help search-terms | wc -l\r
+> 88\r
+> \r
+> IMHO that text is better suited for a manpage, the help should be just a \r
+> (very short) reference to refresh ones memory. What do you think?\r
+>  \r
+\r
+I'm less worried about the length of the documentation than about\r
+fragmentation. So I think if something is reference material, it should\r
+go in the man pages, or at least ship with notmuch.\r
+\r
+d\r