Commit a54eecdf authored by Dimitri van Heesch's avatar Dimitri van Heesch
Browse files

mods for doxygen-0.49-991003

parent 1d4e23de
Loading
Loading
Loading
Loading
+52 −18
Original line number Original line Diff line number Diff line
DOXYGEN Version 0.49-990901
DOXYGEN Version 0.49-991003


CONTENTS
CONTENTS
--------
--------
@@ -8,14 +8,15 @@ CONTENTS
      * HTML related problems
      * HTML related problems
      * LaTeX related problems
      * LaTeX related problems
      * HP-UX / Digital UNIX problems
      * HP-UX / Digital UNIX problems
      * gcc 2.7.2.x related problems


INSTALLATION INSTRUCTIONS FOR UNIX:
INSTALLATION INSTRUCTIONS FOR UNIX:
-----------------------------------
-----------------------------------


1.  Unpack the archive, unless you already have:
1.  Unpack the archive, unless you already have:
   
   
     gunzip doxygen-0.49-990901.src.tar.gz    # uncompress the archive
     gunzip doxygen-0.49-991003.src.tar.gz    # uncompress the archive
     tar xf doxygen-0.49-990901.src.tar       # unpack it
     tar xf doxygen-0.49-991003.src.tar       # unpack it


2.  Run the configure script:
2.  Run the configure script:
 
 
@@ -26,6 +27,9 @@ INSTALLATION INSTRUCTIONS FOR UNIX:
    interpreter. It will report what it finds. Use configure --help 
    interpreter. It will report what it finds. Use configure --help 
    to see how to override or change the default or detected settings.
    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:
3.  Compile the program by running make:


     make
     make
@@ -34,14 +38,14 @@ INSTALLATION INSTRUCTIONS FOR UNIX:
    doxytag, and doxysearch) should be available in the bin directory of the 
    doxytag, and doxysearch) should be available in the bin directory of the 
    distribution.
    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
     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)
    (you will need the stream editor `sed' for this)


     make ps
5.   make ps


    to generate a postscript version of the manual. 
    to generate a postscript version of the manual. 
    (you will need latex and dvips for this)
    (you will need latex and dvips for this)
@@ -58,14 +62,17 @@ INSTALLATION INSTRUCTIONS FOR UNIX:


     make install
     make install


    Binaries are install to the directory <prefix>/bin 
    Binaries are installed in the directory <prefix>/bin 
    Documentation and examples to the directory <prefix>/share/doxygen
    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:
INSTALLATION INSTRUCTIONS FOR WINDOWS:
--------------------------------------
--------------------------------------


Currently, only Microsoft Visual C++ (version 5.0) is supported. 
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 
a bit). Let me know what you had to change if you got Doxygen working with 
another windows compiler. 
another windows compiler. 


@@ -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) 
- 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 
  (Hint: only the tools section is required, so you can use the free 
   X-windows version as well!)
   X-windows version as well!)
  You can get it at http://www.troll.no
- Microsoft Visual C++ (I only tested with version 5.0).
- Microsoft Visual C++ (I only tested with version 5.0).
  Use the vcvars32.bat to set the environment variables 
  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: 
- To generate LaTeX documentation or formulas in HTML you need the tools: 
  latex, dvips and gswin32 
  latex, dvips and gswin32 
  To get these working under Windows install the fpTeX distribution
  To get these working under Windows install the fpTeX distribution
@@ -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 
  `objects' and `bin' manually in the root of the distribution before 
  compiling.
  compiling.


Make sure all tools are accessible from the command-line (add them to the
Open a dos box.
PATH environment if needed).
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
make.bat


This should build the executables doxygen.exe, doxytag.exe, and doxysearch.exe
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:
To build the examples type:


@@ -125,8 +135,8 @@ The manual should now be here latex/doxygen_manual.ps
KNOWN CONFIGURATION PROBLEMS
KNOWN CONFIGURATION PROBLEMS


QT RELATED 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:
HTML RELATED PROBLEMS:
- the indent continuously increases.
- the indent continuously increases.
@@ -168,7 +178,31 @@ HP-UX / DIGITAL UNIX PROBLEMS:
    defined (__sparc) || defined (__sgi) || defined (__osf__)
    defined (__sparc) || defined (__sgi) || defined (__osf__)
    #include <alloca.h>
    #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!
That's it!
@@ -180,4 +214,4 @@ The latest version of doxygen can be obtained at


Enjoy,
Enjoy,


Dimitri van Heesch (01 September 1999)
Dimitri van Heesch (03 October 1999)
+16 −12
Original line number Original line Diff line number Diff line
@@ -19,17 +19,18 @@ distclean: clean


install:
install:
	$(INSTTOOL) -d $(INSTALL)/bin
	$(INSTTOOL) -d $(INSTALL)/bin
	$(INSTTOOL) -d $(INSTALL)/share/doxygen/doc
	$(INSTTOOL) -d $(INSTALL)/doc/doxygen
	$(INSTTOOL) -d $(INSTALL)/share/doxygen/examples
	$(INSTTOOL) -d $(INSTALL)/doc/doxygen
	$(INSTTOOL) -m 755 bin/doxy* $(INSTALL)/bin
	$(INSTTOOL) -m 755 bin/doxy* $(INSTALL)/bin
	cp -r doc $(INSTALL)/share/doxygen
	cp -r doc $(INSTALL)/doc/doxygen
	cp -r examples $(INSTALL)/share/doxygen
	cp -r examples $(INSTALL)/doc/doxygen
	echo "DOXYGEN  = $(INSTALL)" > $(INSTALL)/share/doxygen/doc/Makefile
	echo "DOXYGEN  = $(INSTALL)" > $(INSTALL)/doc/doxygen/doc/Makefile
	echo "DOXYDOCS = $(INSTALL)/share/doxygen" >> $(INSTALL)/share/doxygen/doc/Makefile
	echo "DOXYDOCS = .." >> $(INSTALL)/doc/doxygen/doc/Makefile
	echo "VERSION  = $(VERSION)" >> $(INSTALL)/share/doxygen/doc/Makefile
	echo "VERSION  = $(VERSION)" >> $(INSTALL)/doc/doxygen/doc/Makefile
	cat doc/Makefile.in >> $(INSTALL)/share/doxygen/doc/Makefile
	cat doc/Makefile.in >> $(INSTALL)/doc/doxygen/doc/Makefile
	cd $(INSTALL)/share/doxygen/examples ; $(MAKE)
	cd $(INSTALL)/doc/doxygen/examples ; $(MAKE)
	cd $(INSTALL)/share/doxygen/doc ; $(MAKE)
	cd $(INSTALL)/doc/doxygen/doc ; $(MAKE)
	rm -rf $(INSTALL)/doc/doxygen/doc


docs: FORCE
docs: FORCE
	cd examples ; $(MAKE)
	cd examples ; $(MAKE)
@@ -38,10 +39,13 @@ docs: FORCE
ps: docs
ps: docs
	cd latex ; $(MAKE)
	cd latex ; $(MAKE)


pdf: docs
	cd latex ; $(MAKE)

archive: distclean
archive: distclean
	tar zcvf dx`date +%y%m%d`.tgz tmake doc wintools examples bin objects \
	tar zcvf dx`date +%y%m%d`.tgz tmake doc wintools examples bin objects \
	       src configure Makefile.in Makefile.win.in INSTALL make.bat \
	       src configure configure.bin Makefile.in Makefile.win.in INSTALL \
	       LANGUAGE.HOWTO LICENSE PLATFORMS VERSION
	       make.bat LANGUAGE.HOWTO LICENSE PLATFORMS VERSION


src/version.cpp: Makefile
src/version.cpp: Makefile
	echo "char versionString[]=\"$(VERSION)\";" > src/version.cpp
	echo "char versionString[]=\"$(VERSION)\";" > src/version.cpp
+2 −2
Original line number Original line Diff line number Diff line
DOXYGEN Version 0.49-990901
DOXYGEN Version 0.49-991003


Please read INSTALL for compilation instructions.
Please read INSTALL for compilation instructions.


@@ -7,4 +7,4 @@ The latest version of doxygen can be obtained at


Enjoy,
Enjoy,


Dimitri van Heesch (01 September 1999)
Dimitri van Heesch (03 October 1999)
+1 −1
Original line number Original line Diff line number Diff line
0.49-990901
0.49-991003
+40 −26
Original line number Original line Diff line number Diff line
@@ -21,8 +21,9 @@ f_shared=YES
f_make=NO
f_make=NO
f_perl=NO
f_perl=NO
f_plf_auto=NO
f_plf_auto=NO
f_prefix=/usr/local
f_prefix=/usr
f_insttool=install
f_insttool=install
f_english=NO


while test -n "$1";  do
while test -n "$1";  do
  case $1 in
  case $1 in
@@ -41,6 +42,9 @@ while test -n "$1"; do
    --debug)
    --debug)
       f_debug=YES
       f_debug=YES
       ;;
       ;;
    --english-only)
       f_english=YES
       ;;
    --platform)
    --platform)
       shift; f_platform=$1
       shift; f_platform=$1
       ;;
       ;;
@@ -68,12 +72,12 @@ done
if test "$f_help" = y; then
if test "$f_help" = y; then
  cat <<EOF
  cat <<EOF
Usage: $0 [--help] [--shared] [--static] [--release] [--debug] 
Usage: $0 [--help] [--shared] [--static] [--release] [--debug] 
          [--perl name] [--make name] [--platform target] [--prefix]
          [--perl name] [--make name] [--platform target] [--prefix dir]
          [--install]
          [--install name] [--english-only]


Options: 
Options:ll 


  --help              Print this message
  --help                Print this help


  --shared | --static   Build using shared or static linking
  --shared | --static   Build using shared or static linking
		        [default: shared]
		        [default: shared]
@@ -91,11 +95,13 @@ Options:
                        See PLATFORMS for a list of possibilities
                        See PLATFORMS for a list of possibilities


  --prefix dir          Installation prefix directory
  --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]
                        [default: install]


  --english-only        Include support for English only.

EOF
EOF
  test "$f_error" = y && exit 1
  test "$f_error" = y && exit 1
  exit 0;
  exit 0;
@@ -196,11 +202,11 @@ if test -z "$QTDIR"; then
  echo "check your Qt installation!"
  echo "check your Qt installation!"
  exit 2
  exit 2
else
else
  if ! test -d "$QTDIR/lib"; then
  if test ! -d "$QTDIR/lib"; then
    echo "QTDIR is set, but library directory does not exist!"
    echo "QTDIR is set, but library directory does not exist!"
    exit 2
    exit 2
  fi
  fi
  if ! test -d "$QTDIR/include"; then
  if test ! -d "$QTDIR/include"; then
    echo "QTDIR is set, but include directory does not exist!"
    echo "QTDIR is set, but include directory does not exist!"
    exit 2
    exit 2
  fi
  fi
@@ -218,9 +224,11 @@ if test "$f_make" = NO; then
  for i in $make_names; do
  for i in $make_names; do
    for j in $make_dirs; do
    for j in $make_dirs; do
      if test -x "$j/$i"; then
      if test -x "$j/$i"; then
        if test -n "`$j/$i --version 2>/dev/null | grep GNU`"; then
          make_prog="$j/$i"
          make_prog="$j/$i"
          break 2
          break 2
        fi
        fi
      fi
    done
    done
  done
  done
  f_make="$make_prog" 
  f_make="$make_prog" 
@@ -281,18 +289,24 @@ RM = rm -f
VERSION   = `cat VERSION`
VERSION   = `cat VERSION`
INSTALL   = $f_prefix
INSTALL   = $f_prefix
INSTTOOL  = $f_insttool
INSTTOOL  = $f_insttool
DOXYDOCS  = $PWD
DOXYDOCS  = ..


export TMAKEPATH
export TMAKEPATH
EOF
EOF


touch .tmakeconfig
touch .tmakeconfig
if test "$f_shared" = NO; then
if test "$f_shared" = NO; then
cat > .tmakeconfig <<EOF
  cat >> .tmakeconfig <<EOF
TMAKE_LFLAGS = -static
TMAKE_LFLAGS = -static
EOF
EOF
fi
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
for i in Makefile.in src/Makefile.in examples/Makefile.in doc/Makefile.in ; do
     SRC=$i
     SRC=$i
     DST=`echo $i|sed 's%\(.*\).in$%\1%'`
     DST=`echo $i|sed 's%\(.*\).in$%\1%'`
Loading