install.doc

doxygen(一个自动从源代码生成文档的工具)的源代码

/******************************************************************************
 *
 * 
 *
 * Copyright (C) 1997-2001 by Dimitri van Heesch.
 *
 * Permission to use, copy, modify, and distribute this software and its
 * documentation under the terms of the GNU General Public License is hereby 
 * granted. No representations are made about the suitability of this software 
 * for any purpose. It is provided "as is" without express or implied warranty.
 * See the GNU General Public License for more details.
 *
 * Documents produced by Doxygen are derivative works derived from the
 * input used in their production; they are not affected by this license.
 *
 */
/*! \page install Installation

\addindex installation
First go to the 
<a href="http://www.doxygen.org/download.html">download</a> page
\latexonly({\tt http://www.doxygen.org/download.html})\endlatexonly
to get the latest distribution, if you did not have it already.

This section is divided into the following subsections:
<ul>
<li>\ref install_src_unix  "Compiling from source on Unix"
<li>\ref install_bin_unix  "Installating the binaries on Unix"
<li>\ref unix_problems "Known compilation problems for Unix"
<li>\ref install_src_windows "Compiling from source on Windows"
<li>\ref install_bin_windows "Installating the binaries on Windows"
<li>\ref build_tools "Tools used to develop doxygen"
</ul>

\subsection install_src_unix    Compiling from source on Unix

If you downloaded the source distribution, you need at least the 
following to build the executable:
<ul>
<li>The <a href="ftp://prep.ai.mit.edu/pub/gnu/">GNU</a> tools 
    flex, bison and make
    \addindex flex
    \addindex bison
    \addindex make
<li>In order to generate a Makefile for your platform, you need 
    <a href="http://www.perl.com/>perl</a>
    \latexonly(see {\tt http://www.perl.com/})\endlatexonly.
    \addindex perl
</ul>

To take full advantage of doxygen's features the following additional
tools should be installed.

<ul>
<li>Troll Tech's GUI toolkit version 2.x.y
    <A HREF="http://www.trolltech.com/products/qt.html">Qt</A>
    \latexonly(see {\tt http://www.trolltech.com/products/qt.html})\endlatexonly.
    \addindex Qt
    This is needed to build the GUI front-end. 
<li>A \f$\mbox{\LaTeX}\f$ distribution: for instance
    <a href="http://www.tug.org/">teTeX 1.0</a>.<br>
    \latexonly(see {\tt http://www.tug.org/})\endlatexonly.
    This is needed for generating LaTeX, Postscript, and PDF output.
<li><a href="http://www.research.att.com/sw/tools/graphviz/">
    the Graph visualization toolkit version 1.5</a><br>
    \latexonly(see {\tt http://www.research.att.com/sw/tools/graphviz/})\endlatexonly.
    Needed for the include dependency graphs, 
    the graphical inheritance graphs, and the collaboration graphs.
<li>The ghostscript interpreter.
</ul>

Compilation is now done by performing the following steps:

<ol>
<li> Unpack the archive, unless you already have done that:
   
\verbatim
    gunzip doxygen-$VERSION.src.tar.gz    # uncompress the archive
    tar xf doxygen-$VERSION.src.tar       # unpack it
\endverbatim

<li>Run the configure script:
 
\verbatim
    sh ./configure
\endverbatim

    The script tries to determine the platform you use, the make tool 
    (which \e 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:

\verbatim
    configure --platform platform-type
\endverbatim

    See the <code>PLATFORMS</code> 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 <code>--with-doxywizard</code> 
    option:

\verbatim
    configure --with-doxywizard
\endverbatim

    For an overview of other configuration options use

\verbatim
    configure --help
\endverbatim

<li>Compile the program by running make:

\verbatim
    make
\endverbatim

    The program should compile without problems and three binaries 
    (<code>doxygen</code>, <code>doxytag</code>, and <code>doxysearch</code>) 
    should be available in the bin directory of the distribution.

<li>Optional: Generate the user manual.
    
\verbatim
    make docs
\endverbatim

    To let doxygen generate the HTML documentation.
    
    \note You will need the stream editor <code>sed</code> for this, 
    but this should be available on any Unix platform.

    The HTML directory of the distribution will now contain the html 
    documentation (just point a HTML browser to the file 
    <code>index.html</code> in the 
    html directory).
    
<li>Optional: Generate a PostScript and PDF version of the manual
    (you will need <code>latex</code> and <code>dvips</code> and
     the ghostscript package for this).

\verbatim
    make pdf
\endverbatim

    The PostScript manual <code>doxygen_manual.ps</code> will be located 
    in the latex directory of the distribution. Just send it to a 
    PostScript printer to print it or use <code>ghostview</code> to view it. 

</ol>

\subsection install_bin_unix    Installating the binaries on Unix

    After the compilation of the source code do a <code>make install</code>
    to install doxygen. If you downloaded the binary distribution for Unix,
    type:

\verbatim
    ./configure
    make install
\endverbatim   

    Binaries are installed into the directory <code>\<prefix\>/bin</code>.
    Use <code>make install_docs</code> to install the
    documentation and examples into <code>\<docdir\>/doxygen</code>. 

    <code>\<prefix\></code> defaults to <code>/usr</code> but can be changed with 
    the <code>--prefix</code> option of the configure script. 
    The default <code>\<docdir\></code> directory is 
    <code>\<prefix\>/share/doc/packages</code> and can be changed with
    the <code>--docdir</code> option of the configure script.

    Alternatively, you can also copy the binaries from the <code>bin</code> 
    directory manually to some <code>bin</code> directory in your search path.
    This is sufficient to use doxygen.

    \note You need the GNU install tool for this to work. Other
    install tools may put the binaries in the wrong directory!

    If you have a RPM or DEP package, then please follow the 
    standard installation procedure that is required for these packages. 

\subsection unix_problems Known compilation problems for Unix

<b>Qt problems</b>

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:
\verbatim
   mkdir qt
   cd qt
   ln -s your-qt-include-dir-here include
   ln -s your-qt-lib-dir-here lib
   export QTDIR=$PWD
\endverbatim 

If you have a csh-like shell you should use <code>setenv QTDIR $PWD</code>
instead of the <code>export</code> command above.
  
Now install doxygen as described above.  

<b>Latex problems</b>

The file <code>a4wide.sty</code> is not available for all distributions. If
your distribution does not have it please select another paper type
in the config file (see the \ref cfg_paper_type "PAPER_TYPE" tag in the 
config file).

<b>HP-UX & Digital Unix problems</b>

If you are compiling for HP-UX with aCC and you get this error:
\verbatim
    /opt/aCC/lbin/ld: Unsatisfied symbols:
    alloca (code)
\endverbatim
  then you should (according to Anke Selig) edit <code>ce_parse.cpp</code> 
  and replace
\verbatim
    extern "C" {
      void *alloca (unsigned int);
    };
\endverbatim
  with
\verbatim
    #include <alloca.h>  
\endverbatim

  If that does not help, try removing <code>ce_parse.cpp</code> 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:
   
\verbatim
    #else /* not GNU C.  */
    #if (!defined (__STDC__) && defined (sparc)) || defined (__sparc__) \
        || defined (__sparc) || defined (__sgi)
    #include <alloca.h>
\endverbatim

  with

\verbatim
    #else /* not GNU C.  */
    #if (!defined (__STDC__) && defined (sparc)) || defined (__sparc__) \
        || defined (__sparc) || defined (__sgi) || defined (__osf__)
    #include <alloca.h>
\endverbatim

  Alternatively, one could fix the problem at the bison side.
  Here is patch for bison.simple (provided by Andre Johansen):
 
\verbatim
--- 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__)