INSTALL: Re-word CMake build instructions

Originally part of commit
"README,INSTALL: remove references to the autotools build system"
in dbus!378.

Co-authored-by: Simon McVittie <smcv@collabora.com>
Signed-off-by: Simon McVittie <smcv@collabora.com>

diff --git a/INSTALL b/INSTALL
index 4cfa4c87b80584e8440e4d169bfa2eaba9086602..08269e1e90aaf12c1d5205e54da14d68b3f829fc 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -71,13 +71,30 @@ https://mesonbuild.com/Running-Meson.html
 
 The CMake equivalent is:
 
-    mkdir dbus-build-dir
-    cd dbus-build-dir
-    cmake -G <makefile-generator-name> [-D<option>] <dbus-src-root>/cmake
-    make
-    make install
+``` sh
+cd <dbus-src-root>
+cmake -G <makefile-generator-name> [-D<option>] -B dbus-build-dir
+cmake --build <dbus-build-dir>
+cmake --build <dbus-build-dir> -t check
+```
+
+The installation of the build with CMake is performed with:
+
+``` sh
+cmake --build <dbus-build-dir> -t install [DESTDIR=<install-dir>]
+```
 
-See README.cmake for more details.
+When using makefile generator `-t install/fast` can also be used,
+which prevents rebuilding.
+
+CMake will automatically determine whether to build some features
+based on what tools and/or libraries are installed on the host system.
+The default build behaviour can be overridden using the
+-DENABLE_<XXX> arguments to cmake.
+A typical scenario in which it is desirable to override automatic
+detection, is during packaging of binary builds, where a predictable
+dependancy chain is required. For more details on cmake installation,
+consult http://www.cmake.org/cmake/help/help.html.
 
 External software dependencies
 ==============================