Loading INSTALL +52 −18 Original line number Diff line number Diff line DOXYGEN Version 0.49-990901 DOXYGEN Version 0.49-991003 CONTENTS -------- Loading @@ -8,14 +8,15 @@ CONTENTS * HTML related problems * LaTeX related problems * HP-UX / Digital UNIX problems * gcc 2.7.2.x related problems INSTALLATION INSTRUCTIONS FOR UNIX: ----------------------------------- 1. Unpack the archive, unless you already have: gunzip doxygen-0.49-990901.src.tar.gz # uncompress the archive tar xf doxygen-0.49-990901.src.tar # unpack it gunzip doxygen-0.49-991003.src.tar.gz # uncompress the archive tar xf doxygen-0.49-991003.src.tar # unpack it 2. Run the configure script: Loading @@ -26,6 +27,9 @@ INSTALLATION INSTRUCTIONS FOR UNIX: interpreter. It will report what it finds. Use configure --help to see how to override or change the default or detected settings. If you have downloaded the binary distribution, you can proceed with step 6 now. 3. Compile the program by running make: make Loading @@ -34,14 +38,14 @@ INSTALLATION INSTRUCTIONS FOR UNIX: doxytag, and doxysearch) should be available in the bin directory of the distribution. 5. Generate the user manual (optional, will also be done in step 6). 4. Generate the user manual (optional, will also be done in step 6). make docs to let doxygen generate the HTML and LaTeX documentation. To let doxygen generate the HTML and LaTeX documentation. (you will need the stream editor `sed' for this) make ps 5. make ps to generate a postscript version of the manual. (you will need latex and dvips for this) Loading @@ -58,14 +62,17 @@ INSTALLATION INSTRUCTIONS FOR UNIX: make install Binaries are install to the directory <prefix>/bin Documentation and examples to the directory <prefix>/share/doxygen Binaries are installed in the directory <prefix>/bin Documentation and examples in the directory <prefix>/doc/doxygen <prefix> defaults to /usr but can be changed with the --prefix option of the configure script. INSTALLATION INSTRUCTIONS FOR WINDOWS: -------------------------------------- Currently, only Microsoft Visual C++ (version 5.0) is supported. (For other platforms you may need to edit the perl script in wintools/make.pl (For other compilers you may need to edit the perl script in wintools/make.pl a bit). Let me know what you had to change if you got Doxygen working with another windows compiler. Loading @@ -80,9 +87,10 @@ You will need to install the windows/dos versions of following tools: - Qt-1.xx (Qt-2.xx should also work, but I didn't test it for Windows) (Hint: only the tools section is required, so you can use the free X-windows version as well!) You can get it at http://www.troll.no - Microsoft Visual C++ (I only tested with version 5.0). Use the vcvars32.bat to set the environment variables (if not selected to do this automatically during installation). (if you did not select to do this automatically during installation). - To generate LaTeX documentation or formulas in HTML you need the tools: latex, dvips and gswin32 To get these working under Windows install the fpTeX distribution Loading @@ -96,15 +104,17 @@ You will need to install the windows/dos versions of following tools: `objects' and `bin' manually in the root of the distribution before compiling. Make sure all tools are accessible from the command-line (add them to the PATH environment if needed). Open a dos box. Make sure all tools (i.e. nmake, latex, gswin32, dvips, sed, flex, bison, cl, rm and perl), are accessible from the command-line (add them to the PATH environment variable if needed). Open a dos box, goto the doxygen root dir and type: goto the doxygen root dir and type: make.bat This should build the executables doxygen.exe, doxytag.exe, and doxysearch.exe (The compiler should not produce any warnings or errors). (The compiler should not produce any serious warnings or errors). To build the examples type: Loading @@ -125,8 +135,8 @@ The manual should now be here latex/doxygen_manual.ps KNOWN CONFIGURATION PROBLEMS QT RELATED PROBLEMS: - Qt-2.01 contains a bug that - Qt-2.01 contains a bug that makes some special characters appear as question marks (?) in the HTML output. HTML RELATED PROBLEMS: - the indent continuously increases. Loading Loading @@ -168,7 +178,31 @@ HP-UX / DIGITAL UNIX PROBLEMS: defined (__sparc) || defined (__sgi) || defined (__osf__) #include <alloca.h> This seems to be a problem with bison, but I don't know how to fix it. Alternatively, one could fix the problem at the bison side. Here is patch for bison.simple (provided by Andre Johansen): ------------------------------------------------------------------------------ --- bison.simple~ Tue Nov 18 11:45:53 1997 +++ bison.simple Mon Jan 26 15:10:26 1998 @@ -27,7 +27,7 @@ #ifdef __GNUC__ #define alloca __builtin_alloca #else /* not GNU C. */ -#if (!defined (__STDC__) && defined (sparc)) || defined (__sparc__) || defined (__sparc) || defined (__sgi) +#if (!defined (__STDC__) && defined (sparc)) || defined (__sparc__) || defined (__sparc) || defined (__sgi) || defined (__alpha) #include <alloca.h> #else /* not sparc */ #if defined (MSDOS) && !defined (__TURBOC__) ------------------------------------------------------------------------------ GCC 2.7.2.X PROBLEMS Old versions of the GNU compiler have problems with constant strings containing characters with ascii codes >127. Therefore the compiler will fail to compile some of the translator_xx.h files. A workaround, if you are planning to use the English translation only, is to configure doxygen with the --english-only option. ----------------------------------------------------------------------------- That's it! Loading @@ -180,4 +214,4 @@ The latest version of doxygen can be obtained at Enjoy, Dimitri van Heesch (01 September 1999) Dimitri van Heesch (03 October 1999) Makefile.in +16 −12 Original line number Diff line number Diff line Loading @@ -19,17 +19,18 @@ distclean: clean install: $(INSTTOOL) -d $(INSTALL)/bin $(INSTTOOL) -d $(INSTALL)/share/doxygen/doc $(INSTTOOL) -d $(INSTALL)/share/doxygen/examples $(INSTTOOL) -d $(INSTALL)/doc/doxygen $(INSTTOOL) -d $(INSTALL)/doc/doxygen $(INSTTOOL) -m 755 bin/doxy* $(INSTALL)/bin cp -r doc $(INSTALL)/share/doxygen cp -r examples $(INSTALL)/share/doxygen echo "DOXYGEN = $(INSTALL)" > $(INSTALL)/share/doxygen/doc/Makefile echo "DOXYDOCS = $(INSTALL)/share/doxygen" >> $(INSTALL)/share/doxygen/doc/Makefile echo "VERSION = $(VERSION)" >> $(INSTALL)/share/doxygen/doc/Makefile cat doc/Makefile.in >> $(INSTALL)/share/doxygen/doc/Makefile cd $(INSTALL)/share/doxygen/examples ; $(MAKE) cd $(INSTALL)/share/doxygen/doc ; $(MAKE) cp -r doc $(INSTALL)/doc/doxygen cp -r examples $(INSTALL)/doc/doxygen echo "DOXYGEN = $(INSTALL)" > $(INSTALL)/doc/doxygen/doc/Makefile echo "DOXYDOCS = .." >> $(INSTALL)/doc/doxygen/doc/Makefile echo "VERSION = $(VERSION)" >> $(INSTALL)/doc/doxygen/doc/Makefile cat doc/Makefile.in >> $(INSTALL)/doc/doxygen/doc/Makefile cd $(INSTALL)/doc/doxygen/examples ; $(MAKE) cd $(INSTALL)/doc/doxygen/doc ; $(MAKE) rm -rf $(INSTALL)/doc/doxygen/doc docs: FORCE cd examples ; $(MAKE) Loading @@ -38,10 +39,13 @@ docs: FORCE ps: docs cd latex ; $(MAKE) pdf: docs cd latex ; $(MAKE) archive: distclean tar zcvf dx`date +%y%m%d`.tgz tmake doc wintools examples bin objects \ src configure Makefile.in Makefile.win.in INSTALL make.bat \ LANGUAGE.HOWTO LICENSE PLATFORMS VERSION src configure configure.bin Makefile.in Makefile.win.in INSTALL \ make.bat LANGUAGE.HOWTO LICENSE PLATFORMS VERSION src/version.cpp: Makefile echo "char versionString[]=\"$(VERSION)\";" > src/version.cpp Loading README +2 −2 Original line number Diff line number Diff line DOXYGEN Version 0.49-990901 DOXYGEN Version 0.49-991003 Please read INSTALL for compilation instructions. Loading @@ -7,4 +7,4 @@ The latest version of doxygen can be obtained at Enjoy, Dimitri van Heesch (01 September 1999) Dimitri van Heesch (03 October 1999) VERSION +1 −1 Original line number Diff line number Diff line 0.49-990901 0.49-991003 configure +40 −26 Original line number Diff line number Diff line Loading @@ -21,8 +21,9 @@ f_shared=YES f_make=NO f_perl=NO f_plf_auto=NO f_prefix=/usr/local f_prefix=/usr f_insttool=install f_english=NO while test -n "$1"; do case $1 in Loading @@ -41,6 +42,9 @@ while test -n "$1"; do --debug) f_debug=YES ;; --english-only) f_english=YES ;; --platform) shift; f_platform=$1 ;; Loading Loading @@ -68,12 +72,12 @@ done if test "$f_help" = y; then cat <<EOF Usage: $0 [--help] [--shared] [--static] [--release] [--debug] [--perl name] [--make name] [--platform target] [--prefix] [--install] [--perl name] [--make name] [--platform target] [--prefix dir] [--install name] [--english-only] Options: Options:ll --help Print this message --help Print this help --shared | --static Build using shared or static linking [default: shared] Loading @@ -91,11 +95,13 @@ Options: See PLATFORMS for a list of possibilities --prefix dir Installation prefix directory [default: /usr/local] [default: /usr] --install name name of the GNU install tool --install name Use \`name' as the name of the GNU install tool [default: install] --english-only Include support for English only. EOF test "$f_error" = y && exit 1 exit 0; Loading Loading @@ -196,11 +202,11 @@ if test -z "$QTDIR"; then echo "check your Qt installation!" exit 2 else if ! test -d "$QTDIR/lib"; then 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 if test ! -d "$QTDIR/include"; then echo "QTDIR is set, but include directory does not exist!" exit 2 fi Loading @@ -218,9 +224,11 @@ if test "$f_make" = NO; then for i in $make_names; do for j in $make_dirs; do if test -x "$j/$i"; then if test -n "`$j/$i --version 2>/dev/null | grep GNU`"; then make_prog="$j/$i" break 2 fi fi done done f_make="$make_prog" Loading Loading @@ -281,18 +289,24 @@ RM = rm -f VERSION = `cat VERSION` INSTALL = $f_prefix INSTTOOL = $f_insttool DOXYDOCS = $PWD DOXYDOCS = .. export TMAKEPATH EOF touch .tmakeconfig if test "$f_shared" = NO; then cat > .tmakeconfig <<EOF cat >> .tmakeconfig <<EOF TMAKE_LFLAGS = -static EOF fi if test "$f_english" = YES; then cat >> .tmakeconfig << EOF TMAKE_CXXFLAGS = -DENGLISH_ONLY EOF fi for i in Makefile.in src/Makefile.in examples/Makefile.in doc/Makefile.in ; do SRC=$i DST=`echo $i|sed 's%\(.*\).in$%\1%'` Loading Loading
INSTALL +52 −18 Original line number Diff line number Diff line DOXYGEN Version 0.49-990901 DOXYGEN Version 0.49-991003 CONTENTS -------- Loading @@ -8,14 +8,15 @@ CONTENTS * HTML related problems * LaTeX related problems * HP-UX / Digital UNIX problems * gcc 2.7.2.x related problems INSTALLATION INSTRUCTIONS FOR UNIX: ----------------------------------- 1. Unpack the archive, unless you already have: gunzip doxygen-0.49-990901.src.tar.gz # uncompress the archive tar xf doxygen-0.49-990901.src.tar # unpack it gunzip doxygen-0.49-991003.src.tar.gz # uncompress the archive tar xf doxygen-0.49-991003.src.tar # unpack it 2. Run the configure script: Loading @@ -26,6 +27,9 @@ INSTALLATION INSTRUCTIONS FOR UNIX: interpreter. It will report what it finds. Use configure --help to see how to override or change the default or detected settings. If you have downloaded the binary distribution, you can proceed with step 6 now. 3. Compile the program by running make: make Loading @@ -34,14 +38,14 @@ INSTALLATION INSTRUCTIONS FOR UNIX: doxytag, and doxysearch) should be available in the bin directory of the distribution. 5. Generate the user manual (optional, will also be done in step 6). 4. Generate the user manual (optional, will also be done in step 6). make docs to let doxygen generate the HTML and LaTeX documentation. To let doxygen generate the HTML and LaTeX documentation. (you will need the stream editor `sed' for this) make ps 5. make ps to generate a postscript version of the manual. (you will need latex and dvips for this) Loading @@ -58,14 +62,17 @@ INSTALLATION INSTRUCTIONS FOR UNIX: make install Binaries are install to the directory <prefix>/bin Documentation and examples to the directory <prefix>/share/doxygen Binaries are installed in the directory <prefix>/bin Documentation and examples in the directory <prefix>/doc/doxygen <prefix> defaults to /usr but can be changed with the --prefix option of the configure script. INSTALLATION INSTRUCTIONS FOR WINDOWS: -------------------------------------- Currently, only Microsoft Visual C++ (version 5.0) is supported. (For other platforms you may need to edit the perl script in wintools/make.pl (For other compilers you may need to edit the perl script in wintools/make.pl a bit). Let me know what you had to change if you got Doxygen working with another windows compiler. Loading @@ -80,9 +87,10 @@ You will need to install the windows/dos versions of following tools: - Qt-1.xx (Qt-2.xx should also work, but I didn't test it for Windows) (Hint: only the tools section is required, so you can use the free X-windows version as well!) You can get it at http://www.troll.no - Microsoft Visual C++ (I only tested with version 5.0). Use the vcvars32.bat to set the environment variables (if not selected to do this automatically during installation). (if you did not select to do this automatically during installation). - To generate LaTeX documentation or formulas in HTML you need the tools: latex, dvips and gswin32 To get these working under Windows install the fpTeX distribution Loading @@ -96,15 +104,17 @@ You will need to install the windows/dos versions of following tools: `objects' and `bin' manually in the root of the distribution before compiling. Make sure all tools are accessible from the command-line (add them to the PATH environment if needed). Open a dos box. Make sure all tools (i.e. nmake, latex, gswin32, dvips, sed, flex, bison, cl, rm and perl), are accessible from the command-line (add them to the PATH environment variable if needed). Open a dos box, goto the doxygen root dir and type: goto the doxygen root dir and type: make.bat This should build the executables doxygen.exe, doxytag.exe, and doxysearch.exe (The compiler should not produce any warnings or errors). (The compiler should not produce any serious warnings or errors). To build the examples type: Loading @@ -125,8 +135,8 @@ The manual should now be here latex/doxygen_manual.ps KNOWN CONFIGURATION PROBLEMS QT RELATED PROBLEMS: - Qt-2.01 contains a bug that - Qt-2.01 contains a bug that makes some special characters appear as question marks (?) in the HTML output. HTML RELATED PROBLEMS: - the indent continuously increases. Loading Loading @@ -168,7 +178,31 @@ HP-UX / DIGITAL UNIX PROBLEMS: defined (__sparc) || defined (__sgi) || defined (__osf__) #include <alloca.h> This seems to be a problem with bison, but I don't know how to fix it. Alternatively, one could fix the problem at the bison side. Here is patch for bison.simple (provided by Andre Johansen): ------------------------------------------------------------------------------ --- bison.simple~ Tue Nov 18 11:45:53 1997 +++ bison.simple Mon Jan 26 15:10:26 1998 @@ -27,7 +27,7 @@ #ifdef __GNUC__ #define alloca __builtin_alloca #else /* not GNU C. */ -#if (!defined (__STDC__) && defined (sparc)) || defined (__sparc__) || defined (__sparc) || defined (__sgi) +#if (!defined (__STDC__) && defined (sparc)) || defined (__sparc__) || defined (__sparc) || defined (__sgi) || defined (__alpha) #include <alloca.h> #else /* not sparc */ #if defined (MSDOS) && !defined (__TURBOC__) ------------------------------------------------------------------------------ GCC 2.7.2.X PROBLEMS Old versions of the GNU compiler have problems with constant strings containing characters with ascii codes >127. Therefore the compiler will fail to compile some of the translator_xx.h files. A workaround, if you are planning to use the English translation only, is to configure doxygen with the --english-only option. ----------------------------------------------------------------------------- That's it! Loading @@ -180,4 +214,4 @@ The latest version of doxygen can be obtained at Enjoy, Dimitri van Heesch (01 September 1999) Dimitri van Heesch (03 October 1999)
Makefile.in +16 −12 Original line number Diff line number Diff line Loading @@ -19,17 +19,18 @@ distclean: clean install: $(INSTTOOL) -d $(INSTALL)/bin $(INSTTOOL) -d $(INSTALL)/share/doxygen/doc $(INSTTOOL) -d $(INSTALL)/share/doxygen/examples $(INSTTOOL) -d $(INSTALL)/doc/doxygen $(INSTTOOL) -d $(INSTALL)/doc/doxygen $(INSTTOOL) -m 755 bin/doxy* $(INSTALL)/bin cp -r doc $(INSTALL)/share/doxygen cp -r examples $(INSTALL)/share/doxygen echo "DOXYGEN = $(INSTALL)" > $(INSTALL)/share/doxygen/doc/Makefile echo "DOXYDOCS = $(INSTALL)/share/doxygen" >> $(INSTALL)/share/doxygen/doc/Makefile echo "VERSION = $(VERSION)" >> $(INSTALL)/share/doxygen/doc/Makefile cat doc/Makefile.in >> $(INSTALL)/share/doxygen/doc/Makefile cd $(INSTALL)/share/doxygen/examples ; $(MAKE) cd $(INSTALL)/share/doxygen/doc ; $(MAKE) cp -r doc $(INSTALL)/doc/doxygen cp -r examples $(INSTALL)/doc/doxygen echo "DOXYGEN = $(INSTALL)" > $(INSTALL)/doc/doxygen/doc/Makefile echo "DOXYDOCS = .." >> $(INSTALL)/doc/doxygen/doc/Makefile echo "VERSION = $(VERSION)" >> $(INSTALL)/doc/doxygen/doc/Makefile cat doc/Makefile.in >> $(INSTALL)/doc/doxygen/doc/Makefile cd $(INSTALL)/doc/doxygen/examples ; $(MAKE) cd $(INSTALL)/doc/doxygen/doc ; $(MAKE) rm -rf $(INSTALL)/doc/doxygen/doc docs: FORCE cd examples ; $(MAKE) Loading @@ -38,10 +39,13 @@ docs: FORCE ps: docs cd latex ; $(MAKE) pdf: docs cd latex ; $(MAKE) archive: distclean tar zcvf dx`date +%y%m%d`.tgz tmake doc wintools examples bin objects \ src configure Makefile.in Makefile.win.in INSTALL make.bat \ LANGUAGE.HOWTO LICENSE PLATFORMS VERSION src configure configure.bin Makefile.in Makefile.win.in INSTALL \ make.bat LANGUAGE.HOWTO LICENSE PLATFORMS VERSION src/version.cpp: Makefile echo "char versionString[]=\"$(VERSION)\";" > src/version.cpp Loading
README +2 −2 Original line number Diff line number Diff line DOXYGEN Version 0.49-990901 DOXYGEN Version 0.49-991003 Please read INSTALL for compilation instructions. Loading @@ -7,4 +7,4 @@ The latest version of doxygen can be obtained at Enjoy, Dimitri van Heesch (01 September 1999) Dimitri van Heesch (03 October 1999)
configure +40 −26 Original line number Diff line number Diff line Loading @@ -21,8 +21,9 @@ f_shared=YES f_make=NO f_perl=NO f_plf_auto=NO f_prefix=/usr/local f_prefix=/usr f_insttool=install f_english=NO while test -n "$1"; do case $1 in Loading @@ -41,6 +42,9 @@ while test -n "$1"; do --debug) f_debug=YES ;; --english-only) f_english=YES ;; --platform) shift; f_platform=$1 ;; Loading Loading @@ -68,12 +72,12 @@ done if test "$f_help" = y; then cat <<EOF Usage: $0 [--help] [--shared] [--static] [--release] [--debug] [--perl name] [--make name] [--platform target] [--prefix] [--install] [--perl name] [--make name] [--platform target] [--prefix dir] [--install name] [--english-only] Options: Options:ll --help Print this message --help Print this help --shared | --static Build using shared or static linking [default: shared] Loading @@ -91,11 +95,13 @@ Options: See PLATFORMS for a list of possibilities --prefix dir Installation prefix directory [default: /usr/local] [default: /usr] --install name name of the GNU install tool --install name Use \`name' as the name of the GNU install tool [default: install] --english-only Include support for English only. EOF test "$f_error" = y && exit 1 exit 0; Loading Loading @@ -196,11 +202,11 @@ if test -z "$QTDIR"; then echo "check your Qt installation!" exit 2 else if ! test -d "$QTDIR/lib"; then 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 if test ! -d "$QTDIR/include"; then echo "QTDIR is set, but include directory does not exist!" exit 2 fi Loading @@ -218,9 +224,11 @@ if test "$f_make" = NO; then for i in $make_names; do for j in $make_dirs; do if test -x "$j/$i"; then if test -n "`$j/$i --version 2>/dev/null | grep GNU`"; then make_prog="$j/$i" break 2 fi fi done done f_make="$make_prog" Loading Loading @@ -281,18 +289,24 @@ RM = rm -f VERSION = `cat VERSION` INSTALL = $f_prefix INSTTOOL = $f_insttool DOXYDOCS = $PWD DOXYDOCS = .. export TMAKEPATH EOF touch .tmakeconfig if test "$f_shared" = NO; then cat > .tmakeconfig <<EOF cat >> .tmakeconfig <<EOF TMAKE_LFLAGS = -static EOF fi if test "$f_english" = YES; then cat >> .tmakeconfig << EOF TMAKE_CXXFLAGS = -DENGLISH_ONLY EOF fi for i in Makefile.in src/Makefile.in examples/Makefile.in doc/Makefile.in ; do SRC=$i DST=`echo $i|sed 's%\(.*\).in$%\1%'` Loading
