Doxygen Quick Reference
Doxygen Quick Reference
com
Doxygen Quick Reference other parts of the documentation as the first argument to a Member group documentation will not appear under under a
\ref <lbl> ‘‘<lnk>’’ command. This creates a link to the la- separate header-tab in the generated documentation. Module
beled group using the lnk text enclosed in quotes, the second groups are defined with the \name <label> command in a com-
Doxygen commands argument is optional. The group members are enclosed by the ment block which is taken as the group header, which gives the
Doxygen (http://www.doxygen.org/) reads a configuration file group open @{ and close @} commands, as follows: group a label for later reference.
to control source code processing and documentation output
formats, the default filename is Doxyfile. Page Groups
/** \defgroup <label> ‘‘<title>’’ */
doxygen Run with default config file. /* @{ */ Page group documentation will appear under the Related
doxygen <config-file> Run with <config-file>. // group members here ... Pages heading in the generated documentation. Page groups
doxygen -g <config-file> Generate <config-file>. /* @} */ are defined with the \page <label> (title), which gives the
group a label for later reference. and a title to display
Documenting the sources where groups initiated by \name or \page commands have sim- in the documenation. Pages can be further divided into
Doxygen-visible multi-line comment blocks begin with /**, or ilar forms, see table below. The open and close group com- sub-pages—with \sub-page <n> ‘‘<t>’’, sections and sub-
/*!, and end with */. Alternately, the of C++ single line com- mands must be placed in a comment block, this can be a stan- sections, and sub-subsections with a command similar to:
ment delimiters /// or //! may be used on each line. Within dard C-style comment or single line C++ comment. Elements \section <section-name> (section title) . The name of the
a comment block HTML tags or Doxygen specific markup tags, may be members of multiple groups, which may lead to con- command simply changes to subsection or subsubsection as
Special Commands, can be used. Documentation comment flicts when generating documentation. Doxygen implements required. These commands give a label <section-name> and
blocks can occur anywhere in the source code but placing such a priority scheme for group membership. The priorities are title (section title) to the section.
blocks before defined code elements, classes, functions, etc., is assigned based on the command used to initiate group mem-
recommended. Source code files should include the \file com- bership. The priority order (highest to lowest) is \ingroup, A special case of a page group is the main page group. The
mand to make comments in the file visible to Doxygen. \defgroup, \addtogroup, and \weakgroup Doxygen command \mainpage within a comment block places
the documentation within that block on the Index page of the
Doxygen special commands, with a few exceptions, begin with \defgroup <l> ‘‘<t>’’ defines a module group with a la- generated documentation. You can refer to the main page using
the prefix @ or \, used in this document. Following the Doxygen bel l and title t. \ref index (if the treeview is disabled, otherwise you should use
manual convention, the command arguments are enclosed here \name <l> defines a member group with a la- \ref main).
in braces that signify the extent of the argument, these braces bel l.
are not part of the command, nor should they be included in \page <l> (t) defines a page group with a label l Formulas
the command: and title t. Doxygen can include LATEX formulas in the HTML and LATEX
\section <l> (t) defines a section on a page with a output formats. Formulas can p be included within the text of
< angle > angle braces: argument is a single word.
label l and title t.
( round ) round braces: argument extends to end of line. a single line, for example—r = (x − x0 )2 − (y − y0 )2 or as a
\subsection <l> (t) defines a sub-section on a page
{ curly } curly braces: argument extends to next para- centered formula such as (from the Doxygen manual):
with a label l and title t.
graph.
\mainpage (t) defines a documentation block to Z T Z a Z θ
dθ
Lists place on the index page. |I2 | = ψ(t) u(a, t) − c(ξ)ut (ξ, t) dξ dt
\addtogroup <l> (t) adds to a group, enclose in open- k(θ, t)
Column aligned hypens (-) create a unordered or bulleted list. 0 γ(t) a
Column aligned hypens with a pound-number symbol (-#) cre- close pairs.
\ingroup <l> adds documentation to the l To include an inline formula the command \f$ is used to begin
ate an ordered or numbered list. Lists can be made heirachi-
group. and end the formula block, the above formula would appear in
cal using indentation levels, list items with identical column
\ref <l> ‘‘<t>’’ references group l using the op- the documentation as \f$ \sqrt{(x-x_0)^2-(y-y_0)^2} \f$.
aligned symbols will appear at the same level of the heirarchy.
tional link text t. A centered formula is enclosed by the Doxygen commands \f[
Unordered and ordered lists can be mixed in a heirarchy.
- list item in unorderd list (column aligned). /* @{ */ comment to open a group block to open the formula block and \f] to close it. Additional LATEX
-# list item in orderd list (column aligned). /* @} */ comment to close a group block equation environments, like eqnarray can be used with the com-
\li list item in unorderd list. // @{ comment to open a group block mands \f{eqnarray} to open the formula block and \f} to close
\arg equivalent to \li. // @{ comment to open a group block the block.
<ul> HTML: starts an unordered list. Module Groups LATEX Formulas
</ul> HTML: ends an unordered list.
<ol> HTML: starts an ordered list. Module group documentation will appear under the Modules LATEX formulas use a markup language with a rich set of tags
</ol> HTML: ends an ordered list. heading in the generated documentation. Module groups are which can be combined to typeset any formula. A brief sub-set
<li> HTML: list item, between <[uo]l> and </[uo]l> defined with the \defgroup <label> ‘‘<title>’’, which gives of those commands is included here. Additional resources can
pairs. the group a label for later reference. and a title to display in be found on the web and in bookstores.
the documenation; title includes everything enclosed by quotes.
Grouping x^{2} x2 ; superscript x_{0} x√0 ; subscript
Member Groups x n
Doxygen can group things in many ways. Groups are de- \frac{x}{y} y
\sqrt[n]{x} x
Pn Rb
fined with either a \defgroup, \name or \page command Member group are used when “a compound (e.g. a class or file) \sum_{k=1}^n \int_{a}^b dt dt
k=1 a
with a label and optional title. The label can be used in has many members, it is often desired to group them together”. \pi π; small Greek \Pi Π; capital Greek
http://books24x7.blogspot.com