From: Emil Velikov <emil.l.velikov@gmail.com>
Date: Mon, 2 Sep 2024 22:20:18 +0000 (+0100)
Subject: meson: add support for building the gtk-doc pages
X-Git-Tag: v34~419
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=59eadafbb3ff711aa6f783e52564d11d5cd6dd12;p=thirdparty%2Fkmod.git

meson: add support for building the gtk-doc pages

v2:
 - track the version.xml dependency

Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
Link: https://github.com/kmod-project/kmod/pull/94
Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
---

diff --git a/Makefile.am b/Makefile.am
index 1a518585..16c5ae60 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -17,6 +17,7 @@ export GCC_COLORS
 
 # meson bits
 EXTRA_DIST += \
+	libkmod/docs/meson.build \
 	man/meson.build \
 	meson.build \
 	meson_options.txt \
diff --git a/libkmod/docs/meson.build b/libkmod/docs/meson.build
new file mode 100644
index 00000000..ff0132c6
--- /dev/null
+++ b/libkmod/docs/meson.build
@@ -0,0 +1,22 @@
+gnome = import('gnome')
+
+version_file = configure_file(
+  input: 'version.xml.in',
+  output: 'version.xml',
+  configuration: cdata,
+)
+
+gnome.gtkdoc(
+  'libkmod',
+  content_files : version_file,
+  ignore_headers : [
+    '@0@/libkmod/libkmod-index.h'.format(meson.project_source_root()),
+    '@0@/libkmod/libkmod-internal-file.h'.format(meson.project_source_root()),
+    '@0@/libkmod/libkmod-internal.h'.format(meson.project_source_root()),
+  ],
+  scan_args : '--ignore-decorators="KMOD_EXPORT"',
+  src_dir : '@0@/libkmod/'.format(meson.project_source_root()),
+  namespace : 'kmod',
+  module_version : '3',
+  main_xml : 'libkmod-docs.xml',
+)
diff --git a/meson.build b/meson.build
index 9535c217..c41a2bbe 100644
--- a/meson.build
+++ b/meson.build
@@ -422,6 +422,10 @@ if get_option('manpages')
   subdir('man')
 endif
 
+if get_option('docs')
+  subdir('libkmod/docs')
+endif
+
 summary({
   'moduledir'   : moduledir,
   'prefix'      : get_option('prefix'),
@@ -438,6 +442,7 @@ summary({
   'debug-messages'  : get_option('debug-messages'),
   'build-tests'     : get_option('build-tests'),
   'manpages'        : get_option('manpages'),
+  'docs'            : get_option('docs'),
 }, section : 'Options')
 
 summary({
diff --git a/meson_options.txt b/meson_options.txt
index 7de6258e..62d97ceb 100644
--- a/meson_options.txt
+++ b/meson_options.txt
@@ -85,3 +85,10 @@ option(
   value : true,
   description : 'Build the manpages. Default: true',
 )
+
+option(
+  'docs',
+  type : 'boolean',
+  value : false,
+  description : 'Build the documentation. Default: false',
+)