chiark / gitweb /
build-sys: add a make target to look for undocumented symbols
authorLennart Poettering <lennart@poettering.net>
Thu, 7 Nov 2013 16:26:01 +0000 (17:26 +0100)
committerLennart Poettering <lennart@poettering.net>
Thu, 7 Nov 2013 16:26:01 +0000 (17:26 +0100)
With super-pretty output!

Makefile.am

index 5c3cbc1..86baae0 100644 (file)
@@ -4572,4 +4572,15 @@ install-tree: all
 # Let's run all tests of the test suite, but under valgrind. Let's
 # exclude the one perl script we have in there
 valgrind-tests: $(TESTS)
 # Let's run all tests of the test suite, but under valgrind. Let's
 # exclude the one perl script we have in there
 valgrind-tests: $(TESTS)
-       for f in $(TESTS) ; do [ "$$f" == "$${f/.pl/}" ] && libtool --mode=execute valgrind --leak-check=full --error-exitcode=55 $(builddir)/$$f ; done
+       for f in $(TESTS) ; do \
+               [ "$$f" == "$${f/.pl/}" ] && libtool --mode=execute valgrind --leak-check=full --error-exitcode=55 $(builddir)/$$f ; \
+       done
+
+check-api-docs: $(lib_LTLIBRARIES)
+       for symbol in `for f in $(lib_LTLIBRARIES) ; do nm -g --defined-only $(builddir)/.libs/"$${f/.la/.so}" 2>&1 /dev/null | grep " T " | cut -d" " -f3 ; done` ; do \
+               if test -f $(builddir)/man/$$symbol.html ; then \
+                       echo "  Symbol $$symbol() is documented." ; \
+               else \
+                       echo "‣ Symbol $$symbol() lacks documentation." ; \
+               fi ; \
+        done