]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Only one entry point into the documentation, instead of base, lac, and all.
authorWolfgang Bangerth <bangerth@math.tamu.edu>
Fri, 13 Jan 2006 23:11:43 +0000 (23:11 +0000)
committerWolfgang Bangerth <bangerth@math.tamu.edu>
Fri, 13 Jan 2006 23:11:43 +0000 (23:11 +0000)
git-svn-id: https://svn.dealii.org/trunk@12017 0785d39b-7218-0410-832d-ea1e28bc413d

deal.II/doc/doxygen/Makefile.in
deal.II/doc/doxygen/deal.dox

index 9f488d0af0256af5337b776b7c164d235c385570..ae4373b8f4d672798e8e86631ffb5d80d3b1ebd9 100644 (file)
@@ -17,15 +17,18 @@ private:
        perl -pi -e 's/(EXTRACT_PRIVATE\s*=\s*)NO/$$1YES/;s/(INTERNAL_DOCS\s*=\s*)NO/$$1YES/;' options.dox
        $(MAKE) html
 
-%.tag: %.dox
-       @DOXYGEN@ $<
+# generate documentation. write the output to a file so as not to hide the
+# important message to impatient observers that this process can take quite
+# a while
+deal.tag: deal.dox \
+         $D/base/include/*/*.h \
+         $D/lac/include/*/*.h \
+         $D/deal.II/include/*/*.h \
+         headers/*.h
+       @echo "=== Generating reference documentation. " \
+              "This can take several minutes..."
+       @DOXYGEN@ deal.dox > doxygen.log
 
-base.tag: @prefix@/base/include/*/*.h headers/base/*.h
-lac.tag:  base.tag @prefix@/lac/include/*/*.h headers/lac/*.h
-deal.tag: lac.tag  @prefix@/deal.II/include/*/*.h headers/deal.II/*.h
-
-base:    base.tag
-lac:     lac.tag
 deal.II: deal.tag
 
 # validate cross references. there are so many html files in these
@@ -33,20 +36,18 @@ deal.II: deal.tag
 #    $(PERL) $D/common/scripts/validate-xrefs.pl deal.II/*.html
 # as this leads to error messages of the kind "/usr/bin/perl: Argument 
 # list too long". Instead, use a loop over all html files
-validate-xrefs-%:
-       @echo --- Validating xrefs in $(@:validate-xrefs-%=%)/ ---
-       cd $(@:validate-xrefs-%=%) ; \
+validate-xrefs:
+       @echo --- Validating xrefs in doxygen/deal.II/ ---
+       @cd deal.II ; \
                for i in *.html ; do \
-                       $(PERL) $D/common/scripts/validate-xrefs.pl $i ; \
+                       $(PERL) $D/common/scripts/validate-xrefs.pl $$i ; \
                done
 
-validate-xrefs: validate-xrefs-base \
-                validate-xrefs-lac  \
-                validate-xrefs-deal.II
-
+# we have so many files that we can't just do "rm deal.II/*" because that
+# leads to overlong command lines. gotta split it up
+clean:
+       for i in {base,lac,deal.II}/* ; do rm $$i ; done
+       rm *.tag
 
-.PHONY: html private base lac deal.II \
-       validate-xrefs \
-       validate-xrefs-base \
-        validate-xrefs-lac  \
-        validate-xrefs-deal.II
+.PHONY: html private deal.II \
+       validate-xrefs clean
index 5639e1134bafd3520027d2a15bec7899400e952c..a57e32c72fb8bf395057cfaa0e1a404c928478a3 100644 (file)
@@ -2,7 +2,7 @@
 
 PROJECT_NAME = "deal.II library"
 
-INPUT    = headers/base/ headers/lac/ headers/deal.II/ \
+INPUT    = headers/ \
        ../../base/include/base \
        ../../lac/include/lac \
        ../../deal.II/include/dofs \

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.