From: Simon McVittie <smcv@collabora.com>
Date: Mon, 16 Dec 2024 10:59:20 +0000 (+0000)
Subject: INSTALL: Mention how to build as a Meson subproject
X-Git-Tag: dbus-1.16.0~3
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=f1a4c1c48156fc92a3f9465145a617e66bd047f9;p=thirdparty%2Fdbus.git

INSTALL: Mention how to build as a Meson subproject

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

diff --git a/INSTALL b/INSTALL
index 99ee1b5c0..37769eb90 100644
--- a/INSTALL
+++ b/INSTALL
@@ -96,6 +96,16 @@ 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.
 
+Building as a subproject
+========================
+
+libdbus can be built as a Meson subproject, allowing larger projects that
+require it to default to a system copy if available but fall back to a
+vendored or downloaded copy if necessary. When doing this, it is usually
+best to disable the shared library, dbus-daemon, tools and tests, leaving
+only a static library: please see test/use-as-subproject/meson.build for
+sample code and suggested build options.
+
 External software dependencies
 ==============================