distribution: for instance teTeX 1.0 . This is needed for generating LaTeX, Postscript, and PDF output. This section is divided into the following sections:
To take full advantage of doxygen's features the following additional tools should be installed.
distribution: for instance teTeX 1.0 . This is needed for generating LaTeX, Postscript, and PDF output. Compilation is now done by performing the following steps:
gunzip doxygen-$VERSION.src.tar.gz # uncompress the archive
tar xf doxygen-$VERSION.src.tar # unpack it
sh ./configure
The script tries to determine the platform you use, the make tool (which must be GNU make) and the perl interpreter. It will report what it finds.
To override the auto detected platform and compiler you can run configure as follows:
configure --platform platform-type
See the PLATFORMS file for a list of possible platform options.
If you have Qt-2.1.x installed and want to build the GUI front-end, you should run the configure script with the --with-doxywizard option:
configure --with-doxywizard
For an overview of other configuration options use
configure --help
make
The program should compile without problems and three binaries (doxygen and doxytag) should be available in the bin directory of the distribution.
make docs
To let doxygen generate the HTML documentation.
sed for this, but this should be available on any Unix platform.index.html in the html directory).
pdflatex, makeindex, and egrep for this).
make pdf
The PDF manual doxygen_manual.pdf will be located in the latex directory of the distribution. Just view and print it via the acrobat reader.
make install to install doxygen. If you downloaded the binary distribution for Unix, type:
./configure
make install
Binaries are installed into the directory <prefix>/bin. Use make install_docs to install the documentation and examples into <docdir>/doxygen.
<prefix> defaults to /usr but can be changed with the --prefix option of the configure script. The default <docdir> directory is <prefix>/share/doc/packages and can be changed with the --docdir option of the configure script.
Alternatively, you can also copy the binaries from the bin directory manually to some bin directory in your search path. This is sufficient to use doxygen.
The Qt include files and libraries are not a subdirectory of the directory pointed to by QTDIR on some systems (for instance on Red Hat 6.0 includes are in /usr/include/qt and libs are in /usr/lib).
The solution: go to the root of the doxygen distribution and do:
mkdir qt cd qt ln -s your-qt-include-dir-here include ln -s your-qt-lib-dir-here lib export QTDIR=$PWD
If you have a csh-like shell you should use setenv QTDIR $PWD instead of the export command above.
Now install doxygen as described above.
Bison problems
Versions 1.31 to 1.34 of bison contain a "bug" that results in a compiler errors like this:
ce_parse.cpp:348: member `class CPPValue yyalloc::yyvs' with constructor not allowed in union
This problem has been solved in version 1.35 (versions before 1.31 will also work).
Latex problems
The file a4wide.sty is not available for all distributions. If your distribution does not have it please select another paper type in the config file (see the PAPER_TYPE tag in the config file).
HP-UX & Digital Unix problems
If you are compiling for HP-UX with aCC and you get this error:
/opt/aCC/lbin/ld: Unsatisfied symbols:
alloca (code)
ce_parse.cpp and replace
extern "C" {
void *alloca (unsigned int);
};
#include <alloca.h>
If that does not help, try removing ce_parse.cpp and let bison rebuild it (this worked for me).
If you are compiling for Digital Unix, the same problem can be solved (according to Barnard Schmallhof) by replacing the following in ce_parse.cpp:
#else /* not GNU C. */
#if (!defined (__STDC__) && defined (sparc)) || defined (__sparc__) \
|| defined (__sparc) || defined (__sgi)
#include <alloca.h>
with
#else /* not GNU C. */
#if (!defined (__STDC__) && defined (sparc)) || defined (__sparc__) \
|| defined (__sparc) || defined (__sgi) || defined (__osf__)
#include <alloca.h>
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__)
The generated scanner.cpp that comes with doxygen is build with this patch applied.
Sun compiler problems
I tried compiling doxygen only with Sun's C++ WorkShop Compiler version 5.0 (I used ./configure --platform solaris-cc)
Qt-2.x.y is required for this compiler (Qt-1.44 has problems with the bool type).
Compiling the doxygen binary went ok, but while linking doxytag I got a lot of link errors, like these:
QList<PageInfo>::__vtbl /home/dimitri/doxygen/ objects/SunWS_cache/CC_obj_6/6c3eO4IogMT2vrlGCQUQ.o [Hint: try checking whether the first non-inlined, non-pure virtual function of class QList<PageInfo> is defined]
These are generated because the compiler is confused about the object sharing between doxygen and doxytag. To compile doxytag anyway do:
rm -rf objects mkdir objects cd src gmake -f Makefile.doxytag
when configuring with --static I got:
Undefined first referenced symbol in file dlclose /usr/lib/libc.a(nss_deffinder.o) dlsym /usr/lib/libc.a(nss_deffinder.o) dlopen /usr/lib/libc.a(nss_deffinder.o)
Manually adding -Bdynamic after the target rule in Makefile.doxygen and Makefile.doxytag will fix this:
$(TARGET): $(OBJECTS) $(OBJMOC)
$(LINK) $(LFLAGS) -o $(TARGET) $(OBJECTS) $(OBJMOC) $(LIBS) -Bdynamic
GCC compiler problems
Older versions of the GNU compiler have problems with constant strings containing characters with character codes larger than 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.
On some platforms (such as OpenBSD) using some versions of gcc with -O2 can lead to eating all memory during the compilation of files such as config.cpp. As a workaround use --debug as a configure option or omit the -O2 for the particular files in the Makefile.
Gcc versions before 2.95 may produce broken binaries due to bugs in these compilers.
Dot problems
Due to a change in the way image maps are generated, older versions of doxygen (<=1.2.17) will not work correctly with newer versions of graphviz (>=1.8.8). The effect of this incompatibility is that generated graphs in HTML are not properly clickable. For doxygen 1.3 it is recommended to use at least graphviz 1.8.10 or higher.
Red Hat 9.0 problems
If you get the following error after running make
tmake error: qtools.pro:70: Syntax error
export LANG=
wintools/make.pl a bit. Let me know what you had to change if you got Doxygen working with another compiler.
If you have Visual C++ 6.0, and the source distribution, you can easily build doxygen using the project files in the wintools directory. If you want to build the CVS sources, or want to build from the command line, or with another compiler, you have to follow the steps below.
Thomas Baust reported that if you have Visual Studio.NET (2003) then you should be aware that there is a problem with the _popen() and _pclose() implementation, which currently leaks handles, so if you build doxygen with it and use the INPUT_FILTER, you will run to risk of crashing Windows! The problem is reported to and confirmed by Microsoft so maybe it will fixed in the next service pack.
Since Windows comes without all the nice tools that Unix users are used to, you'll need to install a number of these tools before you can compile doxygen for Windows from the command-line.
Here is what is required:
The good, tested, and free alternative is the tar utility supplied with cygwin tools. Anyway, the cygwin's flex, bison, and sed are also recommended below.
vcvars32.bat batch file to set the environment variables (if you did not select to do this automatically during installation).Borland C++ or MINGW (see http://www.mingw.org/) are also supported.
Alternatively, you can also choose to download only a small subset of the cygwin tools that I put together just to compile doxygen.
As a third alternative one could use the GNUWin32 tools that can be found at http://gnuwin32.sourceforge.net/
Make sure the BISONLIB environment variable points to the location where the files bison.simple and bison.hairy are located. For instance if these files are in c:\tools\cygwin\share then BISONLIB should be set to //c/tools/cygwin/share/
Also make sure the tools are available from a dos box, by adding the directory they are in to the search path.
For those of you who are very new to cygwin (if you are going to install it from scratch), you should notice that there is an archive file bootstrap.zip which also contains the tar utility (tar.exe), gzip utilities, and the cygwin1.dll core. This also means that you have the tar in hands from the start. It can be used to unpack the tar source distribution instead of using WinZip -- as mentioned at the beginning of this list of steps.
For doxywizard, a complete Qt library is still a requirement however. You can download the non-commercial version from Troll-Tech web-site. See doxygen download page for a link.
latex, dvips and gswin32. To get these working under Windows install the fpTeX distribution. You can find more info at: http://www.fptex.org/ and download it from CTAN or one of its mirrors. In the Netherlands for example this would be: ftp://ftp.easynet.nl/mirror/CTAN/systems/win32/fptex/Make sure the tools are available from a dos box, by adding the directory they are in to the search path.
For your information, the LaTeX is freely available set of so called macros and styles on the top of the famous TeX program (by famous Donald Knuth) and the accompanied utilities (all available for free). It is used for high quality typesetting. The result -- in the form of so called DVI (DeVice Independent) file -- can be printed or displayed on various devices preserving exactly the same look up to the capability of the device. The dvips allows you to convert the dvi to the high quality PostScript (i.e. PostScript that can be processed by utilities like psnup, psbook, psselect, and others). The derived version of TeX (the pdfTeX) can be used to produce PDF output instead of DVI, or the PDF can be produced from PostScript using the utility ps2pdf.
If you want to use MikTeX then you need to select at least the medium size installation. For really old versions of MikTex or minimal installations, you may need to download the fancyhdr package separately. You can find it at: ftp://ftp.tex.ac.uk/tex-archive/macros/latex/contrib/supported/fancyhdr/
objects and bin manually in the root of the distribution before compiling.
Compilation is now done by performing the following steps:
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).Notice: The use of LaTeX is optional and only needed for compilation of the documentation into PostScript or PDF. It is not needed for compiling the doxygen's binaries.
make.bat msvc
This should build the executables doxygen.exe and doxytag.exe using Microsoft's Visual C++ compiler (The compiler should not produce any serious warnings or errors).
You can use also the bcc argument to build executables using the Borland C++ compiler, or mingw argument to compile using GNU gcc.
examples subdirectory and type:
nmake
doc subdirectory and type:
nmake
The generated HTML docs are located in the ..\html subdirectory.
The sources for LaTeX documentation are located in the ..\latex subdirectory. From those sources, the DVI, PostScript, and PDF documentation can be generated.
To install doxygen, just copy the binaries from the bin directory to a location somewhere in the path. Alternatively, you can include the bin directory of the distribution to the path.
Go to the next section or return to the index.
1.3.5