From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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--