[master] 414d1b266 doc: build breaks without sphinx and doctools on macos

[Nils Goroll]

commit 414d1b2668b320336d9c1d9188dfc46e6f78fd5c
Author: Per Buer <per.buer at gmail.com>
Date:   Thu Dec 12 08:49:27 2024 +0100

    doc: build breaks without sphinx and doctools on macos

diff --git a/doc/sphinx/installation/install_source.rst b/doc/sphinx/installation/install_source.rst
index 1e10f9782..071600d0a 100644
--- a/doc/sphinx/installation/install_source.rst
+++ b/doc/sphinx/installation/install_source.rst
@@ -154,7 +154,7 @@ Build dependencies on macOS
 To compile varnish on macOS, these steps should install the required
 dependencies:
 
-* Install ``xcode`` via the App Store
+* Install xcode: `xcode-select --install`
 
 * Install dependencies via `brew`::
 
@@ -166,9 +166,11 @@ dependencies:
 	docutils \
 	sphinx-doc
 
-* Add sphinx to PATH as advised by the installer::
+* Add the sphinx tools and the docutils to PATH so `configure` will find them.
 
-    PATH="/usr/local/opt/sphinx-doc/bin:$PATH"
+    PATH="/opt/homebrew/opt/sphinx-doc/bin:/opt/homebrew/opt/docutils/bin:$PATH"
+
+It'll be a good idea to persist these changes so you can rebuild the source later.
 
 Then continue `Compiling Varnish`_