Re: [PATCH] doc: Fix parallel build of roff files

diff --git a/25/b585a28dcd0503922c6ae843675fb1d555d5a0 b/25/b585a28dcd0503922c6ae843675fb1d555d5a0
new file mode 100644 (file)
index 0000000..77644f9
--- /dev/null
+++ b/25/b585a28dcd0503922c6ae843675fb1d555d5a0
@@ -0,0 +1,133 @@
+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 83CC5431FC0\r
+       for <notmuch@notmuchmail.org>; Sat, 10 May 2014 08:18:45 -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 N-GLkBqZQjLZ for <notmuch@notmuchmail.org>;\r
+       Sat, 10 May 2014 08:18:37 -0700 (PDT)\r
+Received: from qmta02.westchester.pa.mail.comcast.net\r
+       (qmta02.westchester.pa.mail.comcast.net [76.96.62.24])\r
+       by olra.theworths.org (Postfix) with ESMTP id 4C7B9431FBF\r
+       for <notmuch@notmuchmail.org>; Sat, 10 May 2014 08:18:37 -0700 (PDT)\r
+Received: from omta12.westchester.pa.mail.comcast.net ([76.96.62.44])\r
+       by qmta02.westchester.pa.mail.comcast.net with comcast\r
+       id 0Ee41o0050xGWP851FJcz2; Sat, 10 May 2014 15:18:36 +0000\r
+Received: from odin.tremily.us ([24.18.63.50])\r
+       by omta12.westchester.pa.mail.comcast.net with comcast\r
+       id 0FJa1o00c152l3L3YFJbcj; Sat, 10 May 2014 15:18:36 +0000\r
+Received: by odin.tremily.us (Postfix, from userid 1000)\r
+       id EDEC211967F8; Sat, 10 May 2014 08:18:33 -0700 (PDT)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tremily.us; s=odin;\r
+       t=1399735113; bh=za8mDsHtDO29YLP/YumaUPD/VUfyprldX1wAXFMnnWI=;\r
+       h=Date:From:To:Cc:Subject:References:In-Reply-To;\r
+       b=rNsX3e7a2igq9u6KnA47AmM9AIxY61u4N8U6i9GrtMx28ma2gd5sY/jS6vmILbN2w\r
+       jJuuDJlUY9RP6G4n5CY0F1I2T9saIuXqxWUsNuXdT8Jvmwd9A/ppaxMhblU6hKknr9\r
+       twfXOC8LNWFCP4i14AVoz/fJShtx4ciQtt+dmDfU=\r
+Date: Sat, 10 May 2014 08:18:33 -0700\r
+From: "W. Trevor King" <wking@tremily.us>\r
+To: Austin Clements <amdragon@MIT.EDU>\r
+Subject: Re: [PATCH] doc: Fix parallel build of roff files\r
+Message-ID: <20140510151833.GR28634@odin.tremily.us>\r
+References: <1397766897-14475-1-git-send-email-amdragon@mit.edu>\r
+MIME-Version: 1.0\r
+Content-Type: multipart/signed; micalg=pgp-sha1;\r
+       protocol="application/pgp-signature"; boundary="xi/AxZ9U2VfEekdX"\r
+Content-Disposition: inline\r
+In-Reply-To: <1397766897-14475-1-git-send-email-amdragon@mit.edu>\r
+OpenPGP: id=39A2F3FA2AB17E5D8764F388FC29BDCDF15F5BE8;\r
+       url=http://tremily.us/pubkey.txt\r
+User-Agent: Mutt/1.5.23 (2014-03-12)\r
+DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net;\r
+       s=q20140121; t=1399735116;\r
+       bh=8pOaDv5j5OF+sNo8iGOZudZTJLEY8ehPXULA9UPt1cU=;\r
+       h=Received:Received:Received:Date:From:To:Subject:Message-ID:\r
+       MIME-Version:Content-Type;\r
+       b=vOaCwpjmPNsurCPOuoxFA0iZP+FNW1wT8MxkNYUxWpue7rcnt2+JcXJ3/qHZTyvl4\r
+       jFV0BGWIyfkpDMOQms/kLNtydo2PxRWIO1Ssrjc9pi7NMeoJX5pAl0/c1QwwO4se5O\r
+       DJ+aehfSKSoPqwzrCGAMcDBiJYZkUmYh3OK4AYhOAZASLm7cFRHqZL2Wuzly1afXIO\r
+       gyid6JMAGsNZrGQ14JJ+U8LYTFQb4Iav8XAhqouQIXPSlHelF5UHnY6H9Fj5N/vfp1\r
+       UqMSIVqycjo+bx3aG/xZfiuq6vykIlLpeKk5UbP15ebbVA7DsXLiziTgQCPBEbHYFK\r
+       3wxuq+u1BTYVQ==\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, 10 May 2014 15:18:45 -0000\r
+\r
+\r
+--xi/AxZ9U2VfEekdX\r
+Content-Type: text/plain; charset=us-ascii\r
+Content-Disposition: inline\r
+Content-Transfer-Encoding: quoted-printable\r
+\r
+On Thu, Apr 17, 2014 at 04:34:57PM -0400, Austin Clements wrote:\r
+> +$(DOCBUILDDIR)/.roff.stamp: ${MAN_RST_FILES}\r
+>  ifeq ($(HAVE_SPHINX),1)\r
+>      $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(DOCBUILDDIR)/man\r
+>      for section in 1 5 7; do \\r
+> @@ -48,6 +54,7 @@ else\r
+>      @echo "Fatal: build dependency fail."\r
+>      @false\r
+>  endif\r
+> +    touch ${MAN_ROFF_FILES} $@\r
+\r
+I'm poking around in the Makefile, and don't understand why we're\r
+touching ${MAN_ROFF_FILES} here.  Either they were just created by\r
+Sphinx/rst2man, or we died with the @false.  I doubt Sphinx or\r
+prerst2man.py are intelligent enough to not clobber the roff files if\r
+their content hasn't changed, but I don't see a point in explicitly\r
+bumping timestamps either.\r
+\r
+I think I'll drop the ${MAN_ROFF_FILES} as part of the patch I'm\r
+working on, but let me know if I'm just missing something.\r
+\r
+Cheers,\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
+\r
+--xi/AxZ9U2VfEekdX\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
+iQIcBAEBAgAGBQJTbkNGAAoJEKKfehoaNkbtLPMP/0YksUEaIFoUAdyTbh3iTSKz\r
+OpUNdned/u+hyVLto8uU5/OzXCHCmS987k/nzz2TlxdRTs9JEuGNeSR6b5K6CVWp\r
+GC2DZOGWBwUcpbyBc2LW1lLeFZdYc+MAYL6h6s5QuNwqL7TufWZEacr8Jw+tX1N2\r
+S0lHxd5Hj8H5QxxaMYy/MjscVdO09RKreW7w2LpZgYtIGXCmAtrZo3Ktm11gU2hJ\r
+AGeE4Z11+D3Ze97Z6SlEtXiO1c1FACwwdVaFAlApysPPwd9tK34ueZ7qhhk4iSsc\r
+/PaQmmbWDhPgEOt+hFTZuFqmHAJje8OVPkBRT6I6d21/XigvE7AyDRpRQrBmywVp\r
+X0nBnRSMMssCiCrFI8hhkrynETQWOBROdDTrV7ehSNEerQAATEw7Sc2jFjui6akD\r
+K8VpURUL7ppBLzhG2sZ5Hc6vE2Uj4mLW0WmTbAsjel6VRJRyFsudDfrcX5Zvh2Q6\r
+CYSFg/vIUaqWYM3xfpxPob1AGuvV38OAtt0g65KPShli4b0Z32/TrUUGEACVTGRP\r
+Yd6j/t3AD6om13Gfe/VaEwKIjQ6Ccs4d6dI1JEe1YMtEysnfb2Xe7l8pg+J8SA/u\r
+1TabxD+aVvbXg/6zZ80gI8ezsPDRCUsmZnV1Oqq3MHhVCuTuky0+d+rUqkCA6jTO\r
+TFHXK3LMZnTfvyIOSeao\r
+=9M7o\r
+-----END PGP SIGNATURE-----\r
+\r
+--xi/AxZ9U2VfEekdX--\r