Difference between revisions of "Doxygen"

From CBLFS
Jump to navigationJump to search
 
 
(17 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{| style="text-align: left; background-color: AliceBlue;"
 
{| style="text-align: left; background-color: AliceBlue;"
|-
+
|-valign="top"
 
!Download Source:
 
!Download Source:
| http://ftp.stack.nl/pub/users/dimitri/doxygen-1.4.6.src.tar.gz
+
| ftp://ftp.stack.nl/pub/users/dimitri/doxygen-{{Doxygen-Version}}.src.tar.gz
 
|}
 
|}
  
 
----
 
----
 +
 +
{{Package-Introduction|Doxygen is a documentation system for C++, C, Java, Objective-C, Python, IDL (Corba and Microsoft flavors) and to some extent PHP, C#, and D.|http://www.stack.nl/~dimitri/doxygen/}}
  
 
== Dependencies ==
 
== Dependencies ==
Line 13: Line 15:
 
* [[TeTeX]]
 
* [[TeTeX]]
 
* [[Python]]
 
* [[Python]]
* [[ESP Ghostscript]] or [[AFPL Ghostscript]]
+
* [[Ghostscript]]
 
* [[Graphviz]]
 
* [[Graphviz]]
 +
 +
== Configuration Information ==
 +
 +
{|style="text-align: left;"
 +
|-
 +
|''--english-only'': Include support for English only.
 +
|-
 +
|''--enable-langs list'': Include support for output languages listed in list. [default: nl,se,cz,fr,id,it,de,jp,je,es,fi,ru,hr,pl,pt,hu,kr,ke,ro,si,cn,no,br,dk,sk,ua,gr,tw,sr,ca,lt,za,ar,fa]
 +
|-
 +
|''--with-doxywizard'': If [[Qt3]] is installed, you can use this flag to cause Doxygen's GUI front-end to be built.
 +
|}
 +
 +
{{Note|Doxygen does not use ''DESTDIR''.  Doxygen does recognize the ''INSTALL'' variable that may be used in a manner similar to ''DESTDIR''.  Using the ''INSTALL'' variable, the installation commands would become '''make INSTALL<nowiki>=<DESTDIR>/usr</nowiki>''' and '''make INSTALL<nowiki>=<DESTDIR>/usr DOCDIR=<DESTDIR>/usr/share/doc/doxygen install_docs</nowiki>'''.}}
  
 
== Non-Multilib ==
 
== Non-Multilib ==
Line 20: Line 35:
 
Compile the package:
 
Compile the package:
  
rm src/unistd.h &&
 
 
  ./configure --prefix /usr --docdir /usr/share/doc &&
 
  ./configure --prefix /usr --docdir /usr/share/doc &&
 
  make
 
  make
Line 39: Line 53:
 
Compile the package:
 
Compile the package:
  
CC="gcc ${BUILD32}" CXX="g++ ${BUILD32}" USE_ARCH=32 \
 
 
  ./configure --prefix /usr --docdir /usr/share/doc &&
 
  ./configure --prefix /usr --docdir /usr/share/doc &&
  make
+
  make CC="gcc ${BUILD32}" CXX="g++ ${BUILD32}"
  
 
Install the package
 
Install the package
Line 55: Line 68:
 
Compile the package:
 
Compile the package:
  
CC="gcc ${BUILDN32}" CXX="g++ ${BUILDN32}" USE_ARCH=n32 \
 
 
  ./configure --prefix /usr --docdir /usr/share/doc &&
 
  ./configure --prefix /usr --docdir /usr/share/doc &&
  make
+
  make CC="gcc ${BUILDN32}" CXX="g++ ${BUILDN32}"
  
 
Install the package
 
Install the package
Line 71: Line 83:
 
Compile the package:
 
Compile the package:
  
CC="gcc ${BUILD64}" CXX="g++ ${BUILD64}" USE_ARCH=64 \
 
 
  ./configure --prefix /usr --docdir /usr/share/doc &&
 
  ./configure --prefix /usr --docdir /usr/share/doc &&
  make
+
  make CC="gcc ${BUILD64}" CXX="g++ ${BUILD64}"
  
 
Install the package
 
Install the package
Line 82: Line 93:
  
 
  make install_docs
 
  make install_docs
 +
 +
= Contents =
 +
 +
{| style="text-align: left;"
 +
|-valign="top"
 +
! Installed Programs:
 +
| doxygen, doxytag, and optionally, doxywizard
 +
|-valign="top"
 +
! Installed Libraries:
 +
| None
 +
|-valign="top"
 +
! Installed Directories:
 +
| /usr/share/doc/doxygen
 +
|}
 +
 +
=== Short Descriptions ===
 +
 +
{| style="text-align: left;"
 +
|-valign="top"
 +
! doxygen
 +
| is a command-line based utility used to generate template configuration files and then generate documentation from these templates. Use '''doxygen --help''' for an explanation of the command-line parameters.
 +
|-valign="top"
 +
! doxytag
 +
| is used to generate a tag file and/or a search index for a set of HTML files.
 +
|-valign="top"
 +
! doxywizard
 +
| is a GUI front-end for configuring and running '''doxygen'''.
 +
|}
 +
 +
[[Category:Programming]]

Latest revision as of 16:41, 19 March 2009

Download Source: ftp://ftp.stack.nl/pub/users/dimitri/doxygen-1.7.3.src.tar.gz

Introduction to Doxygen

Doxygen is a documentation system for C++, C, Java, Objective-C, Python, IDL (Corba and Microsoft flavors) and to some extent PHP, C#, and D.

Project Homepage: http://www.stack.nl/~dimitri/doxygen/

Dependencies

Optional

Configuration Information

--english-only: Include support for English only.
--enable-langs list: Include support for output languages listed in list. [default: nl,se,cz,fr,id,it,de,jp,je,es,fi,ru,hr,pl,pt,hu,kr,ke,ro,si,cn,no,br,dk,sk,ua,gr,tw,sr,ca,lt,za,ar,fa]
--with-doxywizard: If Qt3 is installed, you can use this flag to cause Doxygen's GUI front-end to be built.
Caution.png

Note

Doxygen does not use DESTDIR. Doxygen does recognize the INSTALL variable that may be used in a manner similar to DESTDIR. Using the INSTALL variable, the installation commands would become make INSTALL=<DESTDIR>/usr and make INSTALL=<DESTDIR>/usr DOCDIR=<DESTDIR>/usr/share/doc/doxygen install_docs.

Non-Multilib

Compile the package:

./configure --prefix /usr --docdir /usr/share/doc &&
make

Install the package

make install

If you wish to generate and install the package documentation (note that man pages have already been installed), you must have Python, teTeX (for HTML docs) and Ghostscript (for PDF docs) installed, then issue the following command:

make install_docs

Multilib

This package does not provide any libraries so only one installation is needed.

32Bit

Compile the package:

./configure --prefix /usr --docdir /usr/share/doc &&
make CC="gcc ${BUILD32}" CXX="g++ ${BUILD32}" 

Install the package

make install

If you wish to generate and install the package documentation (note that man pages have already been installed), you must have Python, teTeX (for HTML docs) and Ghostscript (for PDF docs) installed, then issue the following command:

make install_docs

N32

Compile the package:

./configure --prefix /usr --docdir /usr/share/doc &&
make CC="gcc ${BUILDN32}" CXX="g++ ${BUILDN32}"

Install the package

make install

If you wish to generate and install the package documentation (note that man pages have already been installed), you must have Python, teTeX (for HTML docs) and Ghostscript (for PDF docs) installed, then issue the following command:

make install_docs

64Bit

Compile the package:

./configure --prefix /usr --docdir /usr/share/doc &&
make CC="gcc ${BUILD64}" CXX="g++ ${BUILD64}"

Install the package

make install

If you wish to generate and install the package documentation (note that man pages have already been installed), you must have Python, teTeX (for HTML docs) and Ghostscript (for PDF docs) installed, then issue the following command:

make install_docs

Contents

Installed Programs: doxygen, doxytag, and optionally, doxywizard
Installed Libraries: None
Installed Directories: /usr/share/doc/doxygen

Short Descriptions

doxygen is a command-line based utility used to generate template configuration files and then generate documentation from these templates. Use doxygen --help for an explanation of the command-line parameters.
doxytag is used to generate a tag file and/or a search index for a set of HTML files.
doxywizard is a GUI front-end for configuring and running doxygen.