From: Russ Allbery <rra@debian.org>
Date: Sun, 24 Jul 2011 22:40:19 +0000 (-0700)
Subject: Fix generation of Doxygen protocol documentation
X-Git-Tag: debian/1.6.0.pre7-2~1
X-Git-Url: https://git.michaelhowe.org/gitweb/?a=commitdiff_plain;h=d55bf2bd393f3d956541d0d8a30925bc804eac9b;p=packages%2Fo%2Fopenafs.git

Fix generation of Doxygen protocol documentation

* Fix generation of protocol documentation from Doxygen headers.
  Doxygen cannot be called directly on header files and needs a
  configuration file to be generated first.  Thanks, Anders Kaseorg.
---

diff --git a/debian/changelog b/debian/changelog
index 79bb87d7a..ccbecbf30 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,9 @@ openafs (1.6.0~pre7-2) UNRELEASED; urgency=low
   * Force use of dblatex to build the manual, even if docbook2pdf is
     available, since the latter dies with errors about TeX capacity.
     (Closes: #635306)
+  * Fix generation of protocol documentation from Doxygen headers.
+    Doxygen cannot be called directly on header files and needs a
+    configuration file to be generated first.  Thanks, Anders Kaseorg.
   * Add another dummy rule for ./debian/rules to the kernel module rules
     file to fix another variation of make-kpkg breakage.
 
diff --git a/debian/rules b/debian/rules
index c46540b52..0109fc378 100755
--- a/debian/rules
+++ b/debian/rules
@@ -164,8 +164,9 @@ override_dh_install:
 	set -e; for h in doc/protocol/*.h ; do \
 	    mkdir $(DOCS)/html/`basename $$h .h` ; \
 	    cp $$h $(DOCS)/html/`basename $$h .h` ; \
-	    cd $(DOCS)/html/`basename $$h .h` && doxygen *.h && rm *.h \
-		&& mv html/* . && rm -r latex html && cd $(CURDIR) ; \
+	    cd $(DOCS)/html/`basename $$h .h` && doxygen -g && doxygen \
+		&& rm *.h && mv html/* . && rm -r latex html \
+		&& cd $(CURDIR) ; \
 	done
 
 	install -d debian/$(srcpkg)/usr/src/modules/$(package)