From b67d8464ffb7421f062bea92b52694dad23835fa Mon Sep 17 00:00:00 2001
From: Roland Conybeare <rconybeare@gmail.com>
Date: Sun, 11 Jan 2026 14:11:46 -0500
Subject: [PATCH] docs: no longer need 2-phase umbrella build

---
 README.md | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 3637a189..02800e15 100644
--- a/README.md
+++ b/README.md
@@ -47,17 +47,9 @@ Alternatively can use full nix build, see `Nix Build`
 If `nix` is available, you probably prefer the nix build, unless working on XO itself.
 Otherwise continue reading..
 
-The cmake build has two phases, because it needs to bootstrap
-generated `xo-cmake-config`, `xo-build` helpers.
-
 ```
 $ cd xo
 $ PREFIX=/path/to/say/usr/local
-# phase 1
-$ cmake -B .build0 -S xo-cmake -DCMAKE_INSTALL_PREFIX=${PREFIX}
-$ cmake --build .build0
-$ cmake --install .build0
-# phase 2
 $ cmake -B .build -S . -DCMAKE_INSTALL_PREFIX=${PREFIX} -DXO_ENABLE_EXAMPLES=1 -DXO_ENABLE_DOCS=1 -DCMAKE_BUILD_TYPE=debug
 $ cmake --build .build --verbose
 $ cmake --install .build
@@ -65,10 +57,16 @@ $ cmake --install .build
 
 or with Vulkan examples
 ```
-# at start of phase 2
 $ cmake -B .build -S . -DCMAKE_INSTALL_PREFIX=${PREFIX} -DXO_ENABLE_EXAMPLES=1 -DXO_ENABLE_VULKAN=1
 ```
 
+### Re-run cmake
+
+```
+$ cd xo
+$ .build/reconfigure.sh
+```
+
 ### Cmake build documentation
 
 Documentation relies on doxygen, sphinx and breathe.