72/6aded7609c60d7470009732d7d52e0204f8640

   1 Return-Path: <tomi.ollila@nixu.com>\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 0A886431FD0\r
   6         for <notmuch@notmuchmail.org>; Sat, 17 Dec 2011 01:57:03 -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 E+grm-G50HJj for <notmuch@notmuchmail.org>;\r
  16         Sat, 17 Dec 2011 01:57:02 -0800 (PST)\r
  17 Received: from mail-gw3.nixu.fi (mail-gw3.nixu.fi [193.209.237.7])\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 1EA10431FB6\r
  21         for <notmuch@notmuchmail.org>; Sat, 17 Dec 2011 01:57:01 -0800 (PST)\r
  22 Received: from pps.filterd (mail-gw3 [127.0.0.1])\r
  23         by mail-gw3.nixu.fi (8.14.4/8.14.4) with SMTP id pBH9uxIn016751;\r
  24         Sat, 17 Dec 2011 11:56:59 +0200\r
  25 Received: from taco2.nixu.fi (taco2.nixu.fi [194.197.118.31])\r
  26         by mail-gw3.nixu.fi with ESMTP id 114cs0u07v-1\r
  27         (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=NOT);\r
  28         Sat, 17 Dec 2011 11:56:59 +0200\r
  29 Received: from taco2.nixu.fi (taco2.nixu.fi [194.197.118.31])\r
  30         by taco2.nixu.fi (8.14.3/8.14.3/Debian-5+lenny1) with ESMTP id\r
  31         pBH9uv0J009276; Sat, 17 Dec 2011 11:56:58 +0200\r
  32 From: Tomi Ollila <tomi.ollila@iki.fi>\r
  33 To: David Bremner <bremner@unb.ca>, Notmuch Mail <notmuch@notmuchmail.org>\r
  34 Subject: Re: have "notmuch help" call man?\r
  35 In-Reply-To: <87zkescxp5.fsf@zancas.localnet>\r
  36 References: <87zkescxp5.fsf@zancas.localnet>\r
  37 User-Agent: Notmuch/0.10.2+93~g631d290 (http://notmuchmail.org) Emacs/23.3.1\r
  38         (i686-pc-linux-gnu)\r
  39 X-Face: HhBM'cA~<r"^Xv\KRN0P{vn'Y"Kd;zg_y3S[4)KSN~s?O\"QPoL\r
  40         $[Xv_BD:i/F$WiEWax}R(MPS`^UaptOGD`*/=@\1lKoVa9tnrg0TW?"r7aRtgk[F\r
  41         !)g;OY^,BjTbr)Np:%c_o'jj,Z\r
  42 Date: Sat, 17 Dec 2011 11:56:57 +0200\r
  43 Message-ID: <yf61us35xna.fsf@taco2.nixu.fi>\r
  44 MIME-Version: 1.0\r
  45 Content-Type: text/plain; charset=us-ascii\r
  46 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:5.5.7110,\r
  47  1.0.211,       0.0.0000        definitions=2011-12-17_01:2011-12-16, 2011-12-17,\r
  48         1970-01-01 signatures=0\r
  49 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 spamscore=0\r
  50         ipscore=0 suspectscore=0\r
  51         phishscore=0 bulkscore=0 adultscore=0 classifier=spam adjust=0\r
  52         reason=mlx\r
  53         scancount=1 engine=6.0.2-1012030000 definitions=main-1112170029\r
  54 X-BeenThere: notmuch@notmuchmail.org\r
  55 X-Mailman-Version: 2.1.13\r
  56 Precedence: list\r
  57 List-Id: "Use and development of the notmuch mail system."\r
  58         <notmuch.notmuchmail.org>\r
  59 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  60         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  61 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  62 List-Post: <mailto:notmuch@notmuchmail.org>\r
  63 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  64 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  65         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  66 X-List-Received-Date: Sat, 17 Dec 2011 09:57:03 -0000\r
  67 \r
  68 On Fri, 16 Dec 2011 12:01:42 -0400, David Bremner <bremner@unb.ca> wrote:\r
  69 > \r
  70 > Hi All;\r
  71 > \r
  72 > Currently help strings are compiled into the notmuch binary. This is a\r
  73 > bit a of pain, since we have the same help text in two places.\r
  74 > What do you think about having "notmuch help foo" invoke "man\r
  75 > notmuch-foo" and create appropriate man pages (or links).\r
  76 \r
  77 +1\r
  78 \r
  79 > There are other ways around the maintenance dilemma, including\r
  80 > generating man pages and online help from some common source (e.g. in\r
  81 > the style of id:"1288804736-5173-3-git-send-email-david@tethera.net").\r
  82 \r
  83 In that case we dilemma is what would be the most suitable source format\r
  84 (pod, mdwn, rst, nroff, ...)...\r
  85 \r
  86 > For downsides, it might complicate things slightly for people who\r
  87 > install notmuch in "odd" places. On the other hand, it is no worse than\r
  88 > setting LD_LIBRARY_PATH. Also, there is the question of common text like\r
  89 > search-terms, which could be included in every page, or maybe contained\r
  90 > in man notmuch.\r
  91 \r
  92 Those people who install notmuch in "odd" places (I'm one of those) can\r
  93 also define MANPATH...\r
  94 \r
  95 Nroff provides the .so "request" which includes other nroff source.\r
  96 \r
  97 for example /usr/share/man/man1/zshall.1.gz includes all other zsh\r
  98 namual pages.\r
  99 \r
 100 ... however it is common to have SEE ALSO at the end of each manual page\r
 101 \r
 102 SEE ALSO\r
 103     notmuch(1), notmuch-search-terms(7)\r
 104 \r
 105 > \r
 106 > David\r
 107 \r
 108 Tomi\r