42/1503328684d8bea90f2d8adabb77531e64c801

   1 Return-Path: <bremner@unb.ca>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id E25B3431FBC\r
   6         for <notmuch@notmuchmail.org>; Tue, 12 Feb 2013 10:54:04 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: 0\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
  12         autolearn=disabled\r
  13 Received: from olra.theworths.org ([127.0.0.1])\r
  14         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15         with ESMTP id PIHwI4jY4Sx9 for <notmuch@notmuchmail.org>;\r
  16         Tue, 12 Feb 2013 10:54:02 -0800 (PST)\r
  17 Received: from tesseract.cs.unb.ca (tesseract.cs.unb.ca [131.202.240.238])\r
  18         (using TLSv1 with cipher DHE-RSA-AES128-SHA (128/128 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id E1D4D431FAF\r
  21         for <notmuch@notmuchmail.org>; Tue, 12 Feb 2013 10:54:02 -0800 (PST)\r
  22 Received: from convex-new.cs.unb.ca ([131.202.245.35])\r
  23         by tesseract.cs.unb.ca with esmtpsa\r
  24         (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80)\r
  25         (envelope-from <bremner@unb.ca>)\r
  26         id 1U5KzQ-0003oo-0u; Tue, 12 Feb 2013 14:54:00 -0400\r
  27 Received: from bremner by convex-new.cs.unb.ca with local (Exim 4.80)\r
  28         (envelope-from <bremner@unb.ca>)\r
  29         id 1U5KzJ-0006Ub-LC; Tue, 12 Feb 2013 14:53:53 -0400\r
  30 From: David Bremner <david@tethera.net>\r
  31 To: Jameson Graef Rollins <jrollins@finestructure.net>,\r
  32         Jani Nikula <jani@nikula.org>, notmuch@notmuchmail.org\r
  33 Subject: Re: [PATCH 0/6] notmuch cli config changes\r
  34 In-Reply-To: <87a9r9o4ks.fsf@servo.finestructure.net>\r
  35 References: <cover.1359495450.git.jani@nikula.org>\r
  36         <871ucts54t.fsf@servo.finestructure.net>\r
  37         <87y5f0fhtd.fsf@zancas.localnet>\r
  38         <87fw12nf7w.fsf@servo.finestructure.net>\r
  39         <87k3qd92sw.fsf@zancas.localnet>\r
  40         <87a9r9o4ks.fsf@servo.finestructure.net>\r
  41 User-Agent: Notmuch/0.14+257~ge43e0af (http://notmuchmail.org) Emacs/24.2.1\r
  42         (x86_64-pc-linux-gnu)\r
  43 Date: Tue, 12 Feb 2013 14:53:53 -0400\r
  44 Message-ID: <87pq05icse.fsf@convex-new.cs.unb.ca>\r
  45 MIME-Version: 1.0\r
  46 Content-Type: text/plain\r
  47 X-Spam_bar: -\r
  48 X-BeenThere: notmuch@notmuchmail.org\r
  49 X-Mailman-Version: 2.1.13\r
  50 Precedence: list\r
  51 List-Id: "Use and development of the notmuch mail system."\r
  52         <notmuch.notmuchmail.org>\r
  53 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  54         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  55 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  56 List-Post: <mailto:notmuch@notmuchmail.org>\r
  57 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  58 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  59         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  60 X-List-Received-Date: Tue, 12 Feb 2013 18:54:05 -0000\r
  61 \r
  62 Jameson Graef Rollins <jrollins@finestructure.net> writes:\r
  63 \r
  64 > But don't get me wrong, the CLI is one of the things that makes notmuch\r
  65 > so incredibly awesome.  It's an email swiss army knife that's there when\r
  66 > you need it.  But given that even I often need to look at the man page\r
  67 > during my occasional CLI usage, I just don't want to see it get to\r
  68 > overcrowded.\r
  69 \r
  70 Well, maybe this should be a discussion about how to organize the CLI\r
  71 documentation so that more commonly used options are easy to find. That\r
  72 would indeed be a side effect of making less commonly used options\r
  73 controlled by environment variables, and documenting the environment\r
  74 variables at the bottom of the man pages as per tradition. But I don't\r
  75 think this is the only way or even the best way to achieve good\r
  76 documentation.\r
  77 \r
  78 d\r