Release-1.2.2-20001015

112 files changed, 45130 insertions, 447 deletions

diff --git a/INSTALL b/INSTALL
index fcc29d6..c9fffeb 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1,6 +1,6 @@
-DOXYGEN Version 1.2.2-20001001
+DOXYGEN Version 1.2.2-20001015
 
 Please read the installation section of the manual for instructions.
 
 --------
-Dimitri van Heesch (01 October 2000)
+Dimitri van Heesch (15 October 2000)
diff --git a/Makefile.in b/Makefile.in
index 95fc3ae..812c91b 100644
--- a/Makefile.in
+++ b/Makefile.in
@@ -1,10 +1,12 @@
 
 all: src/version.cpp configgen doxywizard
+	cd qtools ; $(MAKE)
 	cd src ; $(MAKE)
 
 clean: FORCE
 	cd examples ; $(MAKE) clean
 	cd doc ; $(MAKE) clean
+	cd qtools ; $(MAKE) clean
 	cd src ; $(MAKE) clean
 	cd addon/configgen ; $(MAKE) clean
 	cd addon/doxywizard ; $(MAKE) clean
@@ -13,16 +15,14 @@ clean: FORCE
 	-rm -f objects/*.o
 
 distclean: clean
-	cd examples ; $(MAKE) clean
-	cd doc ; $(MAKE) clean
 	cd src ; $(MAKE) distclean
 	cd addon/configgen ; $(MAKE) distclean
 	cd addon/doxywizard ; $(MAKE) distclean
 	-rm -f bin/doxy*
 	-rm -f html
 	-rm -f objects/*.o
-	-rm -f src/Makefile.doxygen src/Makefile.doxytag src/Makefile.doxysearch
-	-rm -f Makefile src/Makefile examples/Makefile doc/Makefile 
+	-rm -f src/Makefile.doxygen src/Makefile.doxytag src/Makefile.doxysearch qtools/Makefile.qtools
+	-rm -f Makefile qtools/Makefile src/Makefile examples/Makefile doc/Makefile 
 	-rm -f .makeconfig .tmakeconfig
 	-rm -f src/doxygen.pro src/doxytag.pro src/doxysearch.pro
 	-rm -f src/version.cpp
@@ -69,7 +69,7 @@ pdf: docs
 
 archive: clean
 	tar zcvf dx`date +%y%m%d`.tgz addon tmake doc wintools examples bin objects \
-	       src configure configure.bin Makefile.in Makefile.win.in INSTALL \
+	       qtools src configure configure.bin Makefile.in Makefile.win.in INSTALL \
 	       make.bat LANGUAGE.HOWTO LICENSE PLATFORMS VERSION packages
 
 src/version.cpp: Makefile
diff --git a/Makefile.win.in b/Makefile.win.in
index add71f6..4ca50ec 100644
--- a/Makefile.win.in
+++ b/Makefile.win.in
@@ -1,5 +1,8 @@
 all: src\version.cpp
 	set TMAKEPATH=$(TMAKEPATH)
+	cd qtools
+	$(MAKE)
+	cd ..
 	cd src 
 	$(MAKE)
 
diff --git a/README b/README
index 94dbeff..c67bd3b 100644
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-DOXYGEN Version 1.2.2-20001001
+DOXYGEN Version 1.2.2-20001015
 
 Please read INSTALL for compilation instructions.
 
@@ -7,4 +7,4 @@ The latest version of doxygen can be obtained at
 
 Enjoy,
 
-Dimitri van Heesch (01 October 2000)
+Dimitri van Heesch (15 October 2000)
diff --git a/VERSION b/VERSION
index 906cfeb..fdad0e7 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-1.2.2-20001001
+1.2.2-20001015
diff --git a/addon/configgen/configgen.cpp b/addon/configgen/configgen.cpp
index 7a11fc0..c9d5a2d 100644
--- a/addon/configgen/configgen.cpp
+++ b/addon/configgen/configgen.cpp
@@ -1075,6 +1075,14 @@ void init()
                     "tags, which will be replaced by the file and line number from which the \n"
                     "warning originated and the warning text. \n"
                    ); 
+  ConfigString::add("warnLogFile",
+                    "WARN_LOGFILE",
+                    "",
+                    "log file to write warning to",
+                    "The WARN_LOGFILE tag can be used to specify a file to which warning \n"
+                    "and error messages should be written. If left blank the output is written \n"
+                    "to stderr. \n"
+                   );
   //-----------------------------------------------------------------------------------------------
   ConfigInfo::add(  "Input","configuration options related to the input files");
   //-----------------------------------------------------------------------------------------------
@@ -1658,7 +1666,15 @@ void init()
                     100,30000
                 );
   addDependency("maxDotGraphHeight","haveDotFlag");
- 
+  ConfigBool::add(  "generateLegend",
+                    "GENERATE_LEGEND",
+                    "TRUE",
+                    "generate legend page",
+                    "If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will \n"
+                    "generate a legend page explaining the meaning of the various boxes and \n"
+                    "arrows in the dot generated graphs. \n"
+                 );
+  addDependency("generateLegend","haveDotFlag");
 
   //-----------------------------------------------------------------------------------------------
   ConfigInfo::add(  "Search","Configuration::addtions related to the search engine   ");
diff --git a/configure b/configure
index 9649450..9f5021a 100755
--- a/configure
+++ b/configure
@@ -218,27 +218,27 @@ if test "$f_plf_auto" = NO; then
 fi
 
 #- check for qt --------------------------------------------------------------
-
-echo -n "  Checking for Qt..."
-if test -z "$QTDIR"; then
-  echo "QTDIR not set!"
-  echo
-  echo "tmake requires the QTDIR environment variable to be set."
-  echo "check your Qt installation!"
-  exit 2
-else
-  if test ! -d "$QTDIR/lib"; then
-    echo "QTDIR is set, but library directory does not exist!"
-    exit 2
-  fi
-  if test ! -d "$QTDIR/include"; then
-    echo "QTDIR is set, but include directory does not exist!"
-    exit 2
-  fi
-  echo " headers $QTDIR/include,"
-  echo "                     libraries $QTDIR/lib"  
-fi
-  
+# 
+# echo -n "  Checking for Qt..."
+# if test -z "$QTDIR"; then
+#   echo "QTDIR not set!"
+#   echo
+#   echo "tmake requires the QTDIR environment variable to be set."
+#   echo "check your Qt installation!"
+#   exit 2
+# else
+#   if test ! -d "$QTDIR/lib"; then
+#     echo "QTDIR is set, but library directory does not exist!"
+#     exit 2
+#   fi
+#   if test ! -d "$QTDIR/include"; then
+#     echo "QTDIR is set, but include directory does not exist!"
+#     exit 2
+#   fi
+#   echo " headers $QTDIR/include,"
+#   echo "                     libraries $QTDIR/lib"  
+# fi
+#   
 # - check for make ------------------------------------------------------------
 
 echo -n "  Checking for GNU make tool... "
@@ -268,7 +268,7 @@ echo "using $f_make"
 
 # - check for dot ------------------------------------------------------------
 
-echo -n "  Checking for dot... "
+echo -n "  Checking for dot (part of GraphViz)... "
 if test "$f_dot" = NO; then
   dot_dirs="$bin_dirs"
   dot_prog=NO
@@ -374,7 +374,7 @@ TMAKE_CXXFLAGS = -DENGLISH_ONLY
 EOF
 fi
 
-f_inmakefiles="Makefile.in src/Makefile.in examples/Makefile.in doc/Makefile.in addon/configgen/Makefile.in addon/doxywizard/Makefile.in addon/xmlread/Makefile.in"
+f_inmakefiles="Makefile.in qtools/Makefile.in src/Makefile.in examples/Makefile.in doc/Makefile.in addon/configgen/Makefile.in addon/doxywizard/Makefile.in addon/xmlread/Makefile.in"
 
 for i in $f_inmakefiles ; do
      SRC=$i
@@ -404,7 +404,7 @@ EOF
      echo "  Created $DST from $SRC..."
 done
 
-f_inprofiles="src/doxygen.pro.in src/doxytag.pro.in src/doxysearch.pro.in addon/configgen/configgen.pro.in addon/doxywizard/doxywizard.pro.in addon/xmlread/xmlread.pro.in" 
+f_inprofiles="qtools/qtools.pro.in src/doxygen.pro.in src/doxytag.pro.in src/doxysearch.pro.in addon/configgen/configgen.pro.in addon/doxywizard/doxywizard.pro.in addon/xmlread/xmlread.pro.in" 
 
 for i in $f_inprofiles ; do
      SRC=$i
diff --git a/doc/config.doc b/doc/config.doc
index 9b92688..1d3046f 100644
--- a/doc/config.doc
+++ b/doc/config.doc
@@ -103,6 +103,7 @@ followed by the descriptions of the tags grouped by category.
 <li> \refitem cfg_generate_html GENERATE_HTML
 <li> \refitem cfg_generate_htmlhelp GENERATE_HTMLHELP
 <li> \refitem cfg_generate_latex GENERATE_LATEX
+<li> \refitem cfg_generate_legend GENERATE_LEGEND
 <li> \refitem cfg_generate_man GENERATE_MAN
 <li> \refitem cfg_generate_rtf GENERATE_RTF
 <li> \refitem cfg_generate_tagfile GENERATE_TAGFILE
@@ -163,6 +164,7 @@ followed by the descriptions of the tags grouped by category.
 <li> \refitem cfg_verbatim_headers VERBATIM_HEADERS
 <li> \refitem cfg_warn_format WARN_FORMAT
 <li> \refitem cfg_warn_if_undocumented WARN_IF_UNDOCUMENTED
+<li> \refitem cfg_warn_logfile WARN_LOGFILE
 <li> \refitem cfg_warnings WARNINGS
 \htmlonly
 </ul>
@@ -481,12 +483,19 @@ followed by the descriptions of the tags grouped by category.
 \anchor cfg_warn_format
 <dt>\c WARN_FORMAT <dd>
  \addindex WARN_FORMAT
- The WARN_FORMAT tag determines the format of the warning messages that
+ The \c WARN_FORMAT tag determines the format of the warning messages that
  doxygen can produce. The string should contain the <code>\$file</code>, 
  <code>\$line</code>, and <code>\$text</code> 
  tags, which will be replaced by the file and line number from which the
  warning originated and the warning text.
 
+\anchor cfg_warn_logfile
+<dt>\c WARN_LOGFILE <dd>
+ \addindex WARN_LOGFILE
+ The \c WARN_LOGFILE tag can be used to specify a file to which warning
+ and error messages should be written. If left blank the output is written 
+ to stderr.
+
 </dl>
 
 \subsection config_input Input related options
@@ -1061,6 +1070,13 @@ TAGFILES = file1=loc1 "file2 = loc2" ... </pre>
  the specified constraint. Beware that most browsers cannot cope with very
  large images.
 
+\anchor cfg_generate_legend <dd>
+<dt>\c GENERATE_LEGEND <dd>
+ \addindex GENERATE_LEGEND
+ If the \c GENERATE_LEGEND tag is set to \c YES (the default) Doxygen will
+ generate a legend page explaining the meaning of the various boxes and
+ arrows in the dot generated graphs.
+
 </dl>
 \subsection config_search Search engine options
 \anchor cfg_searchengine
diff --git a/doc/install.doc b/doc/install.doc
index 2d31184..3b0c6b2 100644
--- a/doc/install.doc
+++ b/doc/install.doc
@@ -337,7 +337,7 @@ Here is what is required:
     variables (if you did not select to do this automatically during 
     installation).
 <li>Perl 5.0 or higher for Windows. This can be download from:
-    http://www.ActiveState.com/pw32
+    http://www.ActiveState.com/Products/ActivePerl/
 <li>The GNU tools flex, bison and sed.
     To get these working on Windows you should install the 
     <a href="http://sourceware.cygnus.com/cygwin/">cygwin tools</a>
@@ -351,8 +351,8 @@ Here is what is required:
     the directory they are in to the search path.
 
 <li>A professional license of 
-    <A HREF="http://www.trolltech.com/products/qt.html">Qt for Windows</A><br>
-    \latexonly(see {\tt http://www.trolltech.com/products/qt.html})\endlatexonly.
+    <A HREF="http://www.trolltech.com/products/qt.html">Qt for Windows</A>
+    \latexonly\par (see {\tt http://www.trolltech.com/products/qt.html})\endlatexonly.
    
     If you do not have that and you can live without the GUI front-end 
     you can also download Qt-1.44 for X11. Doxygen only the depends on 
diff --git a/doc/starting.doc b/doc/starting.doc
index b518838..70dfc50 100644
--- a/doc/starting.doc
+++ b/doc/starting.doc
@@ -131,7 +131,7 @@ of compiling the generated
 documentation, \c doxygen writes a \c Makefile into the \c latex directory. 
 By typing \c make in the \c latex directory the dvi file \c refman.dvi
 will be generated (provided that you have a make tool called 
-<code>make</code> ofcourse). This file can then be viewed using \c xdvi or 
+<code>make</code> of course). This file can then be viewed using \c xdvi or 
 converted into a postscript file \c refman.ps by 
 typing <code>make ps</code> (this requires <code>dvips</code>).  
 To put 2 pages on one physical page use <code>make ps_2on1</code> instead.
@@ -152,7 +152,7 @@ capabilities of the man page format, so some information
 \subsection step3 Step 3: Documenting the sources
 
 Although documenting the source is presented as step 3, in a new project 
-this should ofcourse be step 1. Here I assume
+this should of course be step 1. Here I assume
 you already have some code and you want doxygen to generate a nice document 
 describing the API and maybe the internals as well.
 
diff --git a/make.bat b/make.bat
deleted file mode 100644