doc: New documentation build setup (doxygen)

Makefile.am

@@ -2,11 +2,13 @@ AUTOMAKE_OPTIONS = foreign
 
 ACLOCAL_AMFLAGS = -I m4
 
-if BUILD_TEST
-SUBDIRS_TEST = test
+SUBDIRS = src data
+if BUILD_DOC
+SUBDIRS += doc
+endif
+if BUILD_TEST
+SUBDIRS += test
 endif
-
-SUBDIRS = src data doc $(SUBDIRS_TEST)
 DIST_SUBDIRS = src data doc
 
 CLEANFILES = $(PACKAGE).spec
@@ -37,4 +39,8 @@ $(top_builddir)/$(PACKAGE).spec: FORCE
 	sed "s/\@PACKAGE\@/@PACKAGE@/;s/\@VERSION\@/@VERSION@/;s/\@RPM_RELEASE\@/$(RPM_RELEASE)/" \
 		$(top_srcdir)/$(PACKAGE).spec.in > $@
 
+.PHONY: doc test
+doc test:
+	$(MAKE) -C $@
+
 FORCE:

configure.ac

@@ -231,6 +231,11 @@ AC_ARG_ENABLE([debug],
 )
 AM_CONDITIONAL(BUILD_DEBUG, test "$enable_debug" = "yes")
 
+AC_ARG_ENABLE([doc-build],
+  [AS_HELP_STRING([--enable-doc-build], [Enable building documentation (not installed) @<:@default=no@:>@])]
+)
+AM_CONDITIONAL(BUILD_DOC, test "$enable_doc_build" = "yes")
+
 EC_C_WARNINGS()
 EC_C_VISIBILITY(yes)
 EC_C_ASAN()
@@ -257,6 +262,8 @@ data/Makefile
 data/fonts/Makefile
 data/images/Makefile
 doc/Makefile
+doc/Doxyfile
+doc/imlib2_intro.dox
 README
 ])
 AM_COND_IF([SRC_IS_GIT], [ AC_CONFIG_FILES([test/Makefile]) ])

doc/Makefile.am

@@ -1 +1,12 @@
 EXTRA_DIST = Doxyfile.in imlib2_intro.dox.in imlib2_logo.png
+
+DEPFILES = Doxyfile imlib2_intro.dox
+
+all-local: html/index.html
+
+html/index.html: $(DEPFILES) ../src/lib/Imlib2.h
+	rm -rf html man
+	doxygen
+
+clean-local:
+	rm -rf $(DEPFILES) html man