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 79bb87d7a585f237dda841fda681bf0281549d11..ccbecbf3076848fdd38add2520d16f0870b3b09c 100644 (file)
--- 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 c46540b52574fc013a55e1214fcbe8c01ee5dc02..0109fc3781291798a43d7fc753ca48c74fb151d4 100755 (executable)
--- 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)