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 E25B3431FBC for ; Tue, 12 Feb 2013 10:54:04 -0800 (PST) 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 PIHwI4jY4Sx9 for ; Tue, 12 Feb 2013 10:54:02 -0800 (PST) Received: from tesseract.cs.unb.ca (tesseract.cs.unb.ca [131.202.240.238]) (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by olra.theworths.org (Postfix) with ESMTPS id E1D4D431FAF for ; Tue, 12 Feb 2013 10:54:02 -0800 (PST) Received: from convex-new.cs.unb.ca ([131.202.245.35]) by tesseract.cs.unb.ca with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from ) id 1U5KzQ-0003oo-0u; Tue, 12 Feb 2013 14:54:00 -0400 Received: from bremner by convex-new.cs.unb.ca with local (Exim 4.80) (envelope-from ) id 1U5KzJ-0006Ub-LC; Tue, 12 Feb 2013 14:53:53 -0400 From: David Bremner To: Jameson Graef Rollins , Jani Nikula , notmuch@notmuchmail.org Subject: Re: [PATCH 0/6] notmuch cli config changes In-Reply-To: <87a9r9o4ks.fsf@servo.finestructure.net> References: <871ucts54t.fsf@servo.finestructure.net> <87y5f0fhtd.fsf@zancas.localnet> <87fw12nf7w.fsf@servo.finestructure.net> <87k3qd92sw.fsf@zancas.localnet> <87a9r9o4ks.fsf@servo.finestructure.net> User-Agent: Notmuch/0.14+257~ge43e0af (http://notmuchmail.org) Emacs/24.2.1 (x86_64-pc-linux-gnu) Date: Tue, 12 Feb 2013 14:53:53 -0400 Message-ID: <87pq05icse.fsf@convex-new.cs.unb.ca> MIME-Version: 1.0 Content-Type: text/plain 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: Tue, 12 Feb 2013 18:54:05 -0000 Jameson Graef Rollins writes: > But don't get me wrong, the CLI is one of the things that makes notmuch > so incredibly awesome. It's an email swiss army knife that's there when > you need it. But given that even I often need to look at the man page > during my occasional CLI usage, I just don't want to see it get to > overcrowded. Well, maybe this should be a discussion about how to organize the CLI documentation so that more commonly used options are easy to find. That would indeed be a side effect of making less commonly used options controlled by environment variables, and documenting the environment variables at the bottom of the man pages as per tradition. But I don't think this is the only way or even the best way to achieve good documentation. d