Re: [PATCH 5/7] doc: Allow rst2man.py as an alternative to rst2man
authorW. Trevor King <wking@tremily.us>
Sat, 5 Apr 2014 19:19:17 +0000 (12:19 +1700)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 18:01:16 +0000 (10:01 -0800)
a7/d30717e9c7cb63ea460aa08e8cd2a8e1ab6d66 [new file with mode: 0644]

diff --git a/a7/d30717e9c7cb63ea460aa08e8cd2a8e1ab6d66 b/a7/d30717e9c7cb63ea460aa08e8cd2a8e1ab6d66
new file mode 100644 (file)
index 0000000..a194185
--- /dev/null
@@ -0,0 +1,159 @@
+Return-Path: <wking@tremily.us>\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 22C87431FBF\r
+       for <notmuch@notmuchmail.org>; Sat,  5 Apr 2014 12:19:24 -0700 (PDT)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.1\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.1 tagged_above=-999 required=5\r
+       tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
+       RCVD_IN_DNSWL_NONE=-0.0001] 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 wZgpRz7p5YJ9 for <notmuch@notmuchmail.org>;\r
+       Sat,  5 Apr 2014 12:19:20 -0700 (PDT)\r
+Received: from qmta14.westchester.pa.mail.comcast.net\r
+       (qmta14.westchester.pa.mail.comcast.net [76.96.59.212])\r
+       by olra.theworths.org (Postfix) with ESMTP id 04496431FAF\r
+       for <notmuch@notmuchmail.org>; Sat,  5 Apr 2014 12:19:19 -0700 (PDT)\r
+Received: from omta06.westchester.pa.mail.comcast.net ([76.96.62.51])\r
+       by qmta14.westchester.pa.mail.comcast.net with comcast\r
+       id mK7j1n00216LCl05EKKKk2; Sat, 05 Apr 2014 19:19:19 +0000\r
+Received: from odin.tremily.us ([24.18.63.50])\r
+       by omta06.westchester.pa.mail.comcast.net with comcast\r
+       id mKKJ1n005152l3L3SKKJrt; Sat, 05 Apr 2014 19:19:19 +0000\r
+Received: by odin.tremily.us (Postfix, from userid 1000)\r
+       id 3781E11084C9; Sat,  5 Apr 2014 12:19:17 -0700 (PDT)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tremily.us; s=odin;\r
+       t=1396725557; bh=1t91kwGwrLC4rkRabPWeHpNOgNoWFMsNNsI54+BmnfY=;\r
+       h=Date:From:To:Cc:Subject:References:In-Reply-To;\r
+       b=sjs4HlmSmjeREVrsn/zZf5V1IO299T7LhMOHDEm0qwJxi1uIMFBFdx2JoPWdo0aDT\r
+       xg2gwX+/lVYYTr1oB66HvgOKy5qowYkdVxQmW2JF1+HTubgFNV/6A7+RZK60ITwH9v\r
+       28C6MeKPIww4Tn0hkI5vAa65AkJ74l8eMOJ896Mo=\r
+Date: Sat, 5 Apr 2014 12:19:17 -0700\r
+From: "W. Trevor King" <wking@tremily.us>\r
+To: Tomi Ollila <tomi.ollila@iki.fi>\r
+Subject: Re: [PATCH 5/7] doc: Allow rst2man.py as an alternative to rst2man\r
+Message-ID: <20140405191917.GF5316@odin.tremily.us>\r
+References: <cover.1396718720.git.wking@tremily.us>\r
+       <adce76bb9a0ca728d856da4ecaf6b282e22e7440.1396718720.git.wking@tremily.us>\r
+       <m2a9bzd2bo.fsf@guru.guru-group.fi>\r
+MIME-Version: 1.0\r
+Content-Type: multipart/signed; micalg=pgp-sha1;\r
+       protocol="application/pgp-signature"; boundary="hK8Uo4Yp55NZU70L"\r
+Content-Disposition: inline\r
+In-Reply-To: <m2a9bzd2bo.fsf@guru.guru-group.fi>\r
+OpenPGP: id=39A2F3FA2AB17E5D8764F388FC29BDCDF15F5BE8;\r
+       url=http://tremily.us/pubkey.txt\r
+User-Agent: Mutt/1.5.22 (2013-10-16)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net;\r
+       s=q20140121; t=1396725559;\r
+       bh=lJ+6L2G5e1lnBzE5dk13HagOZiu3nXjfCt0JOo5iCt4=;\r
+       h=Received:Received:Received:Date:From:To:Subject:Message-ID:\r
+       MIME-Version:Content-Type;\r
+       b=g+oXdogcTBrQt0Dn8D1NEt0hy+dtu5tM6m4PoKKlzd1doMiNI/TAqS+G3d1A+Mi3Q\r
+       pQF3JeTo2coxbv+W3Z3EmxshHS0esvryHTPt8DVmILQFKSu+hiw6lsK6Ws2aFw3/nD\r
+       HjW5OWVcuT8qyjjhgcH9UW6097KepwGBkiUBbeEaQhYvqJV+EgMxpYmJe4rnt9f+0K\r
+       QLHHb2qv3ZHMv4A2ADX/x4WYCrd0WGA5u0f055s66GtV/h0XjQiFhC0YVZiADIUqD/\r
+       7MtVIO/yRuIF9RuojIfep2XIO9l+eJ8ouGEYQHFCf7+ZpWLtd4895KX1jRVido1xKO\r
+       xdXBIK82rWnsg==\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, 05 Apr 2014 19:19:24 -0000\r
+\r
+\r
+--hK8Uo4Yp55NZU70L\r
+Content-Type: text/plain; charset=utf-8\r
+Content-Disposition: inline\r
+Content-Transfer-Encoding: quoted-printable\r
+\r
+On Sat, Apr 05, 2014 at 10:05:31PM +0300, Tomi Ollila wrote:\r
+> On Sat, Apr 05 2014, W. Trevor King wrote:\r
+> > I use POSIX's 'command -v' [1] to find the path to rst2man=E2=80=A6\r
+> >\r
+> > [1]: http://pubs.opengroup.org/onlinepubs/9699919799/utilities/command.=\r
+html\r
+>=20\r
+> =E2=80=A6\r
+> Except the reference to _POSIX_ page. One knows how consistent these\r
+> specifications are; alternative:\r
+>=20\r
+> http://pubs.opengroup.org/onlinepubs/009695399/utilities/command.html\r
+>=20\r
+> mentions additionally that -v flag\r
+> "(On systems supporting the User Portability Utilities option.)"=20\r
+\r
+It's been a decade since POSIX 2004 ;).  I'm not sure when the =E2=80=9CUser\r
+Portability Utilities=E2=80=9D caveat was removed, but I imagine most\r
+POSIX-aspiring shells have -v support.  Short of citing POSIX 2013, I\r
+think I'd have to survey likely shells, and that seems even less\r
+reliable.  Maybe I'm missunderstanding your suggested change?\r
+\r
+> Also, we don't give such a treatment to other command either; I'd rather\r
+> see RST2MAN=3Drst2man, RST2MAN=3Drst2man.py *and* RST2MAN=3D lines used\r
+> instead -- the last to set RST2MAN to empty string instead of being unset.\r
+\r
+I'm fine with that.  Alternatively, we could add an:\r
+\r
+  if -n "${RST2MAN}"\r
+\r
+clause to the front of the detection code to allow users with oddball\r
+scripts (maybe a null set) to override RST2MAN at configure time:\r
+\r
+  $ RST2MAN=3D/my/custom/rst_to_man_converter ./configure\r
+  $ make\r
+\r
+instead of at make-invocation time:\r
+\r
+  $ ./configure\r
+  $ make RST2MAN=3D/my/custom/rst_to_man_converter\r
+\r
+That would consolidate configuration around the 'config' call, and\r
+make explicitly emptying the RST2MAN variable more clearly superfluous\r
+(although I'm still fine with an explicit empty).\r
+\r
+Thoughts?\r
+\r
+Trevor\r
+\r
+--=20\r
+This email may be signed or encrypted with GnuPG (http://www.gnupg.org).\r
+For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy\r
+\r
+--hK8Uo4Yp55NZU70L\r
+Content-Type: application/pgp-signature; name="signature.asc"\r
+Content-Description: OpenPGP digital signature\r
+\r
+-----BEGIN PGP SIGNATURE-----\r
+Version: GnuPG v2.0.22 (GNU/Linux)\r
+\r
+iQIcBAEBAgAGBQJTQFcyAAoJEKKfehoaNkbtS4cQAIJyV/E8CN6UswfjMPi251ja\r
+crGZYM24x2cyVWC2bnfBLF0UwwQXoGKSRpVfnds0oMwrnP3pXZZDFT42t3hUXCoq\r
+watxOmpUjzEC0CmGJdoM4RLzVbqZ7O7jxU+siEsOLkAn0jRiPQQMLBoz24UuEuTg\r
+gNZbqfCdOBo+iiHp/JFdC002IrXOG1XGuULmsNfTechATG/LF+enA/ls8Jzo/Ats\r
+Hk9+T+6ZvKqKrixeVUpWJcwaNdQsqUiRenX7tOGIZC0OQg+0SJmqoUdwYh8Gzpab\r
+eOjC1kIh9bZ+LfGvmdjJs984epL0fue4UPk1K/XckX0WaPHKMn5OEqw1Lgm49PW1\r
+lOsTUTDbZbmZd2MpvsQCUDRX5GKeZYn+3F4aRNx625IeythuohU2XZ84wpht7wm3\r
+pu8JKVwjfdmhbCXX1B+fGWl6hVIOeD4oO+XkEUS2RD/uSD/dKUKJoYrhC+X9G+FJ\r
+tzz1g9W6Tx6tmcympKqC7p9r714pIHwbZk05cCDdyUzupsPHvosndzt+/f/0kQnm\r
+A3URoJjYq7DvGkGopNdMMRYKaUUtAyNjLPJ0wD4JYAOsGKKQagwInIlUXqIFjAVa\r
+zb7htirrCRpkcw9Ormqn6RxJs8mf/J7C9XAIqDDQRWuBzB9dvBnVAHiGXd7mVXd8\r
+Q/Kt6TaB/6B/M/ianv2f\r
+=7TuE\r
+-----END PGP SIGNATURE-----\r
+\r
+--hK8Uo4Yp55NZU70L--\r