From 99f02bcbbcc698808462e2ce9454d0c2dce8c048 Mon Sep 17 00:00:00 2001 From: David Bremner Date: Sat, 17 Mar 2012 13:52:35 +2100 Subject: [PATCH] Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving notmuch query documentation] --- 6b/839334b3302cf028bfa8b77aaafb487bce3cf5 | 80 +++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 6b/839334b3302cf028bfa8b77aaafb487bce3cf5 diff --git a/6b/839334b3302cf028bfa8b77aaafb487bce3cf5 b/6b/839334b3302cf028bfa8b77aaafb487bce3cf5 new file mode 100644 index 000000000..815f9b2cf --- /dev/null +++ b/6b/839334b3302cf028bfa8b77aaafb487bce3cf5 @@ -0,0 +1,80 @@ +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 72FE9431FAF + for ; Fri, 16 Mar 2012 09:52:49 -0700 (PDT) +X-Virus-Scanned: Debian amavisd-new at olra.theworths.org +X-Spam-Flag: NO +X-Spam-Score: 0 +X-Spam-Level: +X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none] + 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 mxXeGuh0n6LV for ; + Fri, 16 Mar 2012 09:52:48 -0700 (PDT) +Received: from tesseract.cs.unb.ca (tesseract.cs.unb.ca [131.202.240.238]) + (using TLSv1 with cipher AES256-SHA (256/256 bits)) + (No client certificate requested) + by olra.theworths.org (Postfix) with ESMTPS id CE7A5431FAE + for ; Fri, 16 Mar 2012 09:52:48 -0700 (PDT) +Received: from [131.202.13.154] (helo=convex-new.cs.unb.ca) + by tesseract.cs.unb.ca with esmtpsa (TLS1.0:RSA_AES_256_CBC_SHA1:32) + (Exim 4.72) (envelope-from ) + id 1S8aOO-00051W-SR; Fri, 16 Mar 2012 13:52:45 -0300 +Received: from bremner by convex-new.cs.unb.ca with local (Exim 4.72) + (envelope-from ) + id 1S8aOJ-0007ch-Os; Fri, 16 Mar 2012 13:52:35 -0300 +From: David Bremner +To: Andrei POPESCU , notmuch@notmuchmail.org +Subject: Re: [RFC] http://notmuchmail.org/searching/ [was: Re: Improving + notmuch query documentation] +In-Reply-To: <20120316003053.GR2981@sid.nuvreauspam> +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> + <20120315093941.GK2981@sid.nuvreauspam> + <20120315211107.GA2670@mit.edu> + <20120316003053.GR2981@sid.nuvreauspam> +User-Agent: Notmuch/0.11.1+276~g1aa4abe (http://notmuchmail.org) Emacs/23.3.1 + (x86_64-pc-linux-gnu) +Date: Fri, 16 Mar 2012 13:52:35 -0300 +Message-ID: <87r4wso5d8.fsf@convex-new.cs.unb.ca> +MIME-Version: 1.0 +Content-Type: text/plain; charset=us-ascii +X-Spam_bar: - +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: Fri, 16 Mar 2012 16:52:49 -0000 + +On Fri, 16 Mar 2012 02:30:53 +0200, Andrei POPESCU wrote: + +> +> Regarding 'notmuch help search-terms': +> +> $ notmuch help search-terms | wc -l +> 88 +> +> IMHO that text is better suited for a manpage, the help should be just a +> (very short) reference to refresh ones memory. What do you think? +> + +I'm less worried about the length of the documentation than about +fragmentation. So I think if something is reference material, it should +go in the man pages, or at least ship with notmuch. + +d -- 2.26.2