[glib/ebassi/static-docs] Build API docs only with shared libraries

[Emmanuele Bassi <ebassi src gnome org>]

commit 32edf9c01a68473f58b540da5371737bbc2ed2a3
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Wed Sep 14 15:03:43 2022 +0100

    Build API docs only with shared libraries
    
    Building the references requires libraries with all their symbols
    available. Passing `-Dgtk_doc=true` and `-Ddefault_library=static`
    should be considered a configuration error.

 docs/reference/meson.build | 6 ++++++
 1 file changed, 6 insertions(+)
---
diff --git a/docs/reference/meson.build b/docs/reference/meson.build
index ad1b9e3536..dcaa5c2765 100644
--- a/docs/reference/meson.build
+++ b/docs/reference/meson.build
@@ -49,6 +49,12 @@ if get_option('gtk_doc')
     default_options : ['tests=false'])
 endif
 
+# We cannot built the API reference off of a static library,
+# as symbols might get dropped by the linker
+if get_option('gtk_doc') and get_option('default_library') == 'static'
+  error('The API reference can only be built against a shared library')
+endif
+
 subdir('gio')
 subdir('glib')
 subdir('gobject')