cd/87bd952d5081311207918bb23776919185f23a

   1 Return-Path: <tomi.ollila@iki.fi>\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 arlo.cworth.org (Postfix) with ESMTP id 0C6E96DE1A3F\r
   6  for <notmuch@notmuchmail.org>; Fri,  1 Jan 2016 03:23:29 -0800 (PST)\r
   7 X-Virus-Scanned: Debian amavisd-new at cworth.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: 0.681\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=0.681 tagged_above=-999 required=5 tests=[AWL=0.029, \r
  12  SPF_NEUTRAL=0.652] autolearn=disabled\r
  13 Received: from arlo.cworth.org ([127.0.0.1])\r
  14  by localhost (arlo.cworth.org [127.0.0.1]) (amavisd-new, port 10024)\r
  15  with ESMTP id YWgk5nESi6Lv for <notmuch@notmuchmail.org>;\r
  16  Fri,  1 Jan 2016 03:23:26 -0800 (PST)\r
  17 Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34])\r
  18  by arlo.cworth.org (Postfix) with ESMTP id 7D8356DE1642\r
  19  for <notmuch@notmuchmail.org>; Fri,  1 Jan 2016 03:23:25 -0800 (PST)\r
  20 Received: from guru.guru-group.fi (localhost [IPv6:::1])\r
  21  by guru.guru-group.fi (Postfix) with ESMTP id D823E10008D;\r
  22  Fri,  1 Jan 2016 13:23:37 +0200 (EET)\r
  23 From: Tomi Ollila <tomi.ollila@iki.fi>\r
  24 To: David Bremner <david@tethera.net>, Jani Nikula <jani@nikula.org>,\r
  25  "W. Trevor King" <wking@tremily.us>, notmuch@notmuchmail.org\r
  26 Subject: Re: [PATCH 3/5] nmbug-status: Add an nmbug-status(5) man page\r
  27 In-Reply-To: <87fuyi4iwm.fsf@zancas.localnet>\r
  28 References: <cover.1451502495.git.wking@tremily.us>\r
  29  <0a1bd306cb2e306ff49d72b6d2466c1d4a0ade2b.1451502495.git.wking@tremily.us>\r
  30  <87ege26fi4.fsf@nikula.org> <87fuyi4iwm.fsf@zancas.localnet>\r
  31 User-Agent: Notmuch/0.21+32~g73439f8 (http://notmuchmail.org) Emacs/24.3.1\r
  32  (x86_64-unknown-linux-gnu)\r
  33 X-Face: HhBM'cA~<r"^Xv\KRN0P{vn'Y"Kd;zg_y3S[4)KSN~s?O\"QPoL\r
  34  $[Xv_BD:i/F$WiEWax}R(MPS`^UaptOGD`*/=@\1lKoVa9tnrg0TW?"r7aRtgk[F\r
  35  !)g;OY^,BjTbr)Np:%c_o'jj,Z\r
  36 Date: Fri, 01 Jan 2016 13:23:37 +0200\r
  37 Message-ID: <m2twmxbl1i.fsf@guru.guru-group.fi>\r
  38 MIME-Version: 1.0\r
  39 Content-Type: text/plain\r
  40 X-BeenThere: notmuch@notmuchmail.org\r
  41 X-Mailman-Version: 2.1.20\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: <https://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: <https://notmuchmail.org/mailman/listinfo/notmuch>,\r
  51  <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  52 X-List-Received-Date: Fri, 01 Jan 2016 11:23:29 -0000\r
  53 \r
  54 On Thu, Dec 31 2015, David Bremner <david@tethera.net> wrote:\r
  55 \r
  56 > Jani Nikula <jani@nikula.org> writes:\r
  57 >\r
  58 >> On Wed, 30 Dec 2015, "W. Trevor King" <wking@tremily.us> wrote:\r
  59 >>> To describe the config file format, so folks don't have to dig through\r
  60 >>> NEWS or the nmbug-status source to get that information.\r
  61 >>\r
  62 >> Overall I approve of the series (though I did not do a thorough\r
  63 >> review).\r
  64 >>\r
  65 >> I am wondering about the man page though. I find it slightly confusing\r
  66 >> there would be a man page named after the tool describing just the\r
  67 >> config, but not the tool itself.\r
  68 >\r
  69 > For me it's a bit odd to have a man page for a tool we don't install by\r
  70 > default. Is it maybe time to "promote" nmbug-status to the notmuch-\r
  71 > namespace and install it by default? That would have to be somehow tied\r
  72 > to installing the python bindings; or else the script could just print a\r
  73 > helpful error message if the bindings are not found.\r
  74 >\r
  75 > This would also allow addressing Tomi's comment about testing, by adding\r
  76 > a couple of tests to the test suite.\r
  77 \r
  78 What we could simply have at the time being:\r
  79 \r
  80   devel/nmbug/nmbug\r
  81   devel/nmbug/nmbug.rst (or .1)\r
  82   devel/nmbug/nmbug-status\r
  83   devel/nmbug/nmbug-status.rst (or .1)\r
  84   devel/nmbug/nmbug-status-config\r
  85   devel/nmbug/nmbug-status-config.rst (or .5)\r
  86 \r
  87 (and if .rst:s, a Makefile to build the namual pages)\r
  88 \r
  89 The responsibility to install the tools could be\r
  90 outside of notmuch for now...\r
  91 \r
  92 Tomi\r
  93 \r
  94 >\r
  95 > d\r