From 02108cd616f7255f71707d8b0b2b95be8ed64283 Mon Sep 17 00:00:00 2001 From: David Bremner Date: Wed, 13 Feb 2013 14:53:53 +2000 Subject: [PATCH] Re: [PATCH 0/6] notmuch cli config changes --- 42/1503328684d8bea90f2d8adabb77531e64c801 | 78 +++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 42/1503328684d8bea90f2d8adabb77531e64c801 diff --git a/42/1503328684d8bea90f2d8adabb77531e64c801 b/42/1503328684d8bea90f2d8adabb77531e64c801 new file mode 100644 index 000000000..cbe282430 --- /dev/null +++ b/42/1503328684d8bea90f2d8adabb77531e64c801 @@ -0,0 +1,78 @@ +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 -- 2.26.2