meson: resurrect API documentation target

We had this functionality back in Automake times, let's resurrect it.

diff --git a/meson.build b/meson.build
index e0e1f84782fc5f1de132bcbf837b0f7b5ba155cf..bdda7561d715d25244dbc5e14b333faf0643e8cd 100644 (file)
--- a/meson.build
+++ b/meson.build
@@ -2869,6 +2869,14 @@ endif
 
 ############################################################
 
+meson_check_api_docs_sh = find_program('tools/meson-check-api-docs.sh')
+run_target(
+        'check-api-docs',
+        depends : [man, libelogind, libudev],
+        command : [meson_check_api_docs_sh, libelogind.full_path(), libudev.full_path()])
+
+############################################################
+
 status = [
         '@0@ @1@'.format(meson.project_name(), meson.project_version()),
 

diff --git a/tools/meson-check-api-docs.sh b/tools/meson-check-api-docs.sh
new file mode 100644 (file)
index 0000000..5bc808c
--- /dev/null
+++ b/tools/meson-check-api-docs.sh
@@ -0,0 +1,11 @@
+#!/bin/sh
+
+set -eu
+
+for symbol in `nm -g --defined-only "$@" | grep " T " | cut -d" " -f3 | sort -u` ; do
+        if test -f ${MESON_BUILD_ROOT}/man/$symbol.3 ; then
+                echo "✓ Symbol $symbol() is documented."
+        else
+                printf "  \x1b[1;31mSymbol $symbol() lacks documentation.\x1b[0m\n"
+        fi
+done