From: Ralf Habacker <ralf.habacker@freenet.de>
Date: Tue, 15 Aug 2023 12:09:21 +0000 (+0100)
Subject: INSTALL: Re-word CMake build instructions
X-Git-Tag: dbus-1.15.8~15
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=041b236251dc6ea516e20f112dd0a0cd9bb1bc79;p=thirdparty%2Fdbus.git

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 4cfa4c87b..08269e1e9 100644
--- 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
 ==============================