Adding upstream version 241.upstream/241upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 34 insertions, 0 deletions

diff --git a/tools/meson-check-api-docs.sh b/tools/meson-check-api-docs.sh
new file mode 100755
index 0000000..a654368
--- /dev/null
+++ b/tools/meson-check-api-docs.sh
@@ -0,0 +1,34 @@
+#!/bin/sh
+
+set -eu
+
+sd_good=0
+sd_total=0
+udev_good=0
+udev_total=0
+
+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."
+                good=1
+        else
+                printf "  \x1b[1;31mSymbol $symbol() lacks documentation.\x1b[0m\n"
+                good=0
+        fi
+
+        case $symbol in
+                sd_*)
+                        ((sd_good+=good))
+                        ((sd_total+=1))
+                        ;;
+                udev_*)
+                        ((udev_good+=good))
+                        ((udev_total+=1))
+                        ;;
+                *)
+                        echo 'unknown symbol prefix'
+                        exit 1
+        esac
+done
+
+echo "libsystemd: $sd_good/$sd_total libudev: $udev_good/$udev_total"