/usr/share/doc/doxygen/html/install.html is in doxygen-doc 1.8.6-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.6"/>
<title>Doxygen: Installation</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
$(document).ready(initResizable);
$(window).load(resizeHeight);
</script>
<link href="doxygen_manual.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td style="padding-left: 0.5em;">
<div id="projectname">Doxygen
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.6 -->
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
$(document).ready(function(){initNavTree('install.html','');});
</script>
<div id="doc-content">
<div class="header">
<div class="headertitle">
<div class="title">Installation </div> </div>
</div><!--header-->
<div class="contents">
<div class="toc"><h3>Table of Contents</h3>
<ul><li class="level1"><a href="#install_src_unix">Compiling from source on UNIX</a></li>
<li class="level1"><a href="#install_bin_unix">Installing the binaries on UNIX</a></li>
<li class="level1"><a href="#unix_problems">Known compilation problems for UNIX</a></li>
<li class="level1"><a href="#install_src_windows">Compiling from source on Windows</a></li>
<li class="level1"><a href="#install_bin_windows">Installing the binaries on Windows</a></li>
<li class="level1"><a href="#build_tools">Tools used to develop doxygen</a></li>
</ul>
</div>
<div class="textblock"><p><a name="installation"></a></p>
<p>First go to the <a href="http://www.doxygen.org/download.html">download</a> page to get the latest distribution, if you did not downloaded doxygen already.</p>
<h1><a class="anchor" id="install_src_unix"></a>
Compiling from source on UNIX</h1>
<p>If you downloaded the source distribution, you need at least the following to build the executable: </p>
<ul>
<li>
The <a href="ftp://prep.ai.mit.edu/pub/gnu/">GNU</a> tools <code>flex</code>, <code>bison</code>, <code>libiconv</code> and <code>GNU make</code>, and <code>strip</code> <a name="flex"></a> <a name="bison"></a> <a name="libiconv"></a> <a name="make"></a> <a name="strip"></a> </li>
<li>
In order to generate a <code>Makefile</code> for your platform, you need <a href="http://www.perl.com/">perl</a> <a name="perl"></a> </li>
<li>
The configure script assume the availability of standard UNIX tools such as <code>sed, date, find, uname, mv, cp, cat, echo, tr, cd</code> and <code>rm</code>. </li>
</ul>
<p>To take full advantage of doxygen's features the following additional tools should be installed.</p>
<ul>
<li>
Qt Software's GUI toolkit <a href="http://qt-project.org/">Qt</a> <a name="%51t"></a> version 4.3 or higher (but currently, Qt 5.x is not supported). This is needed to build the GUI front-end doxywizard. </li>
<li>
A <img class="formulaInl" alt="$\mbox{\LaTeX}$" src="form_0.png"/> distribution: for instance <a href="http://www.tug.org/interest.html#free">TeX Live</a> This is needed for generating LaTeX, Postscript, and PDF output. </li>
<li>
<a href="http://www.graphviz.org/">the Graph visualization toolkit version 1.8.10 or higher</a> Needed for the include dependency graphs, the graphical inheritance graphs, and the collaboration graphs. If you compile graphviz yourself, make sure you do include freetype support (which requires the freetype library and header files), otherwise the graphs will not render proper text labels. </li>
<li>
For formulas or if you do not wish to use pdflatex, the ghostscript interpreter is needed. You can find it at <a href="http://www.ghostscript.com/">www.ghostscript.com</a>. </li>
<li>
In order to generate doxygen's own documentation, Python is needed, you can find it at <a href="http://www.python.org">www.python.org</a>. </li>
</ul>
<p>Compilation is now done by performing the following steps:</p>
<ol>
<li>
<p class="startli">Unpack the archive, unless you already have done that: </p>
<pre class="fragment">gunzip doxygen-$VERSION.src.tar.gz # uncompress the archive
tar xf doxygen-$VERSION.src.tar # unpack it
</pre><p class="endli"></p>
</li>
<li>
<p class="startli">Run the configure script: </p>
<pre class="fragment">sh ./configure
</pre><p>The script tries to determine the platform you use, the make tool (which <em>must</em> be GNU make) and the perl interpreter. It will report what it finds.</p>
<p>To override the auto detected platform and compiler you can run configure as follows: </p>
<pre class="fragment">configure --platform platform-type
</pre><p>See the <code>PLATFORMS</code> file for a list of possible platform options.</p>
<p>If you have Qt-4.3 or higher installed and want to build the GUI front-end, you should run the configure script with the <code>–with-doxywizard</code> option: </p>
<pre class="fragment">configure --with-doxywizard
</pre><p>For an overview of other configuration options use </p>
<pre class="fragment">configure --help
</pre><p class="endli"></p>
</li>
<li>
<p class="startli">Compile the program by running make: </p>
<pre class="fragment">make
</pre><p>The program should compile without problems and the binaries (<code>doxygen</code> and optionally <code>doxywizard</code>) should be available in the bin directory of the distribution.</p>
<p class="endli"></p>
</li>
<li>
<p class="startli">Optional: Generate the user manual. </p>
<pre class="fragment">make docs
</pre><p>To let doxygen generate the HTML documentation.</p>
<p>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). You will need the <code>python</code> interpreter for this.</p>
<p class="endli"></p>
</li>
<li>
<p class="startli">Optional: Generate a PDF version of the manual (you will need <code>pdflatex</code>, <code>makeindex</code>, and <code>egrep</code> for this).</p>
<p>make pdf</p>
<p>The PDF manual <code>doxygen_manual.pdf</code> will be located in the latex directory of the distribution. Just view and print it via the acrobat reader.</p>
<p class="endli"></p>
</li>
</ol>
<h1><a class="anchor" id="install_bin_unix"></a>
Installing the binaries on UNIX</h1>
<p>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: </p>
<pre class="fragment">./configure
make install
</pre><p>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>.</p>
<p><code><prefix></code> defaults to <code>/usr/local</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.</p>
<p>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.</p>
<dl class="section note"><dt>Note</dt><dd>You need the GNU install tool for this to work (it is part of the coreutils package). Other install tools may put the binaries in the wrong directory!</dd></dl>
<p>If you have a RPM or DEP package, then please follow the standard installation procedure that is required for these packages.</p>
<h1><a class="anchor" id="unix_problems"></a>
Known compilation problems for UNIX</h1>
<p><b>Qt problems</b></p>
<p>The Qt include files and libraries are not a subdirectory of the directory pointed to by <code>QTDIR</code> on some systems (for instance on Red Hat 6.0 includes are in <code>/usr/include/qt</code> and libs are in <code>/usr/lib</code>).</p>
<p>The solution: go to the root of the doxygen distribution and do: </p>
<pre class="fragment">mkdir qt
cd qt
ln -s your-qt-include-dir-here include
ln -s your-qt-lib-dir-here lib
ln -s your-qt-bin-dir-here bin
export QTDIR=$PWD
</pre><p>If you have a <code>csh</code>-like shell you should use <code>setenv QTDIR $PWD</code> instead of the <code>export</code> command above.</p>
<p>Now install doxygen as described above.</p>
<p><b>Bison problems</b></p>
<p>Versions 1.31 to 1.34 of <code>bison</code> contain a "bug" that results in a compiler errors like this:</p>
<p><code>ce_parse.cpp:348: member `class CPPValue yyalloc::yyvs' with </code> constructor not allowed in union</p>
<p>This problem has been solved in version 1.35 (versions before 1.31 will also work).</p>
<p><b>Sun compiler problems</b></p>
<p>It appears that doxygen doesn't work properly if it is compiled with Sun's C++ WorkShop Compiler. I cannot verify this myself as I do not have access to a Solaris machine with this compiler. With GNU compiler it does work and installing Sun patch 111679-13 has also been reported as a way to fix the problem.</p>
<p>when configuring with <code>--static</code> I got:</p>
<pre class="fragment">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)
</pre><p>Manually adding <code>-Bdynamic</code> after the target rule in <code>Makefile.doxygen</code> will fix this: </p>
<pre class="fragment">$(TARGET): $(OBJECTS) $(OBJMOC)
$(LINK) $(LFLAGS) -o $(TARGET) $(OBJECTS) $(OBJMOC) $(LIBS) -Bdynamic
</pre><p><b>GCC compiler problems</b></p>
<p>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 <code>–english-only</code> option.</p>
<p>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.</p>
<p>Gcc versions before 2.95 may produce broken binaries due to bugs in these compilers.</p>
<p><b>Dot problems</b></p>
<p>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. For doxygen 1.4.7 or higher it is recommended to use GraphViz 2.8 or higher to avoid font issues.</p>
<p><b>Red Hat 9.0 problems</b></p>
<p>If you get the following error after running make </p>
<pre class="fragment">tmake error: qtools.pro:70: Syntax error
</pre><p> then first type </p>
<pre class="fragment">export LANG=
</pre><p> before running make.</p>
<h1><a class="anchor" id="install_src_windows"></a>
Compiling from source on Windows</h1>
<p>From version 1.7.0 onwards, build files are provided for Visual Studio 2008. Also the free (as in beer) "Express" version of Developer Studio can be used to compile doxygen. Alternatively, you can compile doxygen <a class="el" href="install.html#install_src_unix">the UNIX way</a> using <a href="http://en.wikipedia.org/wiki/Cygwin">Cygwin</a> or <a href="http://www.mingw.org/">MinGW</a>.</p>
<p>The next step is to install modern versions of <code>bison</code> and <code>flex</code> (see <a href="http://sourceforge.net/projects/winflexbison">http://sourceforge.net/projects/winflexbison</a>. After installation and adding them to your <code>path</code> rename <code>win_flex.exe</code> to <code>flex.exe</code> and <code>win_bison.exe</code> to <code>bison.exe</code>) Furthermore you have to install <code>python</code> (version 2, see <a href="http://www.python.org">http://www.python.org</a>). These packages are needed during the compilation process if you use a GitHub snapshot of doxygen (the official source releases come with pre-generated sources).</p>
<p>Download doxygen's source tarball and put it somewhere (e.g. use <code>c:\tools</code>)</p>
<p>Now start a new command shell and type </p>
<pre class="fragment">cd c:\tools
tar zxvf doxygen-x.y.z.src.tar.gz
</pre><p> to unpack the sources (you can obtain <code>tar</code> from e.g. <a href="http://gnuwin32.sourceforge.net/packages.html">http://gnuwin32.sourceforge.net/packages.html</a>). Alternatively you can use an unpack program, like 7-Zip (see <a href="http://www.7-zip.org">http://www.7-zip.org</a>) or use the build in unpack feature of modern Windows systems).</p>
<p>Now your environment is setup to build <code>doxygen</code>.</p>
<p>Inside the <code>doxygen-x.y.z</code> directory you will find a <code>winbuild</code> directory containing a <code>Doxygen.sln</code> file. Open this file in Visual Studio. You can now build the Release or Debug flavor of Doxygen by right-clicking the project in the solutions explorer, and selecting Build.</p>
<p>Note that compiling Doxywizard currently requires Qt version 4 (see <a href="http://qt-project.org/">http://qt-project.org/</a>).</p>
<p>Also read the next section for additional tools you may need to install to run doxygen with certain features enabled.</p>
<h1><a class="anchor" id="install_bin_windows"></a>
Installing the binaries on Windows</h1>
<p>Doxygen comes as a self-installing archive, so installation is extremely simple. Just follow the dialogs.</p>
<p>After installation it is recommended to also download and install GraphViz (version 2.20 or better is highly recommended). Doxygen can use the <code>dot</code> tool of the GraphViz package to render nicer diagrams, see the <a class="el" href="config.html#cfg_have_dot">HAVE_DOT</a> option in the configuration file.</p>
<p>If you want to produce compressed HTML files (see <a class="el" href="config.html#cfg_generate_htmlhelp">GENERATE_HTMLHELP</a>) in the config file, then you need the Microsoft HTML help workshop. You can download it from <a href="http://www.microsoft.com/en-us/download/details.aspx?id=21138">Microsoft</a>.</p>
<p>If you want to produce Qt Compressed Help files (see <a class="el" href="config.html#cfg_qhg_location">QHG_LOCATION</a>) in the config file, then you need qhelpgenerator which is part of Qt. You can download Qt from <a href="http://qt-project.org/downloads">Qt Software Downloads</a>.</p>
<p>In order to generate PDF output or use scientific formulas you will also need to install <a href="http://en.wikipedia.org/wiki/LaTeX">LaTeX</a> and <a href="http://en.wikipedia.org/wiki/Ghostscript">Ghostscript</a>.</p>
<p>For LaTeX a number of distributions exists. Popular ones that should work with doxygen are <a href="http://www.miktex.org">MikTex</a> and <a href="http://www.tug.org/protext/">proTeXt</a>.</p>
<p>Ghostscript can be <a href="http://sourceforge.net/projects/ghostscript/">downloaded</a> from Sourceforge.</p>
<p>After installing LaTeX and Ghostscript you'll need to make sure the tools latex.exe, pdflatex.exe, and gswin32c.exe are present in the search path of a command box. Follow <a href="http://www.computerhope.com/issues/ch000549.htm">these</a> instructions if you are unsure and run the commands from a command box to verify it works.</p>
<h1><a class="anchor" id="build_tools"></a>
Tools used to develop doxygen</h1>
<p>Doxygen was developed and tested under Linux & MacOSX using the following open-source tools: </p>
<ul>
<li>
GCC version 4.6.3 (Linux) and 4.2.1 (MacOSX) </li>
<li>
GNU flex version 2.5.35 </li>
<li>
GNU bison version 2.5 (Linux) and 2.3 (MacOSX) </li>
<li>
GNU make version 3.81 </li>
<li>
Perl version 5.12 </li>
<li>
TeX Live 2009 (or later) </li>
</ul>
Go to the <a href="starting.html">next</a> section or return to the
<a href="index.html">index</a>.
</div></div><!-- contents -->
</div><!-- doc-content -->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="footer">Generated on Mon Jan 27 2014 11:24:39 for Doxygen by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.8.6 </li>
</ul>
</div>
</body>
</html>
|