From 50b459be732a7f61f9e06408d19718284dbe5b9e Mon Sep 17 00:00:00 2001
From: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Date: Tue, 28 May 2024 09:00:19 +0300
Subject: [PATCH] Infra: Define port for htmllive to avoid collisions (#3792)

---
 Makefile | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/Makefile b/Makefile
index 65192b5e8..ac1580a97 100644
--- a/Makefile
+++ b/Makefile
@@ -9,10 +9,10 @@ SPHINXBUILD  = PATH=$(VENVDIR)/bin:$$PATH sphinx-build
 BUILDER      = html
 JOBS         = auto
 SOURCES      =
-SPHINXERRORHANDLING = -W --keep-going -w sphinx-warnings.txt
+SPHINXERRORHANDLING = --fail-on-warning --keep-going --warning-file sphinx-warnings.txt
 
-ALLSPHINXOPTS = -b $(BUILDER) \
-                -j $(JOBS) \
+ALLSPHINXOPTS = --builder $(BUILDER) \
+                --jobs $(JOBS) \
                 $(SPHINXOPTS) $(SPHINXERRORHANDLING) \
                 peps $(BUILDDIR) $(SOURCES)
 
@@ -33,7 +33,9 @@ ensure-sphinx-autobuild: venv
 ## htmllive       to rebuild and reload HTML files in your browser
 .PHONY: htmllive
 htmllive: SPHINXBUILD = $(VENVDIR)/bin/sphinx-autobuild
-htmllive: SPHINXERRORHANDLING = --re-ignore="/\.idea/|/venv/|/pep-0000.rst|/topic/" --open-browser --delay 0
+# Arbitrarily selected ephemeral port between 49152–65535
+# to avoid conflicts with other processes:
+htmllive: SPHINXERRORHANDLING = --re-ignore="/\.idea/|/venv/|/pep-0000.rst|/topic/" --open-browser --delay 0 --port 55302
 htmllive: ensure-sphinx-autobuild html
 
 ## dirhtml        to render PEPs to "index.html" files within "pep-NNNN" directories