doxygen

Compilation

Seems to require gmake. Optionally uses the GraphViz tool and Qt.

V1.8.3

          # AIX 6.1/7.1, xlC 9.0/12.1
configure --prefix /tmp/doxygen-1.8.3.1 --platform aix-xlc --make /bio/local/../61/gmake-3.81/bin/make --install "/usr/bin/installbsd -c -g biodev" --static --flex lex --bison yacc
configure --prefix /tmp/doxygen-1.8.3.1 --platform aix-xlc --make /nfs/local/71/gmake-3.82/bin/make    --install "/usr/bin/installbsd -c -g biodev" --static            --bison yacc

make[2]: Entering directory `/u/biodev/doxygen-1.8.3.1/src'
lex -PconfigYY -t config.l >config.cpp 
591: Warning: 1285-341 Start condition * is not defined.
608: Error: 1285-310 The string does not end.

make[1]: Entering directory `/u/biodev/doxygen-1.8.4/src'
/bio/local/bin/flex -PconfigYY -t config.l >config.cpp 
make[1]: *** [config.cpp] Segmentation fault (core dumped)

V1.7.6

          # AIX 6.1/7.1, xlC 9.0/12.1
configure --prefix /tmp/doxygen-1.7.6 --platform aix-xlc --make /bio/local/../61/gmake-3.81/bin/make --install "/usr/bin/installbsd -c -g biodev" --static --flex lex --bison yacc

make 
make install
make install_docs

V1.7.4

AIX 5.3

The build procedure is not quite adapted.
Modifications:

To avoid

"index.cpp", line 3083.20: 1540-0274 (S) The name lookup for "fixSpaces" did not find a declaration.

in src/index.cpp

/*static*/ QCString fixSpaces(const QCString &s)

in configure, section on make .tmakeconfig, add a branch
```
  elif test "$f_platform" = "aix-xlc"; then
  cat >> .tmakeconfig <<EOF
EOF
```
to allow proper static linking
In ./addon/doxywizard/Makefile.in, ./Makefile.in change
```
$(INSTTOOL) -d
# to
mkdir -p
```

Then

       # specify a "real" group, '-g biodev', to allow non-root installation
configure --static --flex lex --bison yacc --make /nfs/bio/local.AIX/53/gmake-3.81/bin/make --install "/usr/bin/installbsd -c -g biodev" --prefix /tmp/doxygen-1.7.4
make
make install

V1.4.7

The build runs best with Gnu make, specified at the configure command line. Without gmake, one would have to post-edit all Makefiles:

   nedit `find ./ -name Makefile.*`
 
# then change
   make -C ...
# to
   cd ...; make

AIX 5.1 (VAC 6)

Configure with:

configure --static --make make --install /usr/bin/install --prefix /tmp/doxygen-1.4.7

Strangely, in src/Makefile.libdoxycfg the native utilities have to be re-enabled:

LEX     =   lex
YACC    =   yacc

In src/Makefile.doxygen

LFLAGS	=

Run make. Be patient, some files (language.cpp) may need a looong time to compile.
Unfortunately:

        /usr/bin/make -f Makefile.doxygen    PERL=/usr/bin/perl all
        xlC  -o ../bin/doxygen ../objects/main.o  -L../lib -ldoxygen -ldoxycfg -lqtools -lpng -lmd5 
ld: 0711-317 ERROR: Undefined symbol: Config::m_instance
ld: 0711-317 ERROR: Undefined symbol: .Config::getBool(const char*,int,const char*) const
...

i.e. some stuff has not been compiled properly. Showstopper for now.

HP-UX

Needs the lex utility, if this is not available, the freeware flex will also do, define for example:

   alias -x lex="/nfs/local/1100/bin/flex"  # location of flex

Without lex or equivalent, some required C/C++ source modules will not be generated.
The build runs best with Gnu install, specified at the configure command line. Without install, one would have to pre-edit the Makefile.in

$(INSTTOOL) -d ... => mkdir -p ...

$(INSTTOOL) -m 755 => cp -p

Generation of documentation apart from the man pages require a working TeX installation, i.e. epstopdf, latex, dvips .
Run

   # HP-UX 11.00, gcc
   configure --static                    --make /nfs/local/1100/gmake-3.81/bin/make --prefix /tmp/doxygen-1.4.7
   # HP-UX 10.20, native cc
   configure --static --platform hpux-cc --make /nfs/local/1020/gmake-3.81/bin/make --prefix /tmp/doxygen-1.4.7cc

then

   make
   make install
   make install_docs

Configuration

Usage

Generate a configuration file Doxyfile:

doxygen -g

and adapt tags, in particular

PROJECT_NAME           = 
OUTPUT_DIRECTORY       = 
# for undocumented sources:
EXTRACT_ALL            = YES

This is needed only once

Generate the documentation:
```
doxygen  
```

Last update: 3-Jul-2013, M.Kraemer

Impressum Data privacy protection