Build documentation.

Detect when doxygen, dot, and pdflatex are installed.  When they are, enable
documentation.  Add --enable-documentation and --disable-documentation to
override the autodetection.  Install the docs to the configured docdir (usually
$prefix/share/doc/libvdpau).

.gitignore

@@ -11,6 +11,7 @@ config.status
 config.sub
 configure
 depcomp
+doc/html-out
 install-sh
 libtool
 libvdpau-*.tar.bz2

Makefile.am

-SUBDIRS = src trace
+SUBDIRS = doc src trace
 
 pkgconfigdir = $(libdir)/pkgconfig
 pkgconfig_DATA = vdpau.pc

configure.ac

@@ -26,9 +26,35 @@ AC_CHECK_FUNC([dlopen], [],
         AC_CHECK_LIB([dl], [dlopen], DLOPEN_LIBS="-ldl"))
 AC_SUBST([DLOPEN_LIBS])
 
+# Check for Doxygen.
+AC_ARG_ENABLE(documentation, AS_HELP_STRING([--disable-documentation], [Disable Doxygen documentation (default: auto)]), [DOCS=$enableval], [DOCS=auto])
+if test "x$DOCS" != xno; then
+    AC_CHECK_TOOL([DOXYGEN], [doxygen], [no])
+    AC_CHECK_TOOL([DOT], [dot], [no])
+    AC_CHECK_TOOL([PDFTEX], [pdftex], [no])
+else
+    DOXYGEN=no
+    DOT=no
+    PDFTEX=no
+fi
+if test "x$DOCS" = xyes; then
+    if test "x$DOXYGEN" = xno; then
+        AC_ERROR([Documentation enabled but doxygen was not found in your path])
+    fi
+    if test "x$DOT" = xno; then
+        AC_ERROR([Documentation enabled but dot was not found in your path.  Please install graphviz])
+    fi
+    if test "x$PDFTEX" = xno; then
+        AC_ERROR([Documentation enabled but pdftex was not found in your path])
+    fi
+fi
+AM_CONDITIONAL([ENABLE_DOCS], [test "x$DOXYGEN" != xno -a "x$DOT" != xno -a "x$PDFTEX" != xno])
+AC_SUBST(DOXYGEN)
+
 XORG_CHANGELOG
 
 AC_OUTPUT([Makefile
+           doc/Makefile
            src/Makefile
            trace/Makefile
            vdpau.pc])

doc/Makefile.am

+all: html
+install-data-local: install-html
+
+VDPAU_HEADER_DIR := $(top_srcdir)/include
+VDPAU_HEADER_FILES := \
+    $(VDPAU_HEADER_DIR)/vdpau/vdpau.h \
+    $(VDPAU_HEADER_DIR)/vdpau/vdpau_x11.h
+
+export VDPAU_HEADER_DIR
+export VDPAU_HEADER_FILES
+html-out/%: Doxyfile $(VDPAU_HEADER_FILES)
+	$(DOXYGEN) $<
+
+if ENABLE_DOCS
+html: html-out/index.html
+install-html-local:
+	$(install_sh) -d $(DESTDIR)$(docdir)/html
+	$(install_sh) -m 644 html-out/* $(DESTDIR)$(docdir)/html
+endif
+
+clean-local:
+	$(RM) -r html-out