reworked doxygen documentation

This is a legacy commit from before 2015-03-01.
It may be incomplete as well as inconsistent.
See COPYING.legacy and README.history for details.


SVN Path:     http://gpitrsvn.gpi.uni-karlsruhe.de/repos/TFSoftware/trunk
SVN Revision: 3413
SVN UUID:     67feda4a-a26e-11df-9d6e-31afc202ad0c

src/Makefile.buildingblocks

@@ -106,7 +106,8 @@ $(call CHECKVARS,TF_BROWSER TF_WWWBASEDIR)
 
 # comment stripping
 # -----------------
-$(call CHECKVARS,REMCMMNT EMPTYPRINT)
+EMPTYPRINT=0
+$(call CHECKVARS,TF_REMCMMNT EMPTYPRINT)
 
 # awk rule assumes that the first non-comment line starts with '#'
 # and that the first (copyright) comment end with pattern "^ */"
@@ -114,7 +115,7 @@ $(call CHECKVARS,REMCMMNT EMPTYPRINT)
 	awk 'BEGIN {hot=1;} /^ \*\// { if (hot) { hot=2; print; next;} }\
         /^#/ { hot=0; } \
         { if (hot==2) { print ""; } else if (hot) { print; } }' $< > $@
-	$(REMCMMNT) $< | awk 'BEGIN {hot=0;} \
+	$(TF_REMCMMNT) $< | awk 'BEGIN {hot=0;} \
         /^ *$$/ { if ((hot) && ($(EMPTYPRINT))) { print ""; } next; } \
         /^#/ { hot=1; } { if (hot) print; }' >> $@
 
@@ -183,6 +184,9 @@ PWD=$(shell env pwd)
 doxydoc.xxx: doxydoc.cfg
 	sed 's,<OUTPUTDIRECTORY>,$(DOXYWWWPATH),g;s,<STRIPFROMPATH>,$(PWD),g' \
 	  $< > $@
+# create commented version of doxygen configuration
+doxycomm.xxx: doxydoc.cfg
+	/bin/cp -vf $< $@; doxygen -u $@
 
 $(DOXYWWWPATH)/html/index.html: doxydoc.xxx $(DOXYSRC)
 	mkdir -vp $(DOXYWWWPATH)

src/libs/libaff/Makefile

@@ -266,6 +266,9 @@ PWD=$(shell env pwd)
 doxydoc.xxx: doxydoc.cfg
 	sed 's,<OUTPUTDIRECTORY>,$(DOXYWWWPATH),g;s,<STRIPFROMPATH>,$(PWD),g' \
 	  $< > $@
+# create commented version of doxygen configuration
+doxycomm.xxx: doxydoc.cfg
+	/bin/cp -vf $< $@; doxygen -u $@
 
 $(DOXYWWWPATH)/html/index.html: doxydoc.xxx $(DOXYSRC)
 	mkdir -vp $(DOXYWWWPATH)

src/libs/libdatreadxx/Makefile

@@ -187,6 +187,9 @@ PWD=$(shell env pwd)
 doxydoc.xxx: doxydoc.cfg
 	sed 's,<OUTPUTDIRECTORY>,$(DOXYWWWPATH),g;s,<STRIPFROMPATH>,$(PWD),g' \
 	  $< > $@
+# create commented version of doxygen configuration
+doxycomm.xxx: doxydoc.cfg
+	/bin/cp -vf $< $@; doxygen -u $@
 
 $(DOXYWWWPATH)/html/index.html: doxydoc.xxx $(DOXYSRC)
 	mkdir -vp $(DOXYWWWPATH)

src/libs/libdatwritexx/Makefile

@@ -191,6 +191,9 @@ PWD=$(shell env pwd)
 doxydoc.xxx: doxydoc.cfg
 	sed 's,<OUTPUTDIRECTORY>,$(DOXYWWWPATH),g;s,<STRIPFROMPATH>,$(PWD),g' \
 	  $< > $@
+# create commented version of doxygen configuration
+doxycomm.xxx: doxydoc.cfg
+	/bin/cp -vf $< $@; doxygen -u $@
 
 $(DOXYWWWPATH)/html/index.html: doxydoc.xxx $(DOXYSRC)
 	mkdir -vp $(DOXYWWWPATH)

src/libs/libfapidxx/Makefile

@@ -158,6 +158,9 @@ PWD=$(shell env pwd)
 doxydoc.xxx: doxydoc.cfg
 	sed 's,<OUTPUTDIRECTORY>,$(DOXYWWWPATH),g;s,<STRIPFROMPATH>,$(PWD),g' \
 	  $< > $@
+# create commented version of doxygen configuration
+doxycomm.xxx: doxydoc.cfg
+	/bin/cp -vf $< $@; doxygen -u $@
 
 $(DOXYWWWPATH)/html/index.html: doxydoc.xxx $(DOXYSRC)
 	mkdir -vp $(DOXYWWWPATH)

src/libs/libfourier/Makefile

@@ -278,6 +278,9 @@ PWD=$(shell env pwd)
 doxydoc.xxx: doxydoc.cfg
 	sed 's,<OUTPUTDIRECTORY>,$(DOXYWWWPATH),g;s,<STRIPFROMPATH>,$(PWD),g' \
 	  $< > $@
+# create commented version of doxygen configuration
+doxycomm.xxx: doxydoc.cfg
+	/bin/cp -vf $< $@; doxygen -u $@
 
 $(DOXYWWWPATH)/html/index.html: doxydoc.xxx $(DOXYSRC)
 	mkdir -vp $(DOXYWWWPATH)

src/libs/libgsexx/Makefile

@@ -158,6 +158,9 @@ PWD=$(shell env pwd)
 doxydoc.xxx: doxydoc.cfg
 	sed 's,<OUTPUTDIRECTORY>,$(DOXYWWWPATH),g;s,<STRIPFROMPATH>,$(PWD),g' \
 	  $< > $@
+# create commented version of doxygen configuration
+doxycomm.xxx: doxydoc.cfg
+	/bin/cp -vf $< $@; doxygen -u $@
 
 $(DOXYWWWPATH)/html/index.html: doxydoc.xxx $(DOXYSRC)
 	mkdir -vp $(DOXYWWWPATH)

src/libs/liblinearxx/Makefile

@@ -178,6 +178,9 @@ PWD=$(shell env pwd)
 doxydoc.xxx: doxydoc.cfg
 	sed 's,<OUTPUTDIRECTORY>,$(DOXYWWWPATH),g;s,<STRIPFROMPATH>,$(PWD),g' \
 	  $< > $@
+# create commented version of doxygen configuration
+doxycomm.xxx: doxydoc.cfg
+	/bin/cp -vf $< $@; doxygen -u $@
 
 $(DOXYWWWPATH)/html/index.html: doxydoc.xxx $(DOXYSRC)
 	mkdir -vp $(DOXYWWWPATH)

src/libs/libpgplot++/Makefile

@@ -202,6 +202,9 @@ PWD=$(shell env pwd)
 doxydoc.xxx: doxydoc.cfg
 	sed 's,<OUTPUTDIRECTORY>,$(DOXYWWWPATH),g;s,<STRIPFROMPATH>,$(PWD),g' \
 	  $< > $@
+# create commented version of doxygen configuration
+doxycomm.xxx: doxydoc.cfg
+	/bin/cp -vf $< $@; doxygen -u $@
 
 $(DOXYWWWPATH)/html/index.html: doxydoc.xxx $(DOXYSRC)
 	mkdir -vp $(DOXYWWWPATH)