|
Packit Service |
50c9f2 |
/******************************************************************************
|
|
Packit Service |
50c9f2 |
*
|
|
Packit Service |
50c9f2 |
*
|
|
Packit Service |
50c9f2 |
*
|
|
Packit Service |
50c9f2 |
* Copyright (C) 1997-2015 by Dimitri van Heesch.
|
|
Packit Service |
50c9f2 |
*
|
|
Packit Service |
50c9f2 |
* Permission to use, copy, modify, and distribute this software and its
|
|
Packit Service |
50c9f2 |
* documentation under the terms of the GNU General Public License is hereby
|
|
Packit Service |
50c9f2 |
* granted. No representations are made about the suitability of this software
|
|
Packit Service |
50c9f2 |
* for any purpose. It is provided "as is" without express or implied warranty.
|
|
Packit Service |
50c9f2 |
* See the GNU General Public License for more details.
|
|
Packit Service |
50c9f2 |
*
|
|
Packit Service |
50c9f2 |
* Documents produced by Doxygen are derivative works derived from the
|
|
Packit Service |
50c9f2 |
* input used in their production; they are not affected by this license.
|
|
Packit Service |
50c9f2 |
*
|
|
Packit Service |
50c9f2 |
*/
|
|
Packit Service |
50c9f2 |
/*! \page doxygen_usage Doxygen usage
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
Doxygen is a command line based utility. Calling \c doxygen with the
|
|
Packit Service |
50c9f2 |
`--help` option at the command line will give you a brief description of the
|
|
Packit Service |
50c9f2 |
usage of the program.
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
All options consist of a leading character <tt>-</tt>,
|
|
Packit Service |
50c9f2 |
followed by one character and one or more arguments depending on the option.
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
To generate a manual for your project you typically
|
|
Packit Service |
50c9f2 |
need to follow these steps:
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
You document your source code with
|
|
Packit Service |
50c9f2 |
special documentation blocks (see section \ref specialblock).
|
|
Packit Service |
50c9f2 |
You generate a configuration file (see section \ref config) by
|
|
Packit Service |
50c9f2 |
calling doxygen with the \c -g option:
|
|
Packit Service |
50c9f2 |
\verbatim
|
|
Packit Service |
50c9f2 |
doxygen -g <config_file>
|
|
Packit Service |
50c9f2 |
\endverbatim
|
|
Packit Service |
50c9f2 |
You edit the configuration file so it matches your project.
|
|
Packit Service |
50c9f2 |
In the configuration file you can specify the input files and
|
|
Packit Service |
50c9f2 |
a lot of optional information.
|
|
Packit Service |
50c9f2 |
You let doxygen generate the documentation, based on the settings in the
|
|
Packit Service |
50c9f2 |
configuration file:
|
|
Packit Service |
50c9f2 |
\verbatim
|
|
Packit Service |
50c9f2 |
doxygen <config_file>
|
|
Packit Service |
50c9f2 |
\endverbatim
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
If you have a configuration file generated with an older version of
|
|
Packit Service |
50c9f2 |
doxygen, you can upgrade it to the current version by running doxygen
|
|
Packit Service |
50c9f2 |
with the -u option.
|
|
Packit Service |
50c9f2 |
\verbatim
|
|
Packit Service |
50c9f2 |
doxygen -u <config_file>
|
|
Packit Service |
50c9f2 |
\endverbatim
|
|
Packit Service |
50c9f2 |
All configuration settings in the original configuration file will be copied
|
|
Packit Service |
50c9f2 |
to the new configuration file. Any new options will have their default value.
|
|
Packit Service |
50c9f2 |
Note that comments that you may have added in the original configuration file
|
|
Packit Service |
50c9f2 |
will be lost.
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
\section doxygen_finetune Fine-tuning the output
|
|
Packit Service |
50c9f2 |
If you want to fine-tune the way the output looks, doxygen allows you
|
|
Packit Service |
50c9f2 |
generate default style sheet, header, and footer files that you can edit
|
|
Packit Service |
50c9f2 |
afterwards:
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
For HTML output, you can generate the default header file
|
|
Packit Service |
50c9f2 |
(see \ref cfg_html_header "HTML_HEADER"), the default footer
|
|
Packit Service |
50c9f2 |
(see \ref cfg_html_footer "HTML_FOOTER"), and the default style
|
|
Packit Service |
50c9f2 |
sheet (see \ref cfg_html_stylesheet "HTML_STYLESHEET"), using the
|
|
Packit Service |
50c9f2 |
following command:
|
|
Packit Service |
50c9f2 |
\verbatim
|
|
Packit Service |
50c9f2 |
doxygen -w html header.html footer.html stylesheet.css <config_file>
|
|
Packit Service |
50c9f2 |
\endverbatim
|
|
Packit Service |
50c9f2 |
The `config_file` is optional. When omitted doxygen will search for
|
|
Packit Service |
50c9f2 |
a file named `Doxyfile` and process that. When this is also not found it
|
|
Packit Service |
50c9f2 |
will used the default settings.
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
For \LaTeX output, you can generate the first and last part of \c refman.tex
|
|
Packit Service |
50c9f2 |
(see \ref cfg_latex_header "LATEX_HEADER" and
|
|
Packit Service |
50c9f2 |
\ref cfg_latex_footer "LATEX_FOOTER") and the style sheet included
|
|
Packit Service |
50c9f2 |
by that header (normally doxygen.sty ), using the following
|
|
Packit Service |
50c9f2 |
command:
|
|
Packit Service |
50c9f2 |
\verbatim
|
|
Packit Service |
50c9f2 |
doxygen -w latex header.tex footer.tex doxygen.sty <config_file>
|
|
Packit Service |
50c9f2 |
\endverbatim
|
|
Packit Service |
50c9f2 |
If you need non-default options (for instance to use extra \LaTeX packages)
|
|
Packit Service |
50c9f2 |
you need to make a config file with those options set correctly and then specify
|
|
Packit Service |
50c9f2 |
that config file after the generated files (make a backup of the configuration
|
|
Packit Service |
50c9f2 |
file first so you don't loose it in case you forget to specify one of the
|
|
Packit Service |
50c9f2 |
output files).
|
|
Packit Service |
50c9f2 |
For RTF output, you can generate the default style sheet file (see
|
|
Packit Service |
50c9f2 |
\ref cfg_rtf_stylesheet_file "RTF_STYLESHEET_FILE") using:
|
|
Packit Service |
50c9f2 |
\verbatim
|
|
Packit Service |
50c9f2 |
doxygen -w rtf rtfstyle.cfg
|
|
Packit Service |
50c9f2 |
\endverbatim
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
\warning When using a custom header you are responsible
|
|
Packit Service |
50c9f2 |
for the proper inclusion of any scripts and style sheets that doxygen
|
|
Packit Service |
50c9f2 |
needs, which is dependent on the configuration options and may changes
|
|
Packit Service |
50c9f2 |
when upgrading to a new doxygen release.
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
\note
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
If you do not want documentation for each item inside the configuration
|
|
Packit Service |
50c9f2 |
file then you can use the optional \c -s option. This can use be
|
|
Packit Service |
50c9f2 |
used in combination with the \c -u option, to add or strip the
|
|
Packit Service |
50c9f2 |
documentation from an existing configuration file.
|
|
Packit Service |
50c9f2 |
Please use the \c -s option if you send me a configuration file
|
|
Packit Service |
50c9f2 |
as part of a bug report!
|
|
Packit Service |
50c9f2 |
To make doxygen read/write to standard input/output instead of from/to
|
|
Packit Service |
50c9f2 |
a file, use \c - for the file name.
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
\htmlonly
|
|
Packit Service |
50c9f2 |
Go to the next section or return to the
|
|
Packit Service |
50c9f2 |
index.
|
|
Packit Service |
50c9f2 |
\endhtmlonly
|
|
Packit Service |
50c9f2 |
|
|
Packit Service |
50c9f2 |
*/
|