optionally create internal docs (including call graphs etc.)

git-svn-id: https://svn.code.sf.net/p/gphoto/code/trunk/libgphoto2@10642 67ed7778-7388-44ab-90cf-0a291f65f57c

2 files changed, 56 insertions, 18 deletions

diff --git a/configure.ac b/configure.ac
index add4dc304..77f9c7228 100644
--- a/configure.ac
+++ b/configure.ac
@@ -525,6 +525,7 @@ dnl documentation
 dnl --------------------------------------------------------------------
 GP_CHECK_DOC_DIR()dnl
 GP_CHECK_DOXYGEN()dnl
+GP_INTERNAL_DOCS()dnl
 GP_BUILD_GTK_DOCS()dnl
 AC_SUBST([camlibdocdir], ['${docdir}/camlibs'])
 
@@ -620,6 +621,7 @@ packaging/rpm/package.spec
 po/Makefile.in
 doc/Makefile
 doc/Doxyfile
+doc/Doxyfile-internals
 doc/api/Makefile
 ],[
 dnl This relies on this code being called for each of the above files
diff --git a/doc/Makefile.am b/doc/Makefile.am
index c29e0edd0..8def35856 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -16,48 +16,84 @@ man_MANS = libgphoto2.3 libgphoto2_port.3
 
 if HAVE_DOXYGEN
 
-DOXYGEN_FILES =
-DOXYGEN_STAMPS = $(DOXYGEN_OUTPUT_DIR).stamp
+DOXYGEN_STAMPS =
+LOCAL_INSTALL =
+LOCAL_UNINSTALL =
+LOCAL_CLEAN =
+
 
 # FIXME: Depend on source files.
-$(DOXYGEN_OUTPUT_DIR).stamp: Doxyfile
+DOXYGEN_STAMPS += $(HTML_APIDOC_DIR).stamp
+$(HTML_APIDOC_DIR).stamp: Doxyfile
 	doxygen Doxyfile
 	echo > $@
 
-$(HTML_APIDOC_DIR).tar.gz: $(DOXYGEN_OUTPUT_DIR).stamp
+$(HTML_APIDOC_DIR).tar.gz: $(HTML_APIDOC_DIR).stamp
 	(cd $(DOXYGEN_OUTPUT_DIR) && $(AMTAR) chof - $(HTML_APIDOC_DIR) | GZIP=--best gzip -c) > $@
 
+$(HTML_APIDOC_INTERNALS_DIR).tar.gz: $(HTML_APIDOC_INTERNALS_DIR).stamp
+	(cd $(DOXYGEN_OUTPUT_DIR) && $(AMTAR) chof - $(HTML_APIDOC_INTERNALS_DIR) | GZIP=--best gzip -c) > $@
+
 DOC_APIDOC_HTML = apidocs.html
+DOC_APIDOC_INTERNALS_HTML = internal-docs.html
 
-install-apidocs: $(DOXYGEN_OUTPUT_DIR).stamp
-	$(INSTALL) -m 0755 -d $(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML)
-	$(INSTALL) -m 0644 $(DOXYGEN_OUTPUT_DIR)/$(HTML_APIDOC_DIR)/* $(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML)/
+LOCAL_INSTALL += install-apidocs
+install-apidocs: $(HTML_APIDOC_DIR).stamp
+	$(INSTALL) -m 0755 -d "$(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML)"
+	cd "$(DOXYGEN_OUTPUT_DIR)/$(HTML_APIDOC_DIR)/" && $(INSTALL) -m 0644 * "$(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML)/"
 
+LOCAL_UNINSTALL += uninstall-apidocs
 uninstall-apidocs:
-	cd "$(DESTDIR)$(docdir)" && rm -f $(DOC_APIDOC_HTML)/*
-	rmdir $(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML)
+	cd "$(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML)" && rm -f *
+	rmdir "$(DESTDIR)$(docdir)/$(DOC_APIDOC_HTML)"
 
+LOCAL_CLEAN += clean-apidocs
 clean-apidocs:
-	rm -rf $(DOXYGEN_OUTPUT_DIR)
-	rm -f $(DOXYGEN_OUTPUT_DIR).stamp
+	rm -rf "$(DOXYGEN_OUTPUT_DIR)/$(HTML_APIDOC_DIR)"
+	rm -f $(HTML_APIDOC_DIR).stamp
 	rm -f $(HTML_APIDOC_DIR).tar.gz
 
+if ENABLE_INTERNAL_DOCS
+
+DOXYGEN_STAMPS += $(HTML_APIDOC_INTERNALS_DIR).stamp
+# FIXME: Depend on source files.
+$(HTML_APIDOC_INTERNALS_DIR).stamp: Doxyfile-internals
+	doxygen Doxyfile-internals
+	echo > $@
 
-# if we ever have more targets, move those out...
+LOCAL_INSTALL += install-apidocs-internals
+install-apidocs-internals: $(HTML_APIDOC_INTERNALS_DIR).stamp
+	$(INSTALL) -m 0755 -d "$(DESTDIR)$(docdir)/$(DOC_APIDOC_INTERNALS_HTML)"
+	cd "$(DOXYGEN_OUTPUT_DIR)/$(HTML_APIDOC_INTERNALS_DIR)" && \
+		$(INSTALL) -m 0644 * "$(DESTDIR)$(docdir)/$(DOC_APIDOC_INTERNALS_HTML)/"
+
+LOCAL_UNINSTALL += uninstall-apidocs-internals
+uninstall-apidocs-internals:
+	cd "$(DESTDIR)$(docdir)/$(DOC_APIDOC_INTERNALS_HTML)" && rm -f *
+	rmdir "$(DESTDIR)$(docdir)/$(DOC_APIDOC_INTERNALS_HTML)"
+
+LOCAL_CLEAN += clean-apidocs-internals
+clean-apidocs-internals:
+	rm -rf "$(DOXYGEN_OUTPUT_DIR)/$(HTML_APIDOC_INTERNALS_DIR)"
+	rm -f $(HTML_APIDOC_INTERNALS_DIR).stamp
+	rm -f $(HTML_APIDOC_INTERNALS_DIR).tar.gz
+
+endif
 
 all-local: $(DOXYGEN_STAMPS)
 
-install-data-local: install-apidocs
+install-data-local: $(LOCAL_INSTALL)
 
-uninstall-local: uninstall-apidocs
+uninstall-local: $(LOCAL_UNINSTALL)
 
-clean-local: clean-apidocs
+clean-local: $(LOCAL_CLEAN)
+	rm -rf $(DOXYGEN_OUTPUT_DIR)
 
-doc_EXTRA_DIST = $(HTML_APIDOC_DIR).tar.gz 
+doc_EXTRA_DIST = $(HTML_APIDOC_DIR).tar.gz
 
-doc_DATA = $(DOXYGEN_FILES) README.apidocs
+doc_DATA = README.apidocs
 
-CLEANFILES = $(DOXYGEN_FILES) $(DOXYGEN_STAMPS)
+CLEANFILES = $(DOXYGEN_STAMPS)
 
 endif