Add initial Doxygen support for generating api documentation.
Doxygen is a tool for generating programming documentation
based on comments in header and source files. This commit
adds the necessary configuration file and associated support
in the autotools build.
Right now it doesn't generate much documentation because our
public header files aren't marked up. Warnings are printed
for undocumented members and arguments.
diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 0000000..7e72e11
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,20 @@
+## Process this file with automake to produce Makefile.in
+
+DOCINPUTS = $(top_srcdir)/src/opus.h \
+ $(top_srcdir)/src/opus_multistream.h \
+ $(top_srcdir)/libcelt/opus_defines.h \
+ $(top_srcdir)/libcelt/opus_types.h
+
+doc_DATA = doxygen-build.stamp
+
+EXTRA_DIST = Doxyfile.in
+
+if HAVE_DOXYGEN
+doxygen-build.stamp: Doxyfile $(DOCINPUTS)
+ doxygen
+ touch $@
+else
+doxygen-build.stamp: Doxyfile $(DOCINPUTS)
+ @echo "*** Warning: Doxygen not found; API documentation will not be built."
+ touch $@
+endif