From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:203:b4db::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id aAsQLGXzxWH8CQAAgWs5BA (envelope-from ) for ; Fri, 24 Dec 2021 17:20:53 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id 8OBVKWXzxWEedwEA9RJhRA (envelope-from ) for ; Fri, 24 Dec 2021 17:20:53 +0100 Received: from mail.notmuchmail.org (yantan.tethera.net [135.181.149.255]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 63E5BA278 for ; Fri, 24 Dec 2021 17:20:53 +0100 (CET) Received: from yantan.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id 2845A5F71B; Fri, 24 Dec 2021 16:20:49 +0000 (UTC) Received: from fethera.tethera.net (fethera.tethera.net [IPv6:2607:5300:60:c5::1]) by mail.notmuchmail.org (Postfix) with ESMTP id 0F2E55F715 for ; Fri, 24 Dec 2021 16:20:46 +0000 (UTC) Received: by fethera.tethera.net (Postfix, from userid 1001) id 415495FC42; Fri, 24 Dec 2021 11:20:45 -0500 (EST) Received: (nullmailer pid 2277855 invoked by uid 1000); Fri, 24 Dec 2021 16:20:43 -0000 From: David Bremner To: Daniel Kahn Gillmor , David Bremner , Notmuch Mail Subject: [PATCH] doc: add dep. on stamp file for rebuilding gzipped man pages. Date: Fri, 24 Dec 2021 12:20:31 -0400 Message-Id: <20211224162031.2277841-1-david@tethera.net> X-Mailer: git-send-email 2.34.1 In-Reply-To: <87tveotn1g.fsf@fifthhorseman.net> References: <87tveotn1g.fsf@fifthhorseman.net> MIME-Version: 1.0 Message-ID-Hash: IT2TVJ5PI2GTVJ4EFWDRSAOPSEO3QL7L X-Message-ID-Hash: IT2TVJ5PI2GTVJ4EFWDRSAOPSEO3QL7L X-MailFrom: bremner@tethera.net X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-notmuch.notmuchmail.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.3 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN X-Migadu-Country: DE ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1640362853; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-owner:list-unsubscribe:list-subscribe:list-post; bh=VTNI8rGHMN4Vno1eamL3hi+M2uvdeVpH+9qQ1Q8nfcs=; b=gptpT0DNudJOkUU5m24+YDRZ6ThhDW5dhCE07gUphC/+xE3j6GFIFjBiUL41jo3Is+U2qk t6yKXPnggle4NqnWtUv840FMh1KmEHYp5wqjTWTd9BCWdAjyUfvLh/8BORzG9PU7PqHSMm oLb+jfM59/6ZfJ3ItrHHnhmzi7+6LXrfEwmFQlHCd5pPBgqNj5m04YMr4w4CA55XETNQ9P gYR9ul1CkoEyxvF+JhsW4mPCsQJn0fXxQshPfunlTURPxG2V9qTJIACHNzEgCmfHMZFNGs AlUMKsXkOqrs6qZPYla7L7jhOcfrnfiays7p9HFD4TQX/AtYT6+BwBzcPssd5A== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1640362853; a=rsa-sha256; cv=none; b=LjSirmMK4L5EIwOf2/PUNy6er3YBZgbfy5UJZgMzxgJfIZMIwBXAZ5ZVd8j6yyyIDOPdqq 1clShyInMkqABXlAkDkfDPlT34iBlcMa7BkJfJ3uPea55mCILuDG7exZm9h+1au9w6Q6Gj JRhFKStVLIPbzGbd3cc0V9NdItqKYmIWb+FJFXLUSA2vG3KKt8EDNB0xCV8+gejWmpZG2n 9GX9bDV92HA8W5nbgDgkcAFH+6Mr30Uk0eBCUETVOgODusDhy3Sbh/E2vwduKB26PYNGjd uYrszn/7ep6HODRYu1MyyJbc0t6qx3fFPPa3SRpTsRrTKYw66hGARB3EMi5kwQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 135.181.149.255 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: -1.25 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 135.181.149.255 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: 63E5BA278 X-Spam-Score: -1.25 X-Migadu-Scanner: scn0.migadu.com X-TUID: 4oUXhMOwRB3X In [1] Daniel observed that the gzipped man pages were only being rebuild every second time when building with `make -j4'. This may be caused by a race condition between sphinx-build rebuilding the roff files and the recipe to gzip them. This commit sequentializes these two steps by making the stamp file a prerequisite for (all of) the gzip files. [1]: id:87tveotn1g.fsf@fifthhorseman.net --- doc/Makefile.local | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/Makefile.local b/doc/Makefile.local index c2ae1743..d43ef269 100644 --- a/doc/Makefile.local +++ b/doc/Makefile.local @@ -117,6 +117,11 @@ build-man: install-man: @echo "No sphinx, will not install man pages." else + +# it should be safe to depend on the stamp file, because it is created +# after all roff files are moved into place. +${MAN_GZIP_FILES}: ${DOCBUILDDIR}/.roff.stamp + build-man: ${MAN_GZIP_FILES} install-man: ${MAN_GZIP_FILES} mkdir -m0755 -p "$(DESTDIR)$(mandir)/man1" -- 2.34.1