From e9670d3c3c4637099dc0f0c91cd5cb526e48ad63 Mon Sep 17 00:00:00 2001
From: Philip Withnall <pwithnall@gnome.org>
Date: Wed, 11 Dec 2024 15:36:50 +0000
Subject: [PATCH] docs: Warn if building documentation without enable_gir
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

If `-Ddocumentation=true` is specified without
`-Dintrospection=enabled`, warn the user. They might expect the
documentation to be built, but it won’t.

Signed-off-by: Philip Withnall <pwithnall@gnome.org>
---
 docs/reference/meson.build | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/reference/meson.build b/docs/reference/meson.build
index 699504b0a..b99c69ee4 100644
--- a/docs/reference/meson.build
+++ b/docs/reference/meson.build
@@ -15,6 +15,8 @@ if get_option('documentation') and enable_gir
     '--fatal-warnings',
     '--add-include-path=@0@'.format(meson.current_build_dir() / '../../girepository/introspection'),
   ]
+elif get_option('documentation')
+  warning('Full documentation cannot be built without -Dintrospection=enabled')
 endif
 
 docs_dir = glib_datadir / 'doc'