summaryrefslogtreecommitdiff
path: root/doc/public/check-doc-coverage.sh
blob: 648ca1212e9920d177558d2c6ca706f08bc72c36 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
#!/bin/sh

LC_ALL=C
export LC_ALL

if test -z "$DOC_MODULE"; then
	# extract from Makefile
	eval `grep '^DOC_MODULE' Makefile | sed 's/ //g'`
	if test -z "$DOC_MODULE"; then
		echo Failed extracting DOC_MODULE from Makefile 1>&2
		echo Try setting DOC_MODULE env var manually 1>&2
		exit 1
	fi
fi

if test -n "$REPORT_FILES"; then
	$MAKE $REPORT_FILES || exit 1
fi

test -z "$srcdir" && srcdir=.
stat=0

if test -f "$DOC_MODULE-undeclared.txt"; then
	undeclared=`cat "$DOC_MODULE-undeclared.txt"`
	if test -n "$undeclared"; then
		echo "*** ERROR: Undeclared documentation symbols:" 1>&2
		cat "$DOC_MODULE-undeclared.txt" 1>&2
		stat=1
	fi
fi >&2
if test -f "$DOC_MODULE-unused.txt"; then
	unused=`cat "$DOC_MODULE-unused.txt"`
	if test -n "$unused"; then
		echo "*** ERROR: Unused documented symbols:" 1>&2
		cat "$DOC_MODULE-unused.txt" 1>&2
		stat=1
	fi
fi >&2
if test -f "$DOC_MODULE-undocumented.txt"; then
	if grep '^0 symbols incomplete' "$DOC_MODULE-undocumented.txt" >/dev/null &&
	   grep '^0 not documented'     "$DOC_MODULE-undocumented.txt" >/dev/null; then
		:
	else
		echo "*** ERROR: Incomplete or undocumented symbols:" 1>&2
		cat "$DOC_MODULE-undocumented.txt" 1>&2
		stat=1
	fi
fi >&2

if test $stat != 0; then
	echo "*** IGNORING ERROR ***"
fi
#exit $stat
exit 0