cc/784df64db3d7d93fbe455ffc261448b3c12dc5

   1 Return-Path: <wking@tremily.us>\r
   2 X-Original-To: notmuch@notmuchmail.org\r
   3 Delivered-To: notmuch@notmuchmail.org\r
   4 Received: from localhost (localhost [127.0.0.1])\r
   5         by olra.theworths.org (Postfix) with ESMTP id 183E3431FBF\r
   6         for <notmuch@notmuchmail.org>; Sat,  5 Apr 2014 14:12:25 -0700 (PDT)\r
   7 X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
   8 X-Spam-Flag: NO\r
   9 X-Spam-Score: -0.1\r
  10 X-Spam-Level: \r
  11 X-Spam-Status: No, score=-0.1 tagged_above=-999 required=5\r
  12         tests=[DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1,\r
  13         RCVD_IN_DNSWL_NONE=-0.0001] autolearn=disabled\r
  14 Received: from olra.theworths.org ([127.0.0.1])\r
  15         by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
  16         with ESMTP id UK5kSn4-y78g for <notmuch@notmuchmail.org>;\r
  17         Sat,  5 Apr 2014 14:12:17 -0700 (PDT)\r
  18 Received: from QMTA11.westchester.pa.mail.comcast.net\r
  19         (qmta11.westchester.pa.mail.comcast.net [76.96.59.211])\r
  20         by olra.theworths.org (Postfix) with ESMTP id 06053431FAF\r
  21         for <notmuch@notmuchmail.org>; Sat,  5 Apr 2014 14:12:16 -0700 (PDT)\r
  22 Received: from omta07.westchester.pa.mail.comcast.net ([76.96.62.59])\r
  23         by QMTA11.westchester.pa.mail.comcast.net with comcast\r
  24         id mLjr1n0021GhbT85BMCG52; Sat, 05 Apr 2014 21:12:16 +0000\r
  25 Received: from odin.tremily.us ([24.18.63.50])\r
  26         by omta07.westchester.pa.mail.comcast.net with comcast\r
  27         id mMCF1n00F152l3L3TMCG76; Sat, 05 Apr 2014 21:12:16 +0000\r
  28 Received: by odin.tremily.us (Postfix, from userid 1000)\r
  29         id BD4F51108616; Sat,  5 Apr 2014 14:12:14 -0700 (PDT)\r
  30 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tremily.us; s=odin;\r
  31         t=1396732334; bh=SGW1sFYsI+On/2TIC3kBWVkFsYmdbB365vMZc4QYI0U=;\r
  32         h=Date:From:To:Cc:Subject:References:In-Reply-To;\r
  33         b=NCXSdhxMT9a7+npSORUeUXeI10A1XAbsCJhCCoYqNd3smyeEBbnbv1cpczIDRdeSw\r
  34         XGltrSWHdhCfw5rKOql3EvmgqblwMMeoDUXPDr5FRHPU7CjXNKxLJE66rzJhn6LrQd\r
  35         BAuQKTVhTPeRN5PZ/UW8KFmrLAuISPPs2oxwidwg=\r
  36 Date: Sat, 5 Apr 2014 14:12:14 -0700\r
  37 From: "W. Trevor King" <wking@tremily.us>\r
  38 To: David Bremner <david@tethera.net>\r
  39 Subject: Re: [PATCH 7/7] doc/INSTALL: Remove rst2man reference and other\r
  40         updates\r
  41 Message-ID: <20140405211214.GH5316@odin.tremily.us>\r
  42 References: <cover.1396718720.git.wking@tremily.us>\r
  43         <edf9a674bc1f41917caead8d38b5f09295a9d1bd.1396718720.git.wking@tremily.us>\r
  44         <874n271plm.fsf@maritornes.cs.unb.ca>\r
  45 MIME-Version: 1.0\r
  46 Content-Type: multipart/signed; micalg=pgp-sha1;\r
  47         protocol="application/pgp-signature"; boundary="jRdC2OsRnuV8iIl8"\r
  48 Content-Disposition: inline\r
  49 In-Reply-To: <874n271plm.fsf@maritornes.cs.unb.ca>\r
  50 OpenPGP: id=39A2F3FA2AB17E5D8764F388FC29BDCDF15F5BE8;\r
  51         url=http://tremily.us/pubkey.txt\r
  52 User-Agent: Mutt/1.5.22 (2013-10-16)\r
  53 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net;\r
  54         s=q20140121; t=1396732336;\r
  55         bh=GTQjAlpzRpRIjJoBFZ8iAw1+q7HrJZwVn0+gWjLLNHk=;\r
  56         h=Received:Received:Received:Date:From:To:Subject:Message-ID:\r
  57         MIME-Version:Content-Type;\r
  58         b=W7OjXgii+0JlWgJfu0S1AhsTnkOW+BBBsmktk3x169lYuecmS+vYZx7uuejFZRQAX\r
  59         vaUkSgUAih23AlJLnPs917DV++7euJI0GT0MMU6+Pz9dU0g37DLXKu05o4bnclMeuF\r
  60         1k/H+1OrLRCkU/cygVJNnsi3jC7QwaSDcFo1O8zX/g2bIuWoAO0rSuv/WiXCa2eOJ+\r
  61         GyCz8Y/diUANVZaTT5mD+X49YfHqL0ex04QyVWB+fHchGmZYrwBZH4Y3nvbkhKYR5H\r
  62         M674axIHpEMjIEVO4E4220uucyMpyoK42YMIl7a8J6yBGtwOdvhOrB+rHhxPo/MOE4\r
  63         b2A2s3tRg05vQ==\r
  64 Cc: notmuch@notmuchmail.org\r
  65 X-BeenThere: notmuch@notmuchmail.org\r
  66 X-Mailman-Version: 2.1.13\r
  67 Precedence: list\r
  68 List-Id: "Use and development of the notmuch mail system."\r
  69         <notmuch.notmuchmail.org>\r
  70 List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
  71         <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
  72 List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
  73 List-Post: <mailto:notmuch@notmuchmail.org>\r
  74 List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
  75 List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
  76         <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
  77 X-List-Received-Date: Sat, 05 Apr 2014 21:12:25 -0000\r
  78 \r
  79 \r
  80 --jRdC2OsRnuV8iIl8\r
  81 Content-Type: text/plain; charset=us-ascii\r
  82 Content-Disposition: inline\r
  83 Content-Transfer-Encoding: quoted-printable\r
  84 \r
  85 On Sat, Apr 05, 2014 at 05:35:49PM -0300, David Bremner wrote:\r
  86 > W. Trevor King writes:\r
  87 >=20\r
  88 > > -- You can build build and install man pages with 'make install-man'\r
  89 > > +  make build-{man|info|html|pdf}\r
  90 >=20\r
  91 > most of those those targets now start with sphinx-\r
  92 \r
  93 Ah, looks like that happended in with the original Sphinx code in\r
  94 d736260 (doc: convert sphinx based docs, 2014-01-28).  It looks like\r
  95 the current usage is (from the .PHONY entries):\r
  96 \r
  97   {build|install}-man, which is backend (Sphinx/Docutils) agnostic\r
  98   sphinx-{html|texinfo|info}, which doesn't have an install target\r
  99 \r
 100 Is that distinction intentional?  Personally I prefer the consistency\r
 101 of:\r
 102 \r
 103   {build|install}-{man|html|texinfo|info}\r
 104 \r
 105 if the configured backend (Sphinx/Docutils) doesn't support the\r
 106 requested target, we should error out.  If no backend is detected,\r
 107 build-man and install-man should be pulled from the default dependency\r
 108 tree (but they would still error out if you called them directly).  If\r
 109 that sounds reasonable, I can work up a patch.\r
 110 \r
 111 > > -- You can build man, info, html, and pdf versions of the docs\r
 112 > > -  (currently only the man pages) with\r
 113 > > +You can build build and install the docs (currently only the man\r
 114 > > +pages) with::\r
 115 >=20\r
 116 > build build\r
 117 \r
 118 Oops, thanks.\r
 119 \r
 120 > > -Building the man pages\r
 121 > > -----------------------\r
 122 > > +Building the man Docutils\r
 123 > > +-------------------------\r
 124 > > =20\r
 125 >=20\r
 126 > + with\r
 127 \r
 128 Thanks again :p.\r
 129 \r
 130 > > -- You can build the man pages with rst2man (from python-docutils) with\r
 131 > > -  'make rst2man'.\r
 132 > > +If you don't have Sphinx installed, you can still build the man-page\r
 133 > > +version of the docs using rst2man (from Docutils_)::\r
 134 > > =20\r
 135 > > -- Currently there is no support to automagically install the resulting\r
 136 > > -  nroff files, but it should work to modify the target install-man\r
 137 > > -  in doc/Makefile.local.\r
 138 >=20\r
 139 > This should mention the relevant variables, since the targets are\r
 140 > the same in both cases\r
 141 \r
 142 Ok.\r
 143 \r
 144 > Finally, I don't really object to rewriting doc/INSTALL in rst, but\r
 145 > I wonder if we should rename it to INSTALL.rst\r
 146 \r
 147 Sure (I don't really mind).\r
 148 \r
 149 Cheers,\r
 150 Trevor\r
 151 \r
 152 --=20\r
 153 This email may be signed or encrypted with GnuPG (http://www.gnupg.org).\r
 154 For more information, see http://en.wikipedia.org/wiki/Pretty_Good_Privacy\r
 155 \r
 156 --jRdC2OsRnuV8iIl8\r
 157 Content-Type: application/pgp-signature; name="signature.asc"\r
 158 Content-Description: OpenPGP digital signature\r
 159 \r
 160 -----BEGIN PGP SIGNATURE-----\r
 161 Version: GnuPG v2.0.22 (GNU/Linux)\r
 162 \r
 163 iQIcBAEBAgAGBQJTQHGsAAoJEKKfehoaNkbtY8gQAI5Za+W/dhhGauLcX25nBJND\r
 164 EI4vmRr1pT8VGkXu7X5MJfwgvVifMLII62EP/0qaz4Flf07gMt2bKCWHUdISNSXj\r
 165 5HLHqqepI0NtEaSMuTSksMS1BiJzptaTbOP/dpXpMkuatOTS+ZM0HTjpMVu4nToe\r
 166 KKjL6H35cVRdldIQzLRFeMNnlIykJoEEeEBgYF/xRn0vkYtwlv7EBbwUV54c0fDy\r
 167 tSSNoH6mnSFwh9nBIUssns2lI7D5A+XnKE1tDpcgdyQINiLYwGcKWn0EWF37OgTX\r
 168 aJvZKV0dVosmLPL6coeZWdVnwfsYm+MaKIYPCVY+B4GoGhFSybbTNIqOf3COxuOh\r
 169 82XDUC04MOwYOSFKLbPWr5dEj7TqEF+kktlMOrfXKtQlOsrT8z5Pcvkc7HOs3OMu\r
 170 VC9T/X1eDsS5Kdfi8v3J9n34bYfn39ME3miERehj6LxNqnTxQ9YeUZllPi9over/\r
 171 pVY82obG35SHZGbpQC/kJvL3d+tECLOG09llTq2DYlNOV2U7p3JhtOgaLSJ/S/Xt\r
 172 EOryU8TfFEPsjA4t27EhaE1PC140UrAF55c+ySmRwaDD4If6kRfcFhd+Cp38XPKT\r
 173 6sgTxeUf7RnjX5UMC5p/HkqB9qTufBzJGoMdp2gBhxwNu4JOY01NffH0uMPfbWmM\r
 174 NnkV+aaxiXEtgOd6LA0c\r
 175 =OZ3r\r
 176 -----END PGP SIGNATURE-----\r
 177 \r
 178 --jRdC2OsRnuV8iIl8--\r