50/8ba3774faaa4effc6c87739787298280b6b9cb

   1 Return-Path: <m.walters@qmul.ac.uk>\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 3B33B431FC0\r
   6         for <notmuch@notmuchmail.org>; Sat, 18 Jan 2014 03:11:39 -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: -1.098\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-1.098 tagged_above=-999 required=5\r
  12         tests=[DKIM_ADSP_CUSTOM_MED=0.001, FREEMAIL_FROM=0.001,\r
  13         NML_ADSP_CUSTOM_MED=1.2, RCVD_IN_DNSWL_MED=-2.3] autolearn=disabled\r
  14 Received: from olra.theworths.org ([127.0.0.1])\r
  15         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  16         with ESMTP id YIg97gfxzCFK for <notmuch@notmuchmail.org>;\r
  17         Sat, 18 Jan 2014 03:11:31 -0800 (PST)\r
  18 Received: from mail2.qmul.ac.uk (mail2.qmul.ac.uk [138.37.6.6])\r
  19         (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))\r
  20         (No client certificate requested)\r
  21         by olra.theworths.org (Postfix) with ESMTPS id 36B9A431FBD\r
  22         for <notmuch@notmuchmail.org>; Sat, 18 Jan 2014 03:11:31 -0800 (PST)\r
  23 Received: from smtp.qmul.ac.uk ([138.37.6.40])\r
  24         by mail2.qmul.ac.uk with esmtp (Exim 4.71)\r
  25         (envelope-from <m.walters@qmul.ac.uk>)\r
  26         id 1W4ToA-0001Kq-Uq; Sat, 18 Jan 2014 11:11:23 +0000\r
  27 Received: from 93-97-24-31.zone5.bethere.co.uk ([93.97.24.31] helo=localhost)\r
  28         by smtp.qmul.ac.uk with esmtpsa (TLSv1:AES128-SHA:128) (Exim 4.71)\r
  29         (envelope-from <m.walters@qmul.ac.uk>)\r
  30         id 1W4ToA-00083E-J9; Sat, 18 Jan 2014 11:11:22 +0000\r
  31 From: Mark Walters <markwalters1009@gmail.com>\r
  32 To: David Bremner <david@tethera.net>, Jani Nikula <jani@nikula.org>,\r
  33         notmuch@notmuchmail.org\r
  34 Subject: Re: [Patch v3 2/3] man: partial conversion to pod.\r
  35 In-Reply-To: <87bnzagyl3.fsf@zancas.localnet>\r
  36 References: <m2bnzeoiij.fsf@guru.guru-group.fi>\r
  37         <1389791332-21719-1-git-send-email-david@tethera.net>\r
  38         <1389791332-21719-3-git-send-email-david@tethera.net>\r
  39         <87lhyer3lf.fsf@nikula.org> <87bnzagyl3.fsf@zancas.localnet>\r
  40 User-Agent: Notmuch/0.15.2+484~gfb59956 (http://notmuchmail.org) Emacs/23.4.1\r
  41         (x86_64-pc-linux-gnu)\r
  42 Date: Sat, 18 Jan 2014 11:11:21 +0000\r
  43 Message-ID: <87vbxhczom.fsf@qmul.ac.uk>\r
  44 MIME-Version: 1.0\r
  45 Content-Type: text/plain; charset=us-ascii\r
  46 X-Sender-Host-Address: 93.97.24.31\r
  47 X-QM-Geographic: According to ripencc,\r
  48         this message was delivered by a machine in Britain (UK) (GB).\r
  49 X-QM-SPAM-Info: Sender has good ham record.  :)\r
  50 X-QM-Body-MD5: 9ec7034168ffabdb4ab0cf2657e36329 (of first 20000 bytes)\r
  51 X-SpamAssassin-Score: 0.0\r
  52 X-SpamAssassin-SpamBar: /\r
  53 X-SpamAssassin-Report: The QM spam filters have analysed this message to\r
  54         determine if it is\r
  55         spam. We require at least 5.0 points to mark a message as spam.\r
  56         This message scored 0.0 points. Summary of the scoring: \r
  57         * 0.0 FREEMAIL_FROM Sender email is commonly abused enduser mail\r
  58         provider *      (markwalters1009[at]gmail.com)\r
  59         *  0.0 AWL AWL: From: address is in the auto white-list\r
  60 X-QM-Scan-Virus: ClamAV says the message is clean\r
  61 X-BeenThere: notmuch@notmuchmail.org\r
  62 X-Mailman-Version: 2.1.13\r
  63 Precedence: list\r
  64 List-Id: "Use and development of the notmuch mail system."\r
  65         <notmuch.notmuchmail.org>\r
  66 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  67         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  68 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  69 List-Post: <mailto:notmuch@notmuchmail.org>\r
  70 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  71 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  72         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  73 X-List-Received-Date: Sat, 18 Jan 2014 11:11:39 -0000\r
  74 \r
  75 \r
  76 I don't have strong views on which format we use for docs. Html has the\r
  77 nice feature that most people are happy writing it and making doc\r
  78 writing simple seems a good idea.\r
  79 \r
  80 One negative for the pod2texi approach is that debian stable does not\r
  81 have texinfo 5; to test this series I had to build the package from\r
  82 source. \r
  83 \r
  84 Best wishes\r
  85 \r
  86 Mark\r
  87 \r
  88 \r
  89 \r
  90 \r
  91  (html migh have an advantage that most people are happy writing it; eOn Fri, 17 Jan 2014, David Bremner <david@tethera.net> wrote:\r
  92 > Jani Nikula <jani@nikula.org> writes:\r
  93 >\r
  94 >> On Wed, 15 Jan 2014, David Bremner <david@tethera.net> wrote:\r
  95 >>> From: David Bremner <bremner@debian.org>\r
  96 >\r
  97 >> In short, I'm really tempted by using markdown as the format, not least\r
  98 >> because it's what we use for the web pages. The big (also literally)\r
  99 >> downside is pandoc (http://johnmacfarlane.net/pandoc/), the tool for\r
 100 >> converting markdown to man. I don't mind its dependencies, others may\r
 101 >> disagree. Are there any sensible alternatives to pandoc?\r
 102 >\r
 103 > To complicate things, if we did decide on something heavyweight I think\r
 104 > I'd propose we think about rst instead of markdown. I don't rst as well\r
 105 > as markdown, but markdown does feel a little too adhoc to me from time\r
 106 > to time (e.g. a verbatim block forcing the end of a list and so on).\r
 107 > As far as I can tell, there are many incompatible versions of markdown\r
 108 > as soon as you start to want e.g. tables.\r
 109 >\r
 110 > In any case, rst -> man is supported by python-docutils. sphinx supports\r
 111 > both man page generation and texinfo output.  So that would be relatively\r
 112 > lighter weight alternative (??) to pandoc.\r
 113 >\r
 114 > A more radical proposal would be to skip generating info and assuming\r
 115 > everybody can browse html in emacs. That assumption is supposed to\r
 116 > become less ludicrous in emacs24.4 with the inclusion of "eww".\r
 117 >\r
 118 > d\r
 119 > _______________________________________________\r
 120 > notmuch mailing list\r
 121 > notmuch@notmuchmail.org\r
 122 > http://notmuchmail.org/mailman/listinfo/notmuch\r