doc: generate API documentation with doxygen

When configured with --enable-documentation, use doxygen.

.gitignore

@@ -36,3 +36,5 @@ tags
 *~
 .stgit*
 doc/protocol.html
+doc/protocol
+doc/api

configure.ac

@@ -1077,6 +1077,13 @@ if test x$enable_documentation = xyes; then
 	fi
 
 	AC_SUBST(XMLTO)
+
+	AC_PATH_PROG(DOXYGEN, doxygen)
+	if test x$DOXYGEN = x; then
+		AC_MSG_ERROR([doxygen not found])
+	fi
+
+	AC_SUBST(DOXYGEN)
 fi
 
 AM_CONDITIONAL(ENABLE_DOCUMENTATION, test x$enable_documentation = xyes)

doc/Makefile.am

@@ -12,8 +12,17 @@ protocol_DATA = $(wildcard protocol/*.html)
 $(DOCBOOK_HTML): %/index.html: %.xml
 	$(XMLTO) -o protocol --stringparam chunker.output.encoding=utf-8 html $<
 
-all-local: $(DOCBOOK_HTML)
+api/html/index.html: doxygen.conf
+	$(DOXYGEN) $<
+
+all-local: $(DOCBOOK_HTML) api/html/index.html
 
 clean-local:
 	rm -rf $(patsubst %.xml,%,$(DOCBOOK_FILES))
+	rm -rf api
+
+install-data-local: api/html/index.html
+	$(mkinstalldirs) $(docdir)/api/html
+	$(INSTALL_DATA) -c -m 644 api/html/*.html api/html/*.css api/html/*.png api/html/*.gif $(docdir)/api/html
+
 endif