From: W. Trevor King Date: Sat, 5 Apr 2014 21:12:14 +0000 (+1700) Subject: Re: [PATCH 7/7] doc/INSTALL: Remove rst2man reference and other updates X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=0dc95699800aa251f16fabe1f67ddd93611ebb0f;p=notmuch-archives.git Re: [PATCH 7/7] doc/INSTALL: Remove rst2man reference and other updates --- diff --git a/cc/784df64db3d7d93fbe455ffc261448b3c12dc5 b/cc/784df64db3d7d93fbe455ffc261448b3c12dc5 new file mode 100644 index 000000000..bfb61bf8e --- /dev/null +++ b/cc/784df64db3d7d93fbe455ffc261448b3c12dc5 @@ -0,0 +1,178 @@ +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 183E3431FBF + for ; Sat, 5 Apr 2014 14:12:25 -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 UK5kSn4-y78g for ; + Sat, 5 Apr 2014 14:12:17 -0700 (PDT) +Received: from QMTA11.westchester.pa.mail.comcast.net + (qmta11.westchester.pa.mail.comcast.net [76.96.59.211]) + by olra.theworths.org (Postfix) with ESMTP id 06053431FAF + for ; Sat, 5 Apr 2014 14:12:16 -0700 (PDT) +Received: from omta07.westchester.pa.mail.comcast.net ([76.96.62.59]) + by QMTA11.westchester.pa.mail.comcast.net with comcast + id mLjr1n0021GhbT85BMCG52; Sat, 05 Apr 2014 21:12:16 +0000 +Received: from odin.tremily.us ([24.18.63.50]) + by omta07.westchester.pa.mail.comcast.net with comcast + id mMCF1n00F152l3L3TMCG76; Sat, 05 Apr 2014 21:12:16 +0000 +Received: by odin.tremily.us (Postfix, from userid 1000) + id BD4F51108616; Sat, 5 Apr 2014 14:12:14 -0700 (PDT) +DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tremily.us; s=odin; + t=1396732334; bh=SGW1sFYsI+On/2TIC3kBWVkFsYmdbB365vMZc4QYI0U=; + h=Date:From:To:Cc:Subject:References:In-Reply-To; + b=NCXSdhxMT9a7+npSORUeUXeI10A1XAbsCJhCCoYqNd3smyeEBbnbv1cpczIDRdeSw + XGltrSWHdhCfw5rKOql3EvmgqblwMMeoDUXPDr5FRHPU7CjXNKxLJE66rzJhn6LrQd + BAuQKTVhTPeRN5PZ/UW8KFmrLAuISPPs2oxwidwg= +Date: Sat, 5 Apr 2014 14:12:14 -0700 +From: "W. Trevor King" +To: David Bremner +Subject: Re: [PATCH 7/7] doc/INSTALL: Remove rst2man reference and other + updates +Message-ID: <20140405211214.GH5316@odin.tremily.us> +References: + + <874n271plm.fsf@maritornes.cs.unb.ca> +MIME-Version: 1.0 +Content-Type: multipart/signed; micalg=pgp-sha1; + protocol="application/pgp-signature"; boundary="jRdC2OsRnuV8iIl8" +Content-Disposition: inline +In-Reply-To: <874n271plm.fsf@maritornes.cs.unb.ca> +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=1396732336; + bh=GTQjAlpzRpRIjJoBFZ8iAw1+q7HrJZwVn0+gWjLLNHk=; + h=Received:Received:Received:Date:From:To:Subject:Message-ID: + MIME-Version:Content-Type; + b=W7OjXgii+0JlWgJfu0S1AhsTnkOW+BBBsmktk3x169lYuecmS+vYZx7uuejFZRQAX + vaUkSgUAih23AlJLnPs917DV++7euJI0GT0MMU6+Pz9dU0g37DLXKu05o4bnclMeuF + 1k/H+1OrLRCkU/cygVJNnsi3jC7QwaSDcFo1O8zX/g2bIuWoAO0rSuv/WiXCa2eOJ+ + GyCz8Y/diUANVZaTT5mD+X49YfHqL0ex04QyVWB+fHchGmZYrwBZH4Y3nvbkhKYR5H + M674axIHpEMjIEVO4E4220uucyMpyoK42YMIl7a8J6yBGtwOdvhOrB+rHhxPo/MOE4 + b2A2s3tRg05vQ== +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 21:12:25 -0000 + + +--jRdC2OsRnuV8iIl8 +Content-Type: text/plain; charset=us-ascii +Content-Disposition: inline +Content-Transfer-Encoding: quoted-printable + +On Sat, Apr 05, 2014 at 05:35:49PM -0300, David Bremner wrote: +> W. Trevor King writes: +>=20 +> > -- You can build build and install man pages with 'make install-man' +> > + make build-{man|info|html|pdf} +>=20 +> most of those those targets now start with sphinx- + +Ah, looks like that happended in with the original Sphinx code in +d736260 (doc: convert sphinx based docs, 2014-01-28). It looks like +the current usage is (from the .PHONY entries): + + {build|install}-man, which is backend (Sphinx/Docutils) agnostic + sphinx-{html|texinfo|info}, which doesn't have an install target + +Is that distinction intentional? Personally I prefer the consistency +of: + + {build|install}-{man|html|texinfo|info} + +if the configured backend (Sphinx/Docutils) doesn't support the +requested target, we should error out. If no backend is detected, +build-man and install-man should be pulled from the default dependency +tree (but they would still error out if you called them directly). If +that sounds reasonable, I can work up a patch. + +> > -- You can build man, info, html, and pdf versions of the docs +> > - (currently only the man pages) with +> > +You can build build and install the docs (currently only the man +> > +pages) with:: +>=20 +> build build + +Oops, thanks. + +> > -Building the man pages +> > ----------------------- +> > +Building the man Docutils +> > +------------------------- +> > =20 +>=20 +> + with + +Thanks again :p. + +> > -- You can build the man pages with rst2man (from python-docutils) with +> > - 'make rst2man'. +> > +If you don't have Sphinx installed, you can still build the man-page +> > +version of the docs using rst2man (from Docutils_):: +> > =20 +> > -- Currently there is no support to automagically install the resulting +> > - nroff files, but it should work to modify the target install-man +> > - in doc/Makefile.local. +>=20 +> This should mention the relevant variables, since the targets are +> the same in both cases + +Ok. + +> Finally, I don't really object to rewriting doc/INSTALL in rst, but +> I wonder if we should rename it to INSTALL.rst + +Sure (I don't really mind). + +Cheers, +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 + +--jRdC2OsRnuV8iIl8 +Content-Type: application/pgp-signature; name="signature.asc" +Content-Description: OpenPGP digital signature + +-----BEGIN PGP SIGNATURE----- +Version: GnuPG v2.0.22 (GNU/Linux) + +iQIcBAEBAgAGBQJTQHGsAAoJEKKfehoaNkbtY8gQAI5Za+W/dhhGauLcX25nBJND +EI4vmRr1pT8VGkXu7X5MJfwgvVifMLII62EP/0qaz4Flf07gMt2bKCWHUdISNSXj +5HLHqqepI0NtEaSMuTSksMS1BiJzptaTbOP/dpXpMkuatOTS+ZM0HTjpMVu4nToe +KKjL6H35cVRdldIQzLRFeMNnlIykJoEEeEBgYF/xRn0vkYtwlv7EBbwUV54c0fDy +tSSNoH6mnSFwh9nBIUssns2lI7D5A+XnKE1tDpcgdyQINiLYwGcKWn0EWF37OgTX +aJvZKV0dVosmLPL6coeZWdVnwfsYm+MaKIYPCVY+B4GoGhFSybbTNIqOf3COxuOh +82XDUC04MOwYOSFKLbPWr5dEj7TqEF+kktlMOrfXKtQlOsrT8z5Pcvkc7HOs3OMu +VC9T/X1eDsS5Kdfi8v3J9n34bYfn39ME3miERehj6LxNqnTxQ9YeUZllPi9over/ +pVY82obG35SHZGbpQC/kJvL3d+tECLOG09llTq2DYlNOV2U7p3JhtOgaLSJ/S/Xt +EOryU8TfFEPsjA4t27EhaE1PC140UrAF55c+ySmRwaDD4If6kRfcFhd+Cp38XPKT +6sgTxeUf7RnjX5UMC5p/HkqB9qTufBzJGoMdp2gBhxwNu4JOY01NffH0uMPfbWmM +NnkV+aaxiXEtgOd6LA0c +=OZ3r +-----END PGP SIGNATURE----- + +--jRdC2OsRnuV8iIl8--