From fb02a57a2b9eac0527d7644e3e394e6d709fa182 Mon Sep 17 00:00:00 2001
From: Benjamin Berg <bberg@redhat.com>
Date: Mon, 7 Feb 2022 15:56:25 +0100
Subject: [PATCH] meson: Clarify why build_by_default is needed for some
 custom_targets

---
 doc/meson.build | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/meson.build b/doc/meson.build
index 636ef8f..dc93a16 100644
--- a/doc/meson.build
+++ b/doc/meson.build
@@ -14,7 +14,8 @@ foreach iface: upowerd_dbus_interfaces
     input: files(dbus_dir / iface + '.xml'),
     output: iface_ref,
     command: [xsltproc, '--output', '@OUTPUT@', spec_to_docbook, '@INPUT@'],
-    # XXX: This appears to be needed so that "ninja -C _build install" works
+    # gnome.gtkdoc dependencies don't work properly
+    # https://github.com/mesonbuild/meson/pull/9960
     build_by_default: get_option('gtk-doc'),
   )
 endforeach