summaryrefslogtreecommitdiffstats
path: root/doc/install.doc
blob: 2c5f0ac5e04e5c947dcfadd0aeec06363cd0385d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
/******************************************************************************
 *
 * $Id$
 *
 * Copyright (C) 1997-1999 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.
 *
 * All output generated with Doxygen is not covered by this license.
 *
 */
/*! \page install Installation

\addindex installation
First go to the 
<a href="http://www.stack.nl/~dimitri/doxygen/download.html">download</a> page
\latexonly({\tt http://www.stack.nl/$\sim$dimitri/doxygen/download.html})\endlatexonly
to get the latest distribution and unpack it.

If you downloaded the source distribution, you need at least the 
following to build the executable:
<UL>
<LI>Troll Tech's GUI toolkit <A HREF="http://www.troll.no/dl">Qt</A>
    \latexonly(see {\tt http://www.troll.no/dl})\endlatexonly.
    \addindex Qt
<LI>The <a href="ftp://prep.ai.mit.edu/pub/gnu">GNU</a> tools 
    flex, bison and make
    \latexonly(see {\tt ftp://prep.ai.mit.edu/pub/gnu})\endlatexonly.
    \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>

\addindex HTTP
\addindex CGI
To use the search engine \c doxysearch, you will also need
a HTTP daemon running on the target system and permission to execute a 
CGI binary.

Once you have Qt installed correctly, you can simply enter:
\verbatim
make
\endverbatim
to get a list of all supported platforms/compilers.
Typing <tt>make</tt> followed by your platform will compile doxygen.
For Linux you can enter the following:
\verbatim
make linux-g++
\endverbatim

Doxygen should compile without errors or warnings.
If it does not, please send the compilation errors or warnings along 
with a description of your platform to 
<a href="mailto:dimitri@stack.nl>dimitri@stack.nl</a>.

After compilation, the binaries will be located in the \c bin
directory of the distribution.
You may want to copy these files to a location in your path 
(\c /usr/local/bin for instance) or add the \c bin
directory of the distribution to your search path.

The following binaries should now be available:
<UL>
<LI>\c doxygen: for generating the class browser. 
<LI>\c doxytag: for creating a tag file containing references 
    to external documentation.
<LI>\c doxysearch: the search engine. This binary should not be 
    executed directly. It must be called from an CGI script that will be 
    generated by doxygen. 
</UL>

Doxygen was developed and tested under Linux using the following tools:
<ul>
<li>GCC version 2.8.1
<li>GNU flex version 2.5.4
<li>GNU bison version 1.25
<li>GNU make version 3.77
<li>Perl version 5.001 (patch level 1m)
<li>VIM version 5.3
<li>Netscape 4.04 & 4.5
<li>Troll Tech's tmake version 1.2 (included in the distribution) 
<li>teTeX version 0.4
</ul>

\htmlonly
Go to the <a href="starting.html">next</a> section or return to the
 <a href="index.html">index</a>.
\endhtmlonly

*/