From b72305c2cd9d1b227653e0c3d1f4547372aabae7 Mon Sep 17 00:00:00 2001 From: Per Buer Date: Thu, 12 Dec 2024 08:49:27 +0100 Subject: [PATCH] build breaks without sphinx and doctools on macos --- doc/sphinx/installation/install_source.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/doc/sphinx/installation/install_source.rst b/doc/sphinx/installation/install_source.rst index 1e10f9782c8..37dd736b8a6 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 .0m.so you can rebuild the source later. Then continue `Compiling Varnish`_