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