From a1b91e86e42c7fdfa9ea1760d1429df04822f955 Mon Sep 17 00:00:00 2001
From: Ignacio Casal Quinteiro <qignacio@amazon.com>
Date: Tue, 26 Jan 2021 12:38:01 +0100
Subject: [PATCH] meson: build reference manual with gtk_doc

---
 docs/libpsl/meson.build | 21 ++++++++++++++++++++-
 meson_options.txt       |  3 +++
 2 files changed, 23 insertions(+), 1 deletion(-)

diff --git a/docs/libpsl/meson.build b/docs/libpsl/meson.build
index ee17494..f9250b0 100644
--- a/docs/libpsl/meson.build
+++ b/docs/libpsl/meson.build
@@ -1 +1,20 @@
-install_man('libpsl.3')
+gnome = import('gnome')
+
+if get_option('docs')
+  configure_file(
+    input : 'version.xml.in',
+    output : 'version.xml',
+    configuration : cdata)
+
+  gnome.gtkdoc('libpsl',
+    main_sgml: 'libpsl-docs.sgml',
+    src_dir: [
+      'src',
+      'include',
+    ],
+    dependencies: libpsl,
+    scan_args: [
+      '--ignore-decorators=G_GNUC_PSL_UNUSED',
+    ],
+    install: true)
+endif
diff --git a/meson_options.txt b/meson_options.txt
index eb80489..fca0c17 100644
--- a/meson_options.txt
+++ b/meson_options.txt
@@ -14,3 +14,6 @@ option('psl_file', type : 'string', value : '',
 
 option('psl_testfile', type : 'string', value : '',
   description : 'path to PSL test file')
+
+option('docs', type: 'boolean', value: false,
+  description: 'Build the API reference (requires gtk-doc)')