doxygen1
Documentation system for various programming languages
Overview
Doxygen is a documentation system for C++, C, Java, Objective-C, IDL (CORBA and Microsoft flavors), Fortran, Python, VHDL and to some extent PHP, C#, and D.
You can use Doxygen in several ways:
- 1) Generate a template configuration file*:
-
doxygen [-s]
-g[configName]
- 2) Update an existing configuration file*:
-
doxygen [-s]
-u[configName]
- 3) Generate documentation using an existing configuration file*:
-
doxygen [configName]
- 4) Generate a template file that controls the layout of the generated documentation:
-
doxygen
-l[layoutFileName]
-
If layoutFileName is omitted, DoxygenLayout.xml will be used as the filename.
If - is used for layoutFileName, Doxygen writes to standard output.
- 5) Generate a template style sheet file for RTF, HTML or LaTeX:
-
RTF: doxygen
-wrtf styleSheetFile
-
HTML: doxygen
-whtml headerFile footerFile styleSheetFile [configFile]
-
LaTeX: doxygen
-wlatex headerFile footerFile styleSheetFile [configFile]
- 6) Generate an RTF extensions file:
-
RTF: doxygen
-ertf extensionsFile
-
If - is used for extensionsFile Doxygen will write to standard output.
- 7) Compare the used configuration file with the template configuration file:
-
doxygen
-x[configFile]
- Compare the used configuration file with the template configuration file
-
without replacing the environment variables or CMake type replacement variables:
-
doxygen
-x_noenv[configFile]
- 8) Show a list of built-in emojis.
-
doxygen
-femoji outputFileName
-
If - is used for outputFileName Doxygen will write to standard output.
*) If -s is specified, the comments of the configuration items in the config file will be omitted.
If configName is omitted, 'Doxyfile' will be used by default.
If - is used for configFile, Doxygen will write / read the configuration to / from standard output / input.
If -q is used for a Doxygen documentation run, Doxygen will see this as if QUIET=YES has been set.
-v print version string, -V print extended version information
-h,-? prints usage help information
doxygen -d prints additional usage flags for debugging purposes
Releases
13 releases since Debian 3.0 (Woody); the text changed 11 times.