From 378c18e5f024ac5a8aef4cb40d7c9aa9633d144c Mon Sep 17 00:00:00 2001
From: Daniel Baumann <daniel.baumann@progress-linux.org>
Date: Sun, 7 Apr 2024 16:30:35 +0200
Subject: Adding upstream version 2.38.1.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
---
 tools/checklibdocs.sh | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)
 create mode 100755 tools/checklibdocs.sh

(limited to 'tools/checklibdocs.sh')

diff --git a/tools/checklibdocs.sh b/tools/checklibdocs.sh
new file mode 100755
index 0000000..094d2cb
--- /dev/null
+++ b/tools/checklibdocs.sh
@@ -0,0 +1,43 @@
+#!/bin/sh
+
+FILE_API_SYMBOLS="$1"
+FILE_API_DOCS="$2"
+
+if [ ! -f "$FILE_API_SYMBOLS" ]; then
+	echo "File $FILE_API_SYMBOLS is missing."
+	exit 1
+fi
+
+if [ ! -f "$FILE_API_DOCS" ]; then
+	echo "File $FILE_API_DOCS is missing."
+	exit 1
+fi
+
+fail_ct=0
+api_symbols=$(awk '/^([[:space:]]+)([[:alnum:]_]+);/ { gsub(";",""); print $1; }' "$FILE_API_SYMBOLS" | sort)
+doc_symbols=$(awk '/^([[:space:]])*$/ {next}; !/<.*>/ { print $1 }' "$FILE_API_DOCS" | sort)
+
+echo -n "Checking $FILE_API_SYMBOLS documentation ... "
+
+for sym in $api_symbols; do
+	case "$doc_symbols" in
+	*"$sym"*)
+		#echo -ne "\n '$sym'"
+		;;
+	*)
+		echo -ne "\n '$sym' undocumented"
+		fail_ct=$(($fail_ct + 1))
+		;;
+	esac
+done
+
+if [ $fail_ct -ne 0 ]; then
+	echo
+	echo "$fail_ct symbols is missing in ${FILE_API_DOCS}."
+	echo
+	exit 1
+else
+	echo "OK"
+fi
+
+exit 0
-- 
cgit v1.2.3