Re: [PATCH v3 0/5] rst2man.py support and doc-build cleanups

diff --git a/9a/0720de70f3dd37595fd5a7aa960d524330fb68 b/9a/0720de70f3dd37595fd5a7aa960d524330fb68
new file mode 100644 (file)
index 0000000..79dcdcc
--- /dev/null
+++ b/9a/0720de70f3dd37595fd5a7aa960d524330fb68
@@ -0,0 +1,118 @@
+Return-Path: <tomi.ollila@iki.fi>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id AE31E431FCB\r
+       for <notmuch@notmuchmail.org>; Sat, 12 Jul 2014 23:05:53 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: 0\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=0 tagged_above=-999 required=5 tests=[none]\r
+       autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id lA8bfTjAyQAT for <notmuch@notmuchmail.org>;\r
+       Sat, 12 Jul 2014 23:05:46 -0700 (PDT)\r
+Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34])\r
+       by olra.theworths.org (Postfix) with ESMTP id 5200A431FBD\r
+       for <notmuch@notmuchmail.org>; Sat, 12 Jul 2014 23:05:46 -0700 (PDT)\r
+Received: from guru.guru-group.fi (localhost [IPv6:::1])\r
+       by guru.guru-group.fi (Postfix) with ESMTP id F05E71000B3;\r
+       Sun, 13 Jul 2014 09:05:41 +0300 (EEST)\r
+From: Tomi Ollila <tomi.ollila@iki.fi>\r
+To: "W. Trevor King" <wking@tremily.us>, notmuch@notmuchmail.org\r
+Subject: Re: [PATCH v3 0/5] rst2man.py support and doc-build cleanups\r
+In-Reply-To: <cover.1405220724.git.wking@tremily.us>\r
+References: <cover.1405220724.git.wking@tremily.us>\r
+User-Agent: Notmuch/0.18.1+25~gdaf4b6f (http://notmuchmail.org) Emacs/24.3.1\r
+       (x86_64-unknown-linux-gnu)\r
+X-Face: HhBM'cA~<r"^Xv\KRN0P{vn'Y"Kd;zg_y3S[4)KSN~s?O\"QPoL\r
+       $[Xv_BD:i/F$WiEWax}R(MPS`^UaptOGD`*/=@\1lKoVa9tnrg0TW?"r7aRtgk[F\r
+       !)g;OY^,BjTbr)Np:%c_o'jj,Z\r
+Date: Sun, 13 Jul 2014 09:05:41 +0300\r
+Message-ID: <m2wqbhiyiy.fsf@guru.guru-group.fi>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain; charset=utf-8\r
+Content-Transfer-Encoding: quoted-printable\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Sun, 13 Jul 2014 06:05:53 -0000\r
+\r
+On Sun, Jul 13 2014, "W. Trevor King" <wking@tremily.us> wrote:\r
+\r
+> Changes since v2 [1]:\r
+>\r
+> * In patches 1/5 and 5/5, use for loops to check for rst2man[.py] and\r
+>   rst2html[.py].\r
+> * In patches 1/5 and 5/5, store the command names, not the full paths\r
+>   (command -v =E2=80=A6) [2].\r
+> * In patch 3/5, I've added argparse handling to the newly-renamed\r
+>   rst-man2any.py.  Tomi suggested modeling the name and UI on texi2any\r
+>   [3], but texi2any is for converting a single file, while\r
+>   rst-man2any.py is for converting a whole tree (and it takes an\r
+>   arbitrary ReST-to-$x converter to do the real work).  I've basically\r
+>   just cleaned things up, but if folks aren't satisfied I'm going to\r
+>   need more concrete suggestions ;).\r
+\r
+The series now looks good to me, I don't have time to test it now but will\r
+do it after Jul 20th.\r
+\r
+I am satisfied with rst-man2any.py, but as being normal picky me I wonder\r
+whether the command prefix 'rst-' is being too generic i.e. is invading\r
+that "namespace". If no one else has the same feeling (or the feeling is\r
+just wrong (or insignificant)) then this can be forgotten :D\r
+\r
+>\r
+> Cheers,\r
+> Trevor\r
+\r
+Thanks, good work!\r
+\r
+\r
+Tomi\r
+\r
+>\r
+> [1]: id:cover.1399740604.git.wking@tremily.us\r
+>      http://thread.gmane.org/gmane.mail.notmuch.general/18291\r
+> [2]: id:m2ion3dn0r.fsf@guru.guru-group.fi\r
+>      http://article.gmane.org/gmane.mail.notmuch.general/18652\r
+> [3]: id:m2lhrzj8kb.fsf@guru.guru-group.fi\r
+>      http://article.gmane.org/gmane.mail.notmuch.general/18653\r
+>\r
+> W. Trevor King (5):\r
+>   doc: Allow rst2man.py as an alternative to rst2man\r
+>   doc/prerst2man.py: Convert execfile to import\r
+>   doc/rst-man2any.py: Adjust to handle any output format, not just man\r
+>     pages\r
+>   doc: Consolidate Makefile targets around {build|install}-{format}\r
+>   doc: Add rst2html support for building HTML docs\r
+>\r
+>  Makefile.local     |  14 ++++++-\r
+>  configure          |  45 ++++++++++++++++++++---\r
+>  doc/INSTALL        |  47 +++++++++++++++++-------\r
+>  doc/Makefile.local |  48 ++++++++++++++----------\r
+>  doc/prerst2man.py  |  63 --------------------------------\r
+>  doc/rst-man2any.py | 105 +++++++++++++++++++++++++++++++++++++++++++++++=\r
+++++++\r
+>  6 files changed, 217 insertions(+), 105 deletions(-)\r
+>  delete mode 100644 doc/prerst2man.py\r
+>  create mode 100755 doc/rst-man2any.py\r
+>\r
+> --=20\r
+> 1.9.1.353.gc66d89d\r
+>\r
+> _______________________________________________\r
+> notmuch mailing list\r
+> notmuch@notmuchmail.org\r
+> http://notmuchmail.org/mailman/listinfo/notmuch\r