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