8b/65090a0cad112c0ada3fafd77bd2d533f52a39

   1 Return-Path: <david@tethera.net>\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 217ED431FBC\r
   6         for <notmuch@notmuchmail.org>; Fri, 17 Jan 2014 12:09:27 -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 TjOp4RzVPN7u for <notmuch@notmuchmail.org>;\r
  16         Fri, 17 Jan 2014 12:09:21 -0800 (PST)\r
  17 Received: from yantan.tethera.net (yantan.tethera.net [199.188.72.155])\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 40ADE431FB6\r
  21         for <notmuch@notmuchmail.org>; Fri, 17 Jan 2014 12:09:21 -0800 (PST)\r
  22 Received: from remotemail by yantan.tethera.net with local (Exim 4.80)\r
  23         (envelope-from <david@tethera.net>)\r
  24         id 1W4FjA-0003YH-KL; Fri, 17 Jan 2014 16:09:16 -0400\r
  25 Received: (nullmailer pid 9065 invoked by uid 1000); Fri, 17 Jan 2014\r
  26         20:09:12 -0000\r
  27 From: David Bremner <david@tethera.net>\r
  28 To: Jani Nikula <jani@nikula.org>, notmuch@notmuchmail.org\r
  29 Subject: Re: [Patch v3 2/3] man: partial conversion to pod.\r
  30 In-Reply-To: <87lhyer3lf.fsf@nikula.org>\r
  31 References: <m2bnzeoiij.fsf@guru.guru-group.fi>\r
  32         <1389791332-21719-1-git-send-email-david@tethera.net>\r
  33         <1389791332-21719-3-git-send-email-david@tethera.net>\r
  34         <87lhyer3lf.fsf@nikula.org>\r
  35 User-Agent: Notmuch/0.17+30~g50677dd (http://notmuchmail.org) Emacs/24.3.1\r
  36         (x86_64-pc-linux-gnu)\r
  37 Date: Fri, 17 Jan 2014 16:09:12 -0400\r
  38 Message-ID: <87bnzagyl3.fsf@zancas.localnet>\r
  39 MIME-Version: 1.0\r
  40 Content-Type: text/plain\r
  41 X-BeenThere: notmuch@notmuchmail.org\r
  42 X-Mailman-Version: 2.1.13\r
  43 Precedence: list\r
  44 List-Id: "Use and development of the notmuch mail system."\r
  45         <notmuch.notmuchmail.org>\r
  46 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  47         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  48 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  49 List-Post: <mailto:notmuch@notmuchmail.org>\r
  50 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  51 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  52         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  53 X-List-Received-Date: Fri, 17 Jan 2014 20:09:27 -0000\r
  54 \r
  55 Jani Nikula <jani@nikula.org> writes:\r
  56 \r
  57 > On Wed, 15 Jan 2014, David Bremner <david@tethera.net> wrote:\r
  58 >> From: David Bremner <bremner@debian.org>\r
  59 \r
  60 > In short, I'm really tempted by using markdown as the format, not least\r
  61 > because it's what we use for the web pages. The big (also literally)\r
  62 > downside is pandoc (http://johnmacfarlane.net/pandoc/), the tool for\r
  63 > converting markdown to man. I don't mind its dependencies, others may\r
  64 > disagree. Are there any sensible alternatives to pandoc?\r
  65 \r
  66 To complicate things, if we did decide on something heavyweight I think\r
  67 I'd propose we think about rst instead of markdown. I don't rst as well\r
  68 as markdown, but markdown does feel a little too adhoc to me from time\r
  69 to time (e.g. a verbatim block forcing the end of a list and so on).\r
  70 As far as I can tell, there are many incompatible versions of markdown\r
  71 as soon as you start to want e.g. tables.\r
  72 \r
  73 In any case, rst -> man is supported by python-docutils. sphinx supports\r
  74 both man page generation and texinfo output.  So that would be relatively\r
  75 lighter weight alternative (??) to pandoc.\r
  76 \r
  77 A more radical proposal would be to skip generating info and assuming\r
  78 everybody can browse html in emacs. That assumption is supposed to\r
  79 become less ludicrous in emacs24.4 with the inclusion of "eww".\r
  80 \r
  81 d\r