From 911c9737ddc189fc923cc020871e59696281493d Mon Sep 17 00:00:00 2001
From: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Date: Tue, 7 Oct 2025 13:29:18 +0100
Subject: [PATCH] gh-139436: Remove ``dist-pdf`` from the docs archives rebuild
 target (#139437)

(cherry picked from commit 0e2cdd313ba5c67c5e2e21d993399b890e687c63)
---
 Doc/Makefile | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/Doc/Makefile b/Doc/Makefile
index becda93960d5b4..6cc43abfd7c1bd 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -184,11 +184,22 @@ venv:
 		echo "The venv has been created in the $(VENVDIR) directory"; \
 	fi
 
+.PHONY: dist-no-html
+dist-no-html: dist-text dist-epub dist-texinfo
+
 .PHONY: dist
 dist:
 	rm -rf dist
 	mkdir -p dist
 
+	$(MAKE) dist-html
+	$(MAKE) dist-text
+	$(MAKE) dist-pdf
+	$(MAKE) dist-epub
+	$(MAKE) dist-texinfo
+
+.PHONY: dist-html
+dist-html:
 	# archive the HTML
 	make html
 	cp -pPR build/html dist/python-$(DISTVERSION)-docs-html
@@ -198,6 +209,8 @@ dist:
 	rm -r dist/python-$(DISTVERSION)-docs-html
 	rm dist/python-$(DISTVERSION)-docs-html.tar
 
+.PHONY: dist-text
+dist-text:
 	# archive the text build
 	make text
 	cp -pPR build/text dist/python-$(DISTVERSION)-docs-text
@@ -207,6 +220,8 @@ dist:
 	rm -r dist/python-$(DISTVERSION)-docs-text
 	rm dist/python-$(DISTVERSION)-docs-text.tar
 
+.PHONY: dist-pdf
+dist-pdf:
 	# archive the A4 latex
 	rm -rf build/latex
 	make latex PAPER=a4
@@ -223,11 +238,15 @@ dist:
 	cp build/latex/docs-pdf.zip dist/python-$(DISTVERSION)-docs-pdf-letter.zip
 	cp build/latex/docs-pdf.tar.bz2 dist/python-$(DISTVERSION)-docs-pdf-letter.tar.bz2
 
+.PHONY: dist-epub
+dist-epub:
 	# copy the epub build
 	rm -rf build/epub
 	make epub
 	cp -pPR build/epub/Python.epub dist/python-$(DISTVERSION)-docs.epub
 
+.PHONY: dist-texinfo
+dist-texinfo:
 	# archive the texinfo build
 	rm -rf build/texinfo
 	make texinfo
@@ -258,12 +277,12 @@ serve:
 # for development releases: always build
 .PHONY: autobuild-dev
 autobuild-dev:
-	make dist SPHINXOPTS='$(SPHINXOPTS) -Ea -A daily=1'
+	make dist-no-html SPHINXOPTS='$(SPHINXOPTS) -Ea -A daily=1'
 
 # for quick rebuilds (HTML only)
 .PHONY: autobuild-dev-html
 autobuild-dev-html:
-	make html SPHINXOPTS='$(SPHINXOPTS) -Ea -A daily=1'
+	make dist-html SPHINXOPTS='$(SPHINXOPTS) -Ea -A daily=1'
 
 # for stable releases: only build if not in pre-release stage (alpha, beta)
 # release candidate downloads are okay, since the stable tree can be in that stage