45/016b57622dab62887703d30c18b85890d832cd

   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 D8282429E21\r
   6         for <notmuch@notmuchmail.org>; Fri, 16 Dec 2011 08:01:48 -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: -2.3\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-2.3 tagged_above=-999 required=5\r
  12         tests=[RCVD_IN_DNSWL_MED=-2.3] autolearn=unavailable\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 Mhvl8IMDSfpC for <notmuch@notmuchmail.org>;\r
  16         Fri, 16 Dec 2011 08:01:48 -0800 (PST)\r
  17 Received: from tempo.its.unb.ca (tempo.its.unb.ca [131.202.1.21])\r
  18         (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))\r
  19         (No client certificate requested)\r
  20         by olra.theworths.org (Postfix) with ESMTPS id 98FDC431FD0\r
  21         for <notmuch@notmuchmail.org>; Fri, 16 Dec 2011 08:01:48 -0800 (PST)\r
  22 Received: from zancas.localnet\r
  23         (fctnnbsc36w-156034079193.pppoe-dynamic.High-Speed.nb.bellaliant.net\r
  24         [156.34.79.193]) (authenticated bits=0)\r
  25         by tempo.its.unb.ca (8.13.8/8.13.8) with ESMTP id pBGG1heY017747\r
  26         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NO);\r
  27         Fri, 16 Dec 2011 12:01:46 -0400\r
  28 Received: from bremner by zancas.localnet with local (Exim 4.77)\r
  29         (envelope-from <bremner@unb.ca>)\r
  30         id 1RbaEA-0004oY-Q0; Fri, 16 Dec 2011 12:01:42 -0400\r
  31 From: David Bremner <bremner@unb.ca>\r
  32 To: "Notmuch Mail" <notmuch@notmuchmail.org>\r
  33 Subject: have "notmuch help" call man?\r
  34 User-Agent: Notmuch/0.10.2+100~g430fb27 (http://notmuchmail.org) Emacs/23.3.1\r
  35         (x86_64-pc-linux-gnu)\r
  36 Date: Fri, 16 Dec 2011 12:01:42 -0400\r
  37 Message-ID: <87zkescxp5.fsf@zancas.localnet>\r
  38 MIME-Version: 1.0\r
  39 Content-Type: text/plain; charset=us-ascii\r
  40 X-BeenThere: notmuch@notmuchmail.org\r
  41 X-Mailman-Version: 2.1.13\r
  42 Precedence: list\r
  43 List-Id: "Use and development of the notmuch mail system."\r
  44         <notmuch.notmuchmail.org>\r
  45 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  46         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  47 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  48 List-Post: <mailto:notmuch@notmuchmail.org>\r
  49 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  50 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  51         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  52 X-List-Received-Date: Fri, 16 Dec 2011 16:01:49 -0000\r
  53 \r
  54 \r
  55 Hi All;\r
  56 \r
  57 Currently help strings are compiled into the notmuch binary. This is a\r
  58 bit a of pain, since we have the same help text in two places.\r
  59 What do you think about having "notmuch help foo" invoke "man\r
  60 notmuch-foo" and create appropriate man pages (or links).\r
  61 \r
  62 There are other ways around the maintenance dilemma, including\r
  63 generating man pages and online help from some common source (e.g. in\r
  64 the style of id:"1288804736-5173-3-git-send-email-david@tethera.net").\r
  65 \r
  66 For downsides, it might complicate things slightly for people who\r
  67 install notmuch in "odd" places. On the other hand, it is no worse than\r
  68 setting LD_LIBRARY_PATH. Also, there is the question of common text like\r
  69 search-terms, which could be included in every page, or maybe contained\r
  70 in man notmuch.\r
  71 \r
  72 David\r