From 047e0d0d7cf152e4e4d463354a35d24226d09c72 Mon Sep 17 00:00:00 2001
From: Phil de Joux <philderbeast@gmail.com>
Date: Wed, 23 Sep 2026 12:57:14 -0400
Subject: [PATCH] Build cabal before help output

- Don't monitor cabal-install-internal yet

Co-Authored-By: Ilya Baryshnikov <grintypes@gmail.com>
---
 doc/Makefile | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)

diff --git a/doc/Makefile b/doc/Makefile
index b7b7cff5717..d9c81cd116e 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -127,32 +127,41 @@ SETUP_COMMANDS := \
 
 # NOTE: To silence the following warning, redirect stderr to /dev/null:
 #   Warning: this is a debug build of cabal-install with assertions enabled.
-cmd-v1-help/%.txt:
+
+# Build the cabal binary before capturing any help output: with a cold
+# dependency cache, `cabal run` would otherwise interleave the configure
+# logs of freshly built dependencies (process, resolv, network, ...) into
+# the captured stdout and pollute the generated .txt files.
+.PHONY: cmd-help-build
+cmd-help-build:
+	@cabal build -v0 cabal-install:exe:cabal > /dev/null 2>&1
+
+cmd-v1-help/%.txt: | cmd-help-build
 	@mkdir -p $(@D)
 	@cabal run -v0 cabal-install:exe:cabal -- v1-$* --help > $@ 2>/dev/null
 
-cmd-v2-help/%.txt:
+cmd-v2-help/%.txt: | cmd-help-build
 	@mkdir -p $(@D)
 	@cabal run -v0 cabal-install:exe:cabal -- $* --help > $@ 2>/dev/null
 
 # The "You can edit the cabal configuration file..." footer embeds an
 # absolute, machine-specific config path, so strip it for reproducibility.
-cmd-v2-help/help.txt:
+cmd-v2-help/help.txt: | cmd-help-build
 	@mkdir -p $(@D)
 	@cabal run -v0 cabal-install:exe:cabal -- --help 2>/dev/null \
 	  | sed '/^You can edit the cabal configuration file to set defaults:$$/,$$d' > $@
 
-cmd-v2-hidden-help/%.txt:
+cmd-v2-hidden-help/%.txt: | cmd-help-build
 	@mkdir -p $(@D)
 	@cabal run -v0 cabal-install:exe:cabal -- $* --help > $@ 2>/dev/null
 
 # act-as-setup runs Distribution.Simple.defaultMainArgs directly; the "--"
 # forwards args after it verbatim instead of being parsed by cabal itself.
-setup-help/%.txt:
+setup-help/%.txt: | cmd-help-build
 	@mkdir -p $(@D)
 	@cabal run -v0 cabal-install:exe:cabal -- act-as-setup -- $* --help > $@ 2>/dev/null
 
-setup-help/help.txt:
+setup-help/help.txt: | cmd-help-build
 	@mkdir -p $(@D)
 	@cabal run -v0 cabal-install:exe:cabal -- act-as-setup -- --help > $@ 2>/dev/null