Re: [PATCH] doc: Allow rst2man.py as an alternative to rst2man

diff --git a/c5/df31dabe464086c909da2eeb06957aac2d14a4 b/c5/df31dabe464086c909da2eeb06957aac2d14a4
new file mode 100644 (file)
index 0000000..b98a084
--- /dev/null
+++ b/c5/df31dabe464086c909da2eeb06957aac2d14a4
@@ -0,0 +1,91 @@
+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 18233431FBC\r
+       for <notmuch@notmuchmail.org>; Sat,  3 Jan 2015 09:12:45 -0800 (PST)\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 ywt64HvvIhzW for <notmuch@notmuchmail.org>;\r
+       Sat,  3 Jan 2015 09:12:41 -0800 (PST)\r
+Received: from guru.guru-group.fi (guru.guru-group.fi [46.183.73.34])\r
+       by olra.theworths.org (Postfix) with ESMTP id BDB34431FB6\r
+       for <notmuch@notmuchmail.org>; Sat,  3 Jan 2015 09:12:41 -0800 (PST)\r
+Received: from guru.guru-group.fi (localhost [IPv6:::1])\r
+       by guru.guru-group.fi (Postfix) with ESMTP id 0D72E100051;\r
+       Sat,  3 Jan 2015 19:12:13 +0200 (EET)\r
+From: Tomi Ollila <tomi.ollila@iki.fi>\r
+To: "W. Trevor King" <wking@tremily.us>, David Bremner <david@tethera.net>\r
+Subject: Re: [PATCH] doc: Allow rst2man.py as an alternative to rst2man\r
+In-Reply-To: <20150103164506.GR14967@odin.tremily.us>\r
+References: <1420294479-27224-1-git-send-email-tomi.ollila@iki.fi>\r
+       <1420300167-5060-1-git-send-email-david@tethera.net>\r
+       <20150103164506.GR14967@odin.tremily.us>\r
+User-Agent: Notmuch/0.19+14~ge04617b (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: Sat, 03 Jan 2015 19:12:13 +0200\r
+Message-ID: <m2oaqfbxg2.fsf@guru.guru-group.fi>\r
+MIME-Version: 1.0\r
+Content-Type: text/plain\r
+Cc: notmuch@notmuchmail.org\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: Sat, 03 Jan 2015 17:12:45 -0000\r
+\r
+On Sat, Jan 03 2015, "W. Trevor King" <wking@tremily.us> wrote:\r
+\r
+> On Sat, Jan 03, 2015 at 04:49:27PM +0100, David Bremner wrote:\r
+>> At the risk of bike-shedding, rewrite the configure check to be more\r
+>> "obvious". This is pretty subjective, but in particular I'm not a\r
+>> big fan of resetting RST2MAN at the bottom of every iteration of the\r
+>> for loop.  Also conform a bit more to the convention of using a\r
+>> lower case variable in configure and assigning it in Makefile.\r
+>\r
+> I'm fine with all of these changes.\r
+\r
+I am also -- and I'd prefer lower-case variables -- however the convention\r
+of using lower case variables is not so clear here (or weren't until\r
+David's ${python} path ;) -- we have mixup of upper & lower case variables\r
+there, and otoh, other (auto)configure scripts seems to use *_RST2MAN.\r
+\r
+But, instead of working this further we could also consider Jani's irc comment\r
+of dropping rs2man support altogether... or just keep the status quo and\r
+instruct users just install (recent enough) sphinx to their systems to get\r
+man pages created...\r
+\r
+Tomi\r
+\r
+PS: In one Scientific Linux 6.2 system I build and run notmuch I have\r
+\r
+  # Whether there's a sphinx-build binary available for building documentation\r
+  HAVE_SPHINX=0\r
+\r
+  # Whether there's a rst2man binary available for building documentation\r
+  HAVE_RST2MAN=1\r
+\r
+because sphinx-build is not recent enough -- sphinx-1.0-build would be but\r
+as it cannot be used by default and as rst2man (w/o .py) works I have not bothered.\r
+I'd presume anyone else using such an old system will have bigger problems\r
+getting their notmuch compiled (recent enough zlib being one of those), so\r
+this makes me wonder whether there is actually anyone needing rst2man there\r
+(besides me, of course :)\r
+\r