xref: /llvm-project/openmp/docs/doxygen.cfg.in (revision eadf6db585e1f018e30d9c8de4b32c5d78468e19)
118dff289SGiorgis Georgakoudis# Doxyfile 1.8.6
218dff289SGiorgis Georgakoudis
318dff289SGiorgis Georgakoudis# This file describes the settings to be used by the documentation system
418dff289SGiorgis Georgakoudis# doxygen (www.doxygen.org) for a project.
518dff289SGiorgis Georgakoudis#
618dff289SGiorgis Georgakoudis# All text after a double hash (##) is considered a comment and is placed in
718dff289SGiorgis Georgakoudis# front of the TAG it is preceding.
818dff289SGiorgis Georgakoudis#
918dff289SGiorgis Georgakoudis# All text after a single hash (#) is considered a comment and will be ignored.
1018dff289SGiorgis Georgakoudis# The format is:
1118dff289SGiorgis Georgakoudis# TAG = value [value, ...]
1218dff289SGiorgis Georgakoudis# For lists, items can also be appended using:
1318dff289SGiorgis Georgakoudis# TAG += value [value, ...]
1418dff289SGiorgis Georgakoudis# Values that contain spaces should be placed between quotes (\" \").
1518dff289SGiorgis Georgakoudis
1618dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
1718dff289SGiorgis Georgakoudis# Project related configuration options
1818dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
1918dff289SGiorgis Georgakoudis
2018dff289SGiorgis Georgakoudis# This tag specifies the encoding used for all characters in the config file
2118dff289SGiorgis Georgakoudis# that follow. The default is UTF-8 which is also the encoding used for all text
2218dff289SGiorgis Georgakoudis# before the first occurrence of this tag. Doxygen uses libiconv (or the iconv
2318dff289SGiorgis Georgakoudis# built into libc) for the transcoding. See http://www.gnu.org/software/libiconv
2418dff289SGiorgis Georgakoudis# for the list of possible encodings.
2518dff289SGiorgis Georgakoudis# The default value is: UTF-8.
2618dff289SGiorgis Georgakoudis
2718dff289SGiorgis GeorgakoudisDOXYFILE_ENCODING      = UTF-8
2818dff289SGiorgis Georgakoudis
2918dff289SGiorgis Georgakoudis# The PROJECT_NAME tag is a single word (or a sequence of words surrounded by
3018dff289SGiorgis Georgakoudis# double-quotes, unless you are using Doxywizard) that should identify the
3118dff289SGiorgis Georgakoudis# project for which the documentation is generated. This name is used in the
3218dff289SGiorgis Georgakoudis# title of most generated pages and in a few other places.
3318dff289SGiorgis Georgakoudis# The default value is: My Project.
3418dff289SGiorgis Georgakoudis
3518dff289SGiorgis GeorgakoudisPROJECT_NAME           = "LLVM OpenMP"
3618dff289SGiorgis Georgakoudis
3718dff289SGiorgis Georgakoudis# The PROJECT_NUMBER tag can be used to enter a project or revision number. This
3818dff289SGiorgis Georgakoudis# could be handy for archiving the generated documentation or if some version
3918dff289SGiorgis Georgakoudis# control system is used.
4018dff289SGiorgis Georgakoudis
4118dff289SGiorgis GeorgakoudisPROJECT_NUMBER         = @PACKAGE_VERSION@
4218dff289SGiorgis Georgakoudis
4318dff289SGiorgis Georgakoudis# Using the PROJECT_BRIEF tag one can provide an optional one line description
4418dff289SGiorgis Georgakoudis# for a project that appears at the top of each page and should give viewer a
4518dff289SGiorgis Georgakoudis# quick idea about the purpose of the project. Keep the description short.
4618dff289SGiorgis Georgakoudis
4718dff289SGiorgis GeorgakoudisPROJECT_BRIEF          =
4818dff289SGiorgis Georgakoudis
4918dff289SGiorgis Georgakoudis# With the PROJECT_LOGO tag one can specify an logo or icon that is included in
5018dff289SGiorgis Georgakoudis# the documentation. The maximum height of the logo should not exceed 55 pixels
5118dff289SGiorgis Georgakoudis# and the maximum width should not exceed 200 pixels. Doxygen will copy the logo
5218dff289SGiorgis Georgakoudis# to the output directory.
5318dff289SGiorgis Georgakoudis
5418dff289SGiorgis GeorgakoudisPROJECT_LOGO           =
5518dff289SGiorgis Georgakoudis
5618dff289SGiorgis Georgakoudis# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
5718dff289SGiorgis Georgakoudis# into which the generated documentation will be written. If a relative path is
5818dff289SGiorgis Georgakoudis# entered, it will be relative to the location where doxygen was started. If
5918dff289SGiorgis Georgakoudis# left blank the current directory will be used.
6018dff289SGiorgis Georgakoudis
6118dff289SGiorgis GeorgakoudisOUTPUT_DIRECTORY       = @abs_builddir@/doxygen
6218dff289SGiorgis Georgakoudis
6318dff289SGiorgis Georgakoudis# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 4096 sub-
6418dff289SGiorgis Georgakoudis# directories (in 2 levels) under the output directory of each output format and
6518dff289SGiorgis Georgakoudis# will distribute the generated files over these directories. Enabling this
6618dff289SGiorgis Georgakoudis# option can be useful when feeding doxygen a huge amount of source files, where
6718dff289SGiorgis Georgakoudis# putting all generated files in the same directory would otherwise causes
6818dff289SGiorgis Georgakoudis# performance problems for the file system.
6918dff289SGiorgis Georgakoudis# The default value is: NO.
7018dff289SGiorgis Georgakoudis
7118dff289SGiorgis GeorgakoudisCREATE_SUBDIRS         = NO
7218dff289SGiorgis Georgakoudis
7318dff289SGiorgis Georgakoudis# The OUTPUT_LANGUAGE tag is used to specify the language in which all
7418dff289SGiorgis Georgakoudis# documentation generated by doxygen is written. Doxygen will use this
7518dff289SGiorgis Georgakoudis# information to generate all constant output in the proper language.
7618dff289SGiorgis Georgakoudis# Possible values are: Afrikaans, Arabic, Armenian, Brazilian, Catalan, Chinese,
7718dff289SGiorgis Georgakoudis# Chinese-Traditional, Croatian, Czech, Danish, Dutch, English (United States),
7818dff289SGiorgis Georgakoudis# Esperanto, Farsi (Persian), Finnish, French, German, Greek, Hungarian,
7918dff289SGiorgis Georgakoudis# Indonesian, Italian, Japanese, Japanese-en (Japanese with English messages),
8018dff289SGiorgis Georgakoudis# Korean, Korean-en (Korean with English messages), Latvian, Lithuanian,
8118dff289SGiorgis Georgakoudis# Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese, Romanian, Russian,
8218dff289SGiorgis Georgakoudis# Serbian, Serbian-Cyrillic, Slovak, Slovene, Spanish, Swedish, Turkish,
8318dff289SGiorgis Georgakoudis# Ukrainian and Vietnamese.
8418dff289SGiorgis Georgakoudis# The default value is: English.
8518dff289SGiorgis Georgakoudis
8618dff289SGiorgis GeorgakoudisOUTPUT_LANGUAGE        = English
8718dff289SGiorgis Georgakoudis
8818dff289SGiorgis Georgakoudis# If the BRIEF_MEMBER_DESC tag is set to YES doxygen will include brief member
8918dff289SGiorgis Georgakoudis# descriptions after the members that are listed in the file and class
9018dff289SGiorgis Georgakoudis# documentation (similar to Javadoc). Set to NO to disable this.
9118dff289SGiorgis Georgakoudis# The default value is: YES.
9218dff289SGiorgis Georgakoudis
9318dff289SGiorgis GeorgakoudisBRIEF_MEMBER_DESC      = YES
9418dff289SGiorgis Georgakoudis
9518dff289SGiorgis Georgakoudis# If the REPEAT_BRIEF tag is set to YES doxygen will prepend the brief
9618dff289SGiorgis Georgakoudis# description of a member or function before the detailed description
9718dff289SGiorgis Georgakoudis#
9818dff289SGiorgis Georgakoudis# Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
9918dff289SGiorgis Georgakoudis# brief descriptions will be completely suppressed.
10018dff289SGiorgis Georgakoudis# The default value is: YES.
10118dff289SGiorgis Georgakoudis
10218dff289SGiorgis GeorgakoudisREPEAT_BRIEF           = YES
10318dff289SGiorgis Georgakoudis
10418dff289SGiorgis Georgakoudis# This tag implements a quasi-intelligent brief description abbreviator that is
10518dff289SGiorgis Georgakoudis# used to form the text in various listings. Each string in this list, if found
10618dff289SGiorgis Georgakoudis# as the leading text of the brief description, will be stripped from the text
10718dff289SGiorgis Georgakoudis# and the result, after processing the whole list, is used as the annotated
10818dff289SGiorgis Georgakoudis# text. Otherwise, the brief description is used as-is. If left blank, the
10918dff289SGiorgis Georgakoudis# following values are used ($name is automatically replaced with the name of
11018dff289SGiorgis Georgakoudis# the entity):The $name class, The $name widget, The $name file, is, provides,
11118dff289SGiorgis Georgakoudis# specifies, contains, represents, a, an and the.
11218dff289SGiorgis Georgakoudis
11318dff289SGiorgis GeorgakoudisABBREVIATE_BRIEF       =
11418dff289SGiorgis Georgakoudis
11518dff289SGiorgis Georgakoudis# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
11618dff289SGiorgis Georgakoudis# doxygen will generate a detailed section even if there is only a brief
11718dff289SGiorgis Georgakoudis# description.
11818dff289SGiorgis Georgakoudis# The default value is: NO.
11918dff289SGiorgis Georgakoudis
12018dff289SGiorgis GeorgakoudisALWAYS_DETAILED_SEC    = NO
12118dff289SGiorgis Georgakoudis
12218dff289SGiorgis Georgakoudis# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
12318dff289SGiorgis Georgakoudis# inherited members of a class in the documentation of that class as if those
12418dff289SGiorgis Georgakoudis# members were ordinary class members. Constructors, destructors and assignment
12518dff289SGiorgis Georgakoudis# operators of the base classes will not be shown.
12618dff289SGiorgis Georgakoudis# The default value is: NO.
12718dff289SGiorgis Georgakoudis
12818dff289SGiorgis GeorgakoudisINLINE_INHERITED_MEMB  = NO
12918dff289SGiorgis Georgakoudis
13018dff289SGiorgis Georgakoudis# If the FULL_PATH_NAMES tag is set to YES doxygen will prepend the full path
13118dff289SGiorgis Georgakoudis# before files name in the file list and in the header files. If set to NO the
13218dff289SGiorgis Georgakoudis# shortest path that makes the file name unique will be used
13318dff289SGiorgis Georgakoudis# The default value is: YES.
13418dff289SGiorgis Georgakoudis
13518dff289SGiorgis GeorgakoudisFULL_PATH_NAMES        = YES
13618dff289SGiorgis Georgakoudis
13718dff289SGiorgis Georgakoudis# The STRIP_FROM_PATH tag can be used to strip a user-defined part of the path.
13818dff289SGiorgis Georgakoudis# Stripping is only done if one of the specified strings matches the left-hand
13918dff289SGiorgis Georgakoudis# part of the path. The tag can be used to show relative paths in the file list.
14018dff289SGiorgis Georgakoudis# If left blank the directory from which doxygen is run is used as the path to
14118dff289SGiorgis Georgakoudis# strip.
14218dff289SGiorgis Georgakoudis#
14318dff289SGiorgis Georgakoudis# Note that you can specify absolute paths here, but also relative paths, which
14418dff289SGiorgis Georgakoudis# will be relative from the directory where doxygen is started.
14518dff289SGiorgis Georgakoudis# This tag requires that the tag FULL_PATH_NAMES is set to YES.
14618dff289SGiorgis Georgakoudis
14718dff289SGiorgis GeorgakoudisSTRIP_FROM_PATH        = @abs_srcdir@/..
14818dff289SGiorgis Georgakoudis
14918dff289SGiorgis Georgakoudis# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of the
15018dff289SGiorgis Georgakoudis# path mentioned in the documentation of a class, which tells the reader which
15118dff289SGiorgis Georgakoudis# header file to include in order to use a class. If left blank only the name of
15218dff289SGiorgis Georgakoudis# the header file containing the class definition is used. Otherwise one should
15318dff289SGiorgis Georgakoudis# specify the list of include paths that are normally passed to the compiler
15418dff289SGiorgis Georgakoudis# using the -I flag.
15518dff289SGiorgis Georgakoudis
15618dff289SGiorgis GeorgakoudisSTRIP_FROM_INC_PATH    = @abs_srcdir@/../include
15718dff289SGiorgis Georgakoudis
15818dff289SGiorgis Georgakoudis# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but
15918dff289SGiorgis Georgakoudis# less readable) file names. This can be useful is your file systems doesn't
16018dff289SGiorgis Georgakoudis# support long names like on DOS, Mac, or CD-ROM.
16118dff289SGiorgis Georgakoudis# The default value is: NO.
16218dff289SGiorgis Georgakoudis
16318dff289SGiorgis GeorgakoudisSHORT_NAMES            = NO
16418dff289SGiorgis Georgakoudis
16518dff289SGiorgis Georgakoudis# If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the
16618dff289SGiorgis Georgakoudis# first line (until the first dot) of a Javadoc-style comment as the brief
16718dff289SGiorgis Georgakoudis# description. If set to NO, the Javadoc-style will behave just like regular Qt-
16818dff289SGiorgis Georgakoudis# style comments (thus requiring an explicit @brief command for a brief
16918dff289SGiorgis Georgakoudis# description.)
17018dff289SGiorgis Georgakoudis# The default value is: NO.
17118dff289SGiorgis Georgakoudis
17218dff289SGiorgis GeorgakoudisJAVADOC_AUTOBRIEF      = YES
17318dff289SGiorgis Georgakoudis
17418dff289SGiorgis Georgakoudis# If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
17518dff289SGiorgis Georgakoudis# line (until the first dot) of a Qt-style comment as the brief description. If
17618dff289SGiorgis Georgakoudis# set to NO, the Qt-style will behave just like regular Qt-style comments (thus
17718dff289SGiorgis Georgakoudis# requiring an explicit command for a brief description.)
17818dff289SGiorgis Georgakoudis# The default value is: NO.
17918dff289SGiorgis Georgakoudis
18018dff289SGiorgis GeorgakoudisQT_AUTOBRIEF           = YES
18118dff289SGiorgis Georgakoudis
18218dff289SGiorgis Georgakoudis# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a
18318dff289SGiorgis Georgakoudis# multi-line C++ special comment block (i.e. a block of //! or /// comments) as
18418dff289SGiorgis Georgakoudis# a brief description. This used to be the default behavior. The new default is
18518dff289SGiorgis Georgakoudis# to treat a multi-line C++ comment block as a detailed description. Set this
18618dff289SGiorgis Georgakoudis# tag to YES if you prefer the old behavior instead.
18718dff289SGiorgis Georgakoudis#
18818dff289SGiorgis Georgakoudis# Note that setting this tag to YES also means that rational rose comments are
18918dff289SGiorgis Georgakoudis# not recognized any more.
19018dff289SGiorgis Georgakoudis# The default value is: NO.
19118dff289SGiorgis Georgakoudis
19218dff289SGiorgis GeorgakoudisMULTILINE_CPP_IS_BRIEF = NO
19318dff289SGiorgis Georgakoudis
19418dff289SGiorgis Georgakoudis# If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the
19518dff289SGiorgis Georgakoudis# documentation from any documented member that it re-implements.
19618dff289SGiorgis Georgakoudis# The default value is: YES.
19718dff289SGiorgis Georgakoudis
19818dff289SGiorgis GeorgakoudisINHERIT_DOCS           = YES
19918dff289SGiorgis Georgakoudis
20018dff289SGiorgis Georgakoudis# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce a
20118dff289SGiorgis Georgakoudis# new page for each member. If set to NO, the documentation of a member will be
20218dff289SGiorgis Georgakoudis# part of the file/class/namespace that contains it.
20318dff289SGiorgis Georgakoudis# The default value is: NO.
20418dff289SGiorgis Georgakoudis
20518dff289SGiorgis GeorgakoudisSEPARATE_MEMBER_PAGES  = NO
20618dff289SGiorgis Georgakoudis
20718dff289SGiorgis Georgakoudis# The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen
20818dff289SGiorgis Georgakoudis# uses this value to replace tabs by spaces in code fragments.
20918dff289SGiorgis Georgakoudis# Minimum value: 1, maximum value: 16, default value: 4.
21018dff289SGiorgis Georgakoudis
21118dff289SGiorgis GeorgakoudisTAB_SIZE               = 2
21218dff289SGiorgis Georgakoudis
21318dff289SGiorgis Georgakoudis# This tag can be used to specify a number of aliases that act as commands in
21418dff289SGiorgis Georgakoudis# the documentation. An alias has the form:
21518dff289SGiorgis Georgakoudis# name=value
21618dff289SGiorgis Georgakoudis# For example adding
21718dff289SGiorgis Georgakoudis# "sideeffect=@par Side Effects:\n"
21818dff289SGiorgis Georgakoudis# will allow you to put the command \sideeffect (or @sideeffect) in the
21918dff289SGiorgis Georgakoudis# documentation, which will result in a user-defined paragraph with heading
22018dff289SGiorgis Georgakoudis# "Side Effects:". You can put \n's in the value part of an alias to insert
22118dff289SGiorgis Georgakoudis# newlines.
22218dff289SGiorgis Georgakoudis
22318dff289SGiorgis GeorgakoudisALIASES                =
22418dff289SGiorgis Georgakoudis
22518dff289SGiorgis Georgakoudis# This tag can be used to specify a number of word-keyword mappings (TCL only).
22618dff289SGiorgis Georgakoudis# A mapping has the form "name=value". For example adding "class=itcl::class"
22718dff289SGiorgis Georgakoudis# will allow you to use the command class in the itcl::class meaning.
22818dff289SGiorgis Georgakoudis
22918dff289SGiorgis GeorgakoudisTCL_SUBST              =
23018dff289SGiorgis Georgakoudis
23118dff289SGiorgis Georgakoudis# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources
23218dff289SGiorgis Georgakoudis# only. Doxygen will then generate output that is more tailored for C. For
23318dff289SGiorgis Georgakoudis# instance, some of the names that are used will be different. The list of all
23418dff289SGiorgis Georgakoudis# members will be omitted, etc.
23518dff289SGiorgis Georgakoudis# The default value is: NO.
23618dff289SGiorgis Georgakoudis
23718dff289SGiorgis GeorgakoudisOPTIMIZE_OUTPUT_FOR_C  = NO
23818dff289SGiorgis Georgakoudis
23918dff289SGiorgis Georgakoudis# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java or
24018dff289SGiorgis Georgakoudis# Python sources only. Doxygen will then generate output that is more tailored
24118dff289SGiorgis Georgakoudis# for that language. For instance, namespaces will be presented as packages,
24218dff289SGiorgis Georgakoudis# qualified scopes will look different, etc.
24318dff289SGiorgis Georgakoudis# The default value is: NO.
24418dff289SGiorgis Georgakoudis
24518dff289SGiorgis GeorgakoudisOPTIMIZE_OUTPUT_JAVA   = NO
24618dff289SGiorgis Georgakoudis
24718dff289SGiorgis Georgakoudis# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
24818dff289SGiorgis Georgakoudis# sources. Doxygen will then generate output that is tailored for Fortran.
24918dff289SGiorgis Georgakoudis# The default value is: NO.
25018dff289SGiorgis Georgakoudis
25118dff289SGiorgis GeorgakoudisOPTIMIZE_FOR_FORTRAN   = NO
25218dff289SGiorgis Georgakoudis
25318dff289SGiorgis Georgakoudis# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
25418dff289SGiorgis Georgakoudis# sources. Doxygen will then generate output that is tailored for VHDL.
25518dff289SGiorgis Georgakoudis# The default value is: NO.
25618dff289SGiorgis Georgakoudis
25718dff289SGiorgis GeorgakoudisOPTIMIZE_OUTPUT_VHDL   = NO
25818dff289SGiorgis Georgakoudis
25918dff289SGiorgis Georgakoudis# Doxygen selects the parser to use depending on the extension of the files it
26018dff289SGiorgis Georgakoudis# parses. With this tag you can assign which parser to use for a given
26118dff289SGiorgis Georgakoudis# extension. Doxygen has a built-in mapping, but you can override or extend it
26218dff289SGiorgis Georgakoudis# using this tag. The format is ext=language, where ext is a file extension, and
26318dff289SGiorgis Georgakoudis# language is one of the parsers supported by doxygen: IDL, Java, Javascript,
26418dff289SGiorgis Georgakoudis# C#, C, C++, D, PHP, Objective-C, Python, Fortran, VHDL. For instance to make
26518dff289SGiorgis Georgakoudis# doxygen treat .inc files as Fortran files (default is PHP), and .f files as C
26618dff289SGiorgis Georgakoudis# (default is Fortran), use: inc=Fortran f=C.
26718dff289SGiorgis Georgakoudis#
26818dff289SGiorgis Georgakoudis# Note For files without extension you can use no_extension as a placeholder.
26918dff289SGiorgis Georgakoudis#
27018dff289SGiorgis Georgakoudis# Note that for custom extensions you also need to set FILE_PATTERNS otherwise
27118dff289SGiorgis Georgakoudis# the files are not read by doxygen.
27218dff289SGiorgis Georgakoudis
27318dff289SGiorgis GeorgakoudisEXTENSION_MAPPING      =
27418dff289SGiorgis Georgakoudis
27518dff289SGiorgis Georgakoudis# If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments
27618dff289SGiorgis Georgakoudis# according to the Markdown format, which allows for more readable
27718dff289SGiorgis Georgakoudis# documentation. See http://daringfireball.net/projects/markdown/ for details.
27818dff289SGiorgis Georgakoudis# The output of markdown processing is further processed by doxygen, so you can
27918dff289SGiorgis Georgakoudis# mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in
28018dff289SGiorgis Georgakoudis# case of backward compatibilities issues.
28118dff289SGiorgis Georgakoudis# The default value is: YES.
28218dff289SGiorgis Georgakoudis
28318dff289SGiorgis GeorgakoudisMARKDOWN_SUPPORT       = YES
28418dff289SGiorgis Georgakoudis
28518dff289SGiorgis Georgakoudis# When enabled doxygen tries to link words that correspond to documented
28618dff289SGiorgis Georgakoudis# classes, or namespaces to their corresponding documentation. Such a link can
28718dff289SGiorgis Georgakoudis# be prevented in individual cases by putting a % sign in front of the word
28818dff289SGiorgis Georgakoudis# or globally by setting AUTOLINK_SUPPORT to NO.
28918dff289SGiorgis Georgakoudis# The default value is: YES.
29018dff289SGiorgis Georgakoudis
29118dff289SGiorgis GeorgakoudisAUTOLINK_SUPPORT       = YES
29218dff289SGiorgis Georgakoudis
29318dff289SGiorgis Georgakoudis# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
29418dff289SGiorgis Georgakoudis# to include (a tag file for) the STL sources as input, then you should set this
29518dff289SGiorgis Georgakoudis# tag to YES in order to let doxygen match functions declarations and
29618dff289SGiorgis Georgakoudis# definitions whose arguments contain STL classes (e.g. func(std::string);
29718dff289SGiorgis Georgakoudis# versus func(std::string) {}). This also make the inheritance and collaboration
29818dff289SGiorgis Georgakoudis# diagrams that involve STL classes more complete and accurate.
29918dff289SGiorgis Georgakoudis# The default value is: NO.
30018dff289SGiorgis Georgakoudis
30118dff289SGiorgis GeorgakoudisBUILTIN_STL_SUPPORT    = NO
30218dff289SGiorgis Georgakoudis
30318dff289SGiorgis Georgakoudis# If you use Microsoft's C++/CLI language, you should set this option to YES to
30418dff289SGiorgis Georgakoudis# enable parsing support.
30518dff289SGiorgis Georgakoudis# The default value is: NO.
30618dff289SGiorgis Georgakoudis
30718dff289SGiorgis GeorgakoudisCPP_CLI_SUPPORT        = NO
30818dff289SGiorgis Georgakoudis
30918dff289SGiorgis Georgakoudis# Set the SIP_SUPPORT tag to YES if your project consists of sip (see:
31018dff289SGiorgis Georgakoudis# http://www.riverbankcomputing.co.uk/software/sip/intro) sources only. Doxygen
31118dff289SGiorgis Georgakoudis# will parse them like normal C++ but will assume all classes use public instead
31218dff289SGiorgis Georgakoudis# of private inheritance when no explicit protection keyword is present.
31318dff289SGiorgis Georgakoudis# The default value is: NO.
31418dff289SGiorgis Georgakoudis
31518dff289SGiorgis GeorgakoudisSIP_SUPPORT            = NO
31618dff289SGiorgis Georgakoudis
31718dff289SGiorgis Georgakoudis# For Microsoft's IDL there are propget and propput attributes to indicate
31818dff289SGiorgis Georgakoudis# getter and setter methods for a property. Setting this option to YES will make
31918dff289SGiorgis Georgakoudis# doxygen to replace the get and set methods by a property in the documentation.
32018dff289SGiorgis Georgakoudis# This will only work if the methods are indeed getting or setting a simple
32118dff289SGiorgis Georgakoudis# type. If this is not the case, or you want to show the methods anyway, you
32218dff289SGiorgis Georgakoudis# should set this option to NO.
32318dff289SGiorgis Georgakoudis# The default value is: YES.
32418dff289SGiorgis Georgakoudis
32518dff289SGiorgis GeorgakoudisIDL_PROPERTY_SUPPORT   = YES
32618dff289SGiorgis Georgakoudis
32718dff289SGiorgis Georgakoudis# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
32818dff289SGiorgis Georgakoudis# tag is set to YES, then doxygen will reuse the documentation of the first
32918dff289SGiorgis Georgakoudis# member in the group (if any) for the other members of the group. By default
33018dff289SGiorgis Georgakoudis# all members of a group must be documented explicitly.
33118dff289SGiorgis Georgakoudis# The default value is: NO.
33218dff289SGiorgis Georgakoudis
33318dff289SGiorgis GeorgakoudisDISTRIBUTE_GROUP_DOC   = NO
33418dff289SGiorgis Georgakoudis
33518dff289SGiorgis Georgakoudis# Set the SUBGROUPING tag to YES to allow class member groups of the same type
33618dff289SGiorgis Georgakoudis# (for instance a group of public functions) to be put as a subgroup of that
33718dff289SGiorgis Georgakoudis# type (e.g. under the Public Functions section). Set it to NO to prevent
33818dff289SGiorgis Georgakoudis# subgrouping. Alternatively, this can be done per class using the
33918dff289SGiorgis Georgakoudis# \nosubgrouping command.
34018dff289SGiorgis Georgakoudis# The default value is: YES.
34118dff289SGiorgis Georgakoudis
34218dff289SGiorgis GeorgakoudisSUBGROUPING            = YES
34318dff289SGiorgis Georgakoudis
34418dff289SGiorgis Georgakoudis# When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and unions
34518dff289SGiorgis Georgakoudis# are shown inside the group in which they are included (e.g. using \ingroup)
34618dff289SGiorgis Georgakoudis# instead of on a separate page (for HTML and Man pages) or section (for LaTeX
34718dff289SGiorgis Georgakoudis# and RTF).
34818dff289SGiorgis Georgakoudis#
34918dff289SGiorgis Georgakoudis# Note that this feature does not work in combination with
35018dff289SGiorgis Georgakoudis# SEPARATE_MEMBER_PAGES.
35118dff289SGiorgis Georgakoudis# The default value is: NO.
35218dff289SGiorgis Georgakoudis
35318dff289SGiorgis GeorgakoudisINLINE_GROUPED_CLASSES = NO
35418dff289SGiorgis Georgakoudis
35518dff289SGiorgis Georgakoudis# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions
35618dff289SGiorgis Georgakoudis# with only public data fields or simple typedef fields will be shown inline in
35718dff289SGiorgis Georgakoudis# the documentation of the scope in which they are defined (i.e. file,
35818dff289SGiorgis Georgakoudis# namespace, or group documentation), provided this scope is documented. If set
35918dff289SGiorgis Georgakoudis# to NO, structs, classes, and unions are shown on a separate page (for HTML and
36018dff289SGiorgis Georgakoudis# Man pages) or section (for LaTeX and RTF).
36118dff289SGiorgis Georgakoudis# The default value is: NO.
36218dff289SGiorgis Georgakoudis
36318dff289SGiorgis GeorgakoudisINLINE_SIMPLE_STRUCTS  = NO
36418dff289SGiorgis Georgakoudis
36518dff289SGiorgis Georgakoudis# When TYPEDEF_HIDES_STRUCT tag is enabled, a typedef of a struct, union, or
36618dff289SGiorgis Georgakoudis# enum is documented as struct, union, or enum with the name of the typedef. So
36718dff289SGiorgis Georgakoudis# typedef struct TypeS {} TypeT, will appear in the documentation as a struct
36818dff289SGiorgis Georgakoudis# with name TypeT. When disabled the typedef will appear as a member of a file,
36918dff289SGiorgis Georgakoudis# namespace, or class. And the struct will be named TypeS. This can typically be
37018dff289SGiorgis Georgakoudis# useful for C code in case the coding convention dictates that all compound
37118dff289SGiorgis Georgakoudis# types are typedef'ed and only the typedef is referenced, never the tag name.
37218dff289SGiorgis Georgakoudis# The default value is: NO.
37318dff289SGiorgis Georgakoudis
37418dff289SGiorgis GeorgakoudisTYPEDEF_HIDES_STRUCT   = NO
37518dff289SGiorgis Georgakoudis
37618dff289SGiorgis Georgakoudis# The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This
37718dff289SGiorgis Georgakoudis# cache is used to resolve symbols given their name and scope. Since this can be
37818dff289SGiorgis Georgakoudis# an expensive process and often the same symbol appears multiple times in the
37918dff289SGiorgis Georgakoudis# code, doxygen keeps a cache of pre-resolved symbols. If the cache is too small
38018dff289SGiorgis Georgakoudis# doxygen will become slower. If the cache is too large, memory is wasted. The
38118dff289SGiorgis Georgakoudis# cache size is given by this formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range
38218dff289SGiorgis Georgakoudis# is 0..9, the default is 0, corresponding to a cache size of 2^16=65536
38318dff289SGiorgis Georgakoudis# symbols. At the end of a run doxygen will report the cache usage and suggest
38418dff289SGiorgis Georgakoudis# the optimal cache size from a speed point of view.
38518dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 9, default value: 0.
38618dff289SGiorgis Georgakoudis
38718dff289SGiorgis GeorgakoudisLOOKUP_CACHE_SIZE      = 3
38818dff289SGiorgis Georgakoudis
38918dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
39018dff289SGiorgis Georgakoudis# Build related configuration options
39118dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
39218dff289SGiorgis Georgakoudis
39318dff289SGiorgis Georgakoudis# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
39418dff289SGiorgis Georgakoudis# documentation are documented, even if no documentation was available. Private
39518dff289SGiorgis Georgakoudis# class members and static file members will be hidden unless the
39618dff289SGiorgis Georgakoudis# EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES.
39718dff289SGiorgis Georgakoudis# Note: This will also disable the warnings about undocumented members that are
39818dff289SGiorgis Georgakoudis# normally produced when WARNINGS is set to YES.
39918dff289SGiorgis Georgakoudis# The default value is: NO.
40018dff289SGiorgis Georgakoudis
40118dff289SGiorgis GeorgakoudisEXTRACT_ALL            = YES
40218dff289SGiorgis Georgakoudis
40318dff289SGiorgis Georgakoudis# If the EXTRACT_PRIVATE tag is set to YES all private members of a class will
40418dff289SGiorgis Georgakoudis# be included in the documentation.
40518dff289SGiorgis Georgakoudis# The default value is: NO.
40618dff289SGiorgis Georgakoudis
40718dff289SGiorgis GeorgakoudisEXTRACT_PRIVATE        = NO
40818dff289SGiorgis Georgakoudis
40918dff289SGiorgis Georgakoudis# If the EXTRACT_PACKAGE tag is set to YES all members with package or internal
41018dff289SGiorgis Georgakoudis# scope will be included in the documentation.
41118dff289SGiorgis Georgakoudis# The default value is: NO.
41218dff289SGiorgis Georgakoudis
41318dff289SGiorgis GeorgakoudisEXTRACT_PACKAGE        = NO
41418dff289SGiorgis Georgakoudis
41518dff289SGiorgis Georgakoudis# If the EXTRACT_STATIC tag is set to YES all static members of a file will be
41618dff289SGiorgis Georgakoudis# included in the documentation.
41718dff289SGiorgis Georgakoudis# The default value is: NO.
41818dff289SGiorgis Georgakoudis
41918dff289SGiorgis GeorgakoudisEXTRACT_STATIC         = YES
42018dff289SGiorgis Georgakoudis
42118dff289SGiorgis Georgakoudis# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) defined
42218dff289SGiorgis Georgakoudis# locally in source files will be included in the documentation. If set to NO
42318dff289SGiorgis Georgakoudis# only classes defined in header files are included. Does not have any effect
42418dff289SGiorgis Georgakoudis# for Java sources.
42518dff289SGiorgis Georgakoudis# The default value is: YES.
42618dff289SGiorgis Georgakoudis
42718dff289SGiorgis GeorgakoudisEXTRACT_LOCAL_CLASSES  = YES
42818dff289SGiorgis Georgakoudis
42918dff289SGiorgis Georgakoudis# This flag is only useful for Objective-C code. When set to YES local methods,
43018dff289SGiorgis Georgakoudis# which are defined in the implementation section but not in the interface are
43118dff289SGiorgis Georgakoudis# included in the documentation. If set to NO only methods in the interface are
43218dff289SGiorgis Georgakoudis# included.
43318dff289SGiorgis Georgakoudis# The default value is: NO.
43418dff289SGiorgis Georgakoudis
43518dff289SGiorgis GeorgakoudisEXTRACT_LOCAL_METHODS  = NO
43618dff289SGiorgis Georgakoudis
43718dff289SGiorgis Georgakoudis# If this flag is set to YES, the members of anonymous namespaces will be
43818dff289SGiorgis Georgakoudis# extracted and appear in the documentation as a namespace called
43918dff289SGiorgis Georgakoudis# 'anonymous_namespace{file}', where file will be replaced with the base name of
44018dff289SGiorgis Georgakoudis# the file that contains the anonymous namespace. By default anonymous namespace
44118dff289SGiorgis Georgakoudis# are hidden.
44218dff289SGiorgis Georgakoudis# The default value is: NO.
44318dff289SGiorgis Georgakoudis
44418dff289SGiorgis GeorgakoudisEXTRACT_ANON_NSPACES   = NO
44518dff289SGiorgis Georgakoudis
44618dff289SGiorgis Georgakoudis# If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all
44718dff289SGiorgis Georgakoudis# undocumented members inside documented classes or files. If set to NO these
44818dff289SGiorgis Georgakoudis# members will be included in the various overviews, but no documentation
44918dff289SGiorgis Georgakoudis# section is generated. This option has no effect if EXTRACT_ALL is enabled.
45018dff289SGiorgis Georgakoudis# The default value is: NO.
45118dff289SGiorgis Georgakoudis
45218dff289SGiorgis GeorgakoudisHIDE_UNDOC_MEMBERS     = NO
45318dff289SGiorgis Georgakoudis
45418dff289SGiorgis Georgakoudis# If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all
45518dff289SGiorgis Georgakoudis# undocumented classes that are normally visible in the class hierarchy. If set
45618dff289SGiorgis Georgakoudis# to NO these classes will be included in the various overviews. This option has
45718dff289SGiorgis Georgakoudis# no effect if EXTRACT_ALL is enabled.
45818dff289SGiorgis Georgakoudis# The default value is: NO.
45918dff289SGiorgis Georgakoudis
46018dff289SGiorgis GeorgakoudisHIDE_UNDOC_CLASSES     = NO
46118dff289SGiorgis Georgakoudis
46218dff289SGiorgis Georgakoudis# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend
46318dff289SGiorgis Georgakoudis# (class|struct|union) declarations. If set to NO these declarations will be
46418dff289SGiorgis Georgakoudis# included in the documentation.
46518dff289SGiorgis Georgakoudis# The default value is: NO.
46618dff289SGiorgis Georgakoudis
46718dff289SGiorgis GeorgakoudisHIDE_FRIEND_COMPOUNDS  = NO
46818dff289SGiorgis Georgakoudis
46918dff289SGiorgis Georgakoudis# If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any
47018dff289SGiorgis Georgakoudis# documentation blocks found inside the body of a function. If set to NO these
47118dff289SGiorgis Georgakoudis# blocks will be appended to the function's detailed documentation block.
47218dff289SGiorgis Georgakoudis# The default value is: NO.
47318dff289SGiorgis Georgakoudis
47418dff289SGiorgis GeorgakoudisHIDE_IN_BODY_DOCS      = NO
47518dff289SGiorgis Georgakoudis
47618dff289SGiorgis Georgakoudis# The INTERNAL_DOCS tag determines if documentation that is typed after a
47718dff289SGiorgis Georgakoudis# \internal command is included. If the tag is set to NO then the documentation
47818dff289SGiorgis Georgakoudis# will be excluded. Set it to YES to include the internal documentation.
47918dff289SGiorgis Georgakoudis# The default value is: NO.
48018dff289SGiorgis Georgakoudis
48118dff289SGiorgis GeorgakoudisINTERNAL_DOCS          = NO
48218dff289SGiorgis Georgakoudis
48318dff289SGiorgis Georgakoudis# If the CASE_SENSE_NAMES tag is set to NO then doxygen will only generate file
48418dff289SGiorgis Georgakoudis# names in lower-case letters. If set to YES upper-case letters are also
48518dff289SGiorgis Georgakoudis# allowed. This is useful if you have classes or files whose names only differ
48618dff289SGiorgis Georgakoudis# in case and if your file system supports case sensitive file names. Windows
48718dff289SGiorgis Georgakoudis# and Mac users are advised to set this option to NO.
48818dff289SGiorgis Georgakoudis# The default value is: system dependent.
48918dff289SGiorgis Georgakoudis
49018dff289SGiorgis GeorgakoudisCASE_SENSE_NAMES       = YES
49118dff289SGiorgis Georgakoudis
49218dff289SGiorgis Georgakoudis# If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with
49318dff289SGiorgis Georgakoudis# their full class and namespace scopes in the documentation. If set to YES the
49418dff289SGiorgis Georgakoudis# scope will be hidden.
49518dff289SGiorgis Georgakoudis# The default value is: NO.
49618dff289SGiorgis Georgakoudis
49718dff289SGiorgis GeorgakoudisHIDE_SCOPE_NAMES       = NO
49818dff289SGiorgis Georgakoudis
49918dff289SGiorgis Georgakoudis# If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of
50018dff289SGiorgis Georgakoudis# the files that are included by a file in the documentation of that file.
50118dff289SGiorgis Georgakoudis# The default value is: YES.
50218dff289SGiorgis Georgakoudis
50318dff289SGiorgis GeorgakoudisSHOW_INCLUDE_FILES     = YES
50418dff289SGiorgis Georgakoudis
50518dff289SGiorgis Georgakoudis# If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each
50618dff289SGiorgis Georgakoudis# grouped member an include statement to the documentation, telling the reader
50718dff289SGiorgis Georgakoudis# which file to include in order to use the member.
50818dff289SGiorgis Georgakoudis# The default value is: NO.
50918dff289SGiorgis Georgakoudis
51018dff289SGiorgis GeorgakoudisSHOW_GROUPED_MEMB_INC  = NO
51118dff289SGiorgis Georgakoudis
51218dff289SGiorgis Georgakoudis# If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include
51318dff289SGiorgis Georgakoudis# files with double quotes in the documentation rather than with sharp brackets.
51418dff289SGiorgis Georgakoudis# The default value is: NO.
51518dff289SGiorgis Georgakoudis
51618dff289SGiorgis GeorgakoudisFORCE_LOCAL_INCLUDES   = YES
51718dff289SGiorgis Georgakoudis
51818dff289SGiorgis Georgakoudis# If the INLINE_INFO tag is set to YES then a tag [inline] is inserted in the
51918dff289SGiorgis Georgakoudis# documentation for inline members.
52018dff289SGiorgis Georgakoudis# The default value is: YES.
52118dff289SGiorgis Georgakoudis
52218dff289SGiorgis GeorgakoudisINLINE_INFO            = YES
52318dff289SGiorgis Georgakoudis
52418dff289SGiorgis Georgakoudis# If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the
52518dff289SGiorgis Georgakoudis# (detailed) documentation of file and class members alphabetically by member
52618dff289SGiorgis Georgakoudis# name. If set to NO the members will appear in declaration order.
52718dff289SGiorgis Georgakoudis# The default value is: YES.
52818dff289SGiorgis Georgakoudis
52918dff289SGiorgis GeorgakoudisSORT_MEMBER_DOCS       = YES
53018dff289SGiorgis Georgakoudis
53118dff289SGiorgis Georgakoudis# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief
53218dff289SGiorgis Georgakoudis# descriptions of file, namespace and class members alphabetically by member
53318dff289SGiorgis Georgakoudis# name. If set to NO the members will appear in declaration order. Note that
53418dff289SGiorgis Georgakoudis# this will also influence the order of the classes in the class list.
53518dff289SGiorgis Georgakoudis# The default value is: NO.
53618dff289SGiorgis Georgakoudis
53718dff289SGiorgis GeorgakoudisSORT_BRIEF_DOCS        = NO
53818dff289SGiorgis Georgakoudis
53918dff289SGiorgis Georgakoudis# If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the
54018dff289SGiorgis Georgakoudis# (brief and detailed) documentation of class members so that constructors and
54118dff289SGiorgis Georgakoudis# destructors are listed first. If set to NO the constructors will appear in the
54218dff289SGiorgis Georgakoudis# respective orders defined by SORT_BRIEF_DOCS and SORT_MEMBER_DOCS.
54318dff289SGiorgis Georgakoudis# Note: If SORT_BRIEF_DOCS is set to NO this option is ignored for sorting brief
54418dff289SGiorgis Georgakoudis# member documentation.
54518dff289SGiorgis Georgakoudis# Note: If SORT_MEMBER_DOCS is set to NO this option is ignored for sorting
54618dff289SGiorgis Georgakoudis# detailed member documentation.
54718dff289SGiorgis Georgakoudis# The default value is: NO.
54818dff289SGiorgis Georgakoudis
54918dff289SGiorgis GeorgakoudisSORT_MEMBERS_CTORS_1ST = NO
55018dff289SGiorgis Georgakoudis
55118dff289SGiorgis Georgakoudis# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy
55218dff289SGiorgis Georgakoudis# of group names into alphabetical order. If set to NO the group names will
55318dff289SGiorgis Georgakoudis# appear in their defined order.
55418dff289SGiorgis Georgakoudis# The default value is: NO.
55518dff289SGiorgis Georgakoudis
55618dff289SGiorgis GeorgakoudisSORT_GROUP_NAMES       = NO
55718dff289SGiorgis Georgakoudis
55818dff289SGiorgis Georgakoudis# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by
55918dff289SGiorgis Georgakoudis# fully-qualified names, including namespaces. If set to NO, the class list will
56018dff289SGiorgis Georgakoudis# be sorted only by class name, not including the namespace part.
56118dff289SGiorgis Georgakoudis# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
56218dff289SGiorgis Georgakoudis# Note: This option applies only to the class list, not to the alphabetical
56318dff289SGiorgis Georgakoudis# list.
56418dff289SGiorgis Georgakoudis# The default value is: NO.
56518dff289SGiorgis Georgakoudis
56618dff289SGiorgis GeorgakoudisSORT_BY_SCOPE_NAME     = NO
56718dff289SGiorgis Georgakoudis
56818dff289SGiorgis Georgakoudis# If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper
56918dff289SGiorgis Georgakoudis# type resolution of all parameters of a function it will reject a match between
57018dff289SGiorgis Georgakoudis# the prototype and the implementation of a member function even if there is
57118dff289SGiorgis Georgakoudis# only one candidate or it is obvious which candidate to choose by doing a
57218dff289SGiorgis Georgakoudis# simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still
57318dff289SGiorgis Georgakoudis# accept a match between prototype and implementation in such cases.
57418dff289SGiorgis Georgakoudis# The default value is: NO.
57518dff289SGiorgis Georgakoudis
57618dff289SGiorgis GeorgakoudisSTRICT_PROTO_MATCHING  = NO
57718dff289SGiorgis Georgakoudis
57818dff289SGiorgis Georgakoudis# The GENERATE_TODOLIST tag can be used to enable ( YES) or disable ( NO) the
57918dff289SGiorgis Georgakoudis# todo list. This list is created by putting \todo commands in the
58018dff289SGiorgis Georgakoudis# documentation.
58118dff289SGiorgis Georgakoudis# The default value is: YES.
58218dff289SGiorgis Georgakoudis
58318dff289SGiorgis GeorgakoudisGENERATE_TODOLIST      = YES
58418dff289SGiorgis Georgakoudis
58518dff289SGiorgis Georgakoudis# The GENERATE_TESTLIST tag can be used to enable ( YES) or disable ( NO) the
58618dff289SGiorgis Georgakoudis# test list. This list is created by putting \test commands in the
58718dff289SGiorgis Georgakoudis# documentation.
58818dff289SGiorgis Georgakoudis# The default value is: YES.
58918dff289SGiorgis Georgakoudis
59018dff289SGiorgis GeorgakoudisGENERATE_TESTLIST      = YES
59118dff289SGiorgis Georgakoudis
59218dff289SGiorgis Georgakoudis# The GENERATE_BUGLIST tag can be used to enable ( YES) or disable ( NO) the bug
59318dff289SGiorgis Georgakoudis# list. This list is created by putting \bug commands in the documentation.
59418dff289SGiorgis Georgakoudis# The default value is: YES.
59518dff289SGiorgis Georgakoudis
59618dff289SGiorgis GeorgakoudisGENERATE_BUGLIST       = YES
59718dff289SGiorgis Georgakoudis
59818dff289SGiorgis Georgakoudis# The GENERATE_DEPRECATEDLIST tag can be used to enable ( YES) or disable ( NO)
59918dff289SGiorgis Georgakoudis# the deprecated list. This list is created by putting \deprecated commands in
60018dff289SGiorgis Georgakoudis# the documentation.
60118dff289SGiorgis Georgakoudis# The default value is: YES.
60218dff289SGiorgis Georgakoudis
60318dff289SGiorgis GeorgakoudisGENERATE_DEPRECATEDLIST= YES
60418dff289SGiorgis Georgakoudis
60518dff289SGiorgis Georgakoudis# The ENABLED_SECTIONS tag can be used to enable conditional documentation
60618dff289SGiorgis Georgakoudis# sections, marked by \if <section_label> ... \endif and \cond <section_label>
60718dff289SGiorgis Georgakoudis# ... \endcond blocks.
60818dff289SGiorgis Georgakoudis
60918dff289SGiorgis GeorgakoudisENABLED_SECTIONS       =
61018dff289SGiorgis Georgakoudis
61118dff289SGiorgis Georgakoudis# The MAX_INITIALIZER_LINES tag determines the maximum number of lines that the
61218dff289SGiorgis Georgakoudis# initial value of a variable or macro / define can have for it to appear in the
61318dff289SGiorgis Georgakoudis# documentation. If the initializer consists of more lines than specified here
61418dff289SGiorgis Georgakoudis# it will be hidden. Use a value of 0 to hide initializers completely. The
61518dff289SGiorgis Georgakoudis# appearance of the value of individual variables and macros / defines can be
61618dff289SGiorgis Georgakoudis# controlled using \showinitializer or \hideinitializer command in the
61718dff289SGiorgis Georgakoudis# documentation regardless of this setting.
61818dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 10000, default value: 30.
61918dff289SGiorgis Georgakoudis
62018dff289SGiorgis GeorgakoudisMAX_INITIALIZER_LINES  = 30
62118dff289SGiorgis Georgakoudis
62218dff289SGiorgis Georgakoudis# Set the SHOW_USED_FILES tag to NO to disable the list of files generated at
62318dff289SGiorgis Georgakoudis# the bottom of the documentation of classes and structs. If set to YES the list
62418dff289SGiorgis Georgakoudis# will mention the files that were used to generate the documentation.
62518dff289SGiorgis Georgakoudis# The default value is: YES.
62618dff289SGiorgis Georgakoudis
62718dff289SGiorgis GeorgakoudisSHOW_USED_FILES        = YES
62818dff289SGiorgis Georgakoudis
62918dff289SGiorgis Georgakoudis# Set the SHOW_FILES tag to NO to disable the generation of the Files page. This
63018dff289SGiorgis Georgakoudis# will remove the Files entry from the Quick Index and from the Folder Tree View
63118dff289SGiorgis Georgakoudis# (if specified).
63218dff289SGiorgis Georgakoudis# The default value is: YES.
63318dff289SGiorgis Georgakoudis
63418dff289SGiorgis GeorgakoudisSHOW_FILES             = YES
63518dff289SGiorgis Georgakoudis
63618dff289SGiorgis Georgakoudis# Set the SHOW_NAMESPACES tag to NO to disable the generation of the Namespaces
63718dff289SGiorgis Georgakoudis# page. This will remove the Namespaces entry from the Quick Index and from the
63818dff289SGiorgis Georgakoudis# Folder Tree View (if specified).
63918dff289SGiorgis Georgakoudis# The default value is: YES.
64018dff289SGiorgis Georgakoudis
64118dff289SGiorgis GeorgakoudisSHOW_NAMESPACES        = YES
64218dff289SGiorgis Georgakoudis
64318dff289SGiorgis Georgakoudis# The FILE_VERSION_FILTER tag can be used to specify a program or script that
64418dff289SGiorgis Georgakoudis# doxygen should invoke to get the current version for each file (typically from
64518dff289SGiorgis Georgakoudis# the version control system). Doxygen will invoke the program by executing (via
64618dff289SGiorgis Georgakoudis# popen()) the command command input-file, where command is the value of the
64718dff289SGiorgis Georgakoudis# FILE_VERSION_FILTER tag, and input-file is the name of an input file provided
64818dff289SGiorgis Georgakoudis# by doxygen. Whatever the program writes to standard output is used as the file
64918dff289SGiorgis Georgakoudis# version. For an example see the documentation.
65018dff289SGiorgis Georgakoudis
65118dff289SGiorgis GeorgakoudisFILE_VERSION_FILTER    =
65218dff289SGiorgis Georgakoudis
65318dff289SGiorgis Georgakoudis# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed
65418dff289SGiorgis Georgakoudis# by doxygen. The layout file controls the global structure of the generated
65518dff289SGiorgis Georgakoudis# output files in an output format independent way. To create the layout file
65618dff289SGiorgis Georgakoudis# that represents doxygen's defaults, run doxygen with the -l option. You can
65718dff289SGiorgis Georgakoudis# optionally specify a file name after the option, if omitted DoxygenLayout.xml
65818dff289SGiorgis Georgakoudis# will be used as the name of the layout file.
65918dff289SGiorgis Georgakoudis#
66018dff289SGiorgis Georgakoudis# Note that if you run doxygen from a directory containing a file called
66118dff289SGiorgis Georgakoudis# DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
66218dff289SGiorgis Georgakoudis# tag is left empty.
66318dff289SGiorgis Georgakoudis
66418dff289SGiorgis GeorgakoudisLAYOUT_FILE            =
66518dff289SGiorgis Georgakoudis
66618dff289SGiorgis Georgakoudis# The CITE_BIB_FILES tag can be used to specify one or more bib files containing
66718dff289SGiorgis Georgakoudis# the reference definitions. This must be a list of .bib files. The .bib
66818dff289SGiorgis Georgakoudis# extension is automatically appended if omitted. This requires the bibtex tool
66918dff289SGiorgis Georgakoudis# to be installed. See also http://en.wikipedia.org/wiki/BibTeX for more info.
67018dff289SGiorgis Georgakoudis# For LaTeX the style of the bibliography can be controlled using
67118dff289SGiorgis Georgakoudis# LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the
67218dff289SGiorgis Georgakoudis# search path. Do not use file names with spaces, bibtex cannot handle them. See
67318dff289SGiorgis Georgakoudis# also \cite for info how to create references.
67418dff289SGiorgis Georgakoudis
67518dff289SGiorgis GeorgakoudisCITE_BIB_FILES         =
67618dff289SGiorgis Georgakoudis
67718dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
67818dff289SGiorgis Georgakoudis# Configuration options related to warning and progress messages
67918dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
68018dff289SGiorgis Georgakoudis
68118dff289SGiorgis Georgakoudis# The QUIET tag can be used to turn on/off the messages that are generated to
68218dff289SGiorgis Georgakoudis# standard output by doxygen. If QUIET is set to YES this implies that the
68318dff289SGiorgis Georgakoudis# messages are off.
68418dff289SGiorgis Georgakoudis# The default value is: NO.
68518dff289SGiorgis Georgakoudis
68618dff289SGiorgis GeorgakoudisQUIET                  = NO
68718dff289SGiorgis Georgakoudis
68818dff289SGiorgis Georgakoudis# The WARNINGS tag can be used to turn on/off the warning messages that are
68918dff289SGiorgis Georgakoudis# generated to standard error ( stderr) by doxygen. If WARNINGS is set to YES
69018dff289SGiorgis Georgakoudis# this implies that the warnings are on.
69118dff289SGiorgis Georgakoudis#
69218dff289SGiorgis Georgakoudis# Tip: Turn warnings on while writing the documentation.
69318dff289SGiorgis Georgakoudis# The default value is: YES.
69418dff289SGiorgis Georgakoudis
69518dff289SGiorgis GeorgakoudisWARNINGS               = NO
69618dff289SGiorgis Georgakoudis
69718dff289SGiorgis Georgakoudis# If the WARN_IF_UNDOCUMENTED tag is set to YES, then doxygen will generate
69818dff289SGiorgis Georgakoudis# warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag
69918dff289SGiorgis Georgakoudis# will automatically be disabled.
70018dff289SGiorgis Georgakoudis# The default value is: YES.
70118dff289SGiorgis Georgakoudis
70218dff289SGiorgis GeorgakoudisWARN_IF_UNDOCUMENTED   = NO
70318dff289SGiorgis Georgakoudis
70418dff289SGiorgis Georgakoudis# If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for
70518dff289SGiorgis Georgakoudis# potential errors in the documentation, such as not documenting some parameters
70618dff289SGiorgis Georgakoudis# in a documented function, or documenting parameters that don't exist or using
70718dff289SGiorgis Georgakoudis# markup commands wrongly.
70818dff289SGiorgis Georgakoudis# The default value is: YES.
70918dff289SGiorgis Georgakoudis
71018dff289SGiorgis GeorgakoudisWARN_IF_DOC_ERROR      = YES
71118dff289SGiorgis Georgakoudis
71218dff289SGiorgis Georgakoudis# This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that
71318dff289SGiorgis Georgakoudis# are documented, but have no documentation for their parameters or return
71418dff289SGiorgis Georgakoudis# value. If set to NO doxygen will only warn about wrong or incomplete parameter
71518dff289SGiorgis Georgakoudis# documentation, but not about the absence of documentation.
71618dff289SGiorgis Georgakoudis# The default value is: NO.
71718dff289SGiorgis Georgakoudis
71818dff289SGiorgis GeorgakoudisWARN_NO_PARAMDOC       = NO
71918dff289SGiorgis Georgakoudis
72018dff289SGiorgis Georgakoudis# The WARN_FORMAT tag determines the format of the warning messages that doxygen
72118dff289SGiorgis Georgakoudis# can produce. The string should contain the $file, $line, and $text tags, which
72218dff289SGiorgis Georgakoudis# will be replaced by the file and line number from which the warning originated
72318dff289SGiorgis Georgakoudis# and the warning text. Optionally the format may contain $version, which will
72418dff289SGiorgis Georgakoudis# be replaced by the version of the file (if it could be obtained via
72518dff289SGiorgis Georgakoudis# FILE_VERSION_FILTER)
72618dff289SGiorgis Georgakoudis# The default value is: $file:$line: $text.
72718dff289SGiorgis Georgakoudis
72818dff289SGiorgis GeorgakoudisWARN_FORMAT            = "$file:$line: $text"
72918dff289SGiorgis Georgakoudis
73018dff289SGiorgis Georgakoudis# The WARN_LOGFILE tag can be used to specify a file to which warning and error
73118dff289SGiorgis Georgakoudis# messages should be written. If left blank the output is written to standard
73218dff289SGiorgis Georgakoudis# error (stderr).
73318dff289SGiorgis Georgakoudis
73418dff289SGiorgis GeorgakoudisWARN_LOGFILE           =
73518dff289SGiorgis Georgakoudis
73618dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
73718dff289SGiorgis Georgakoudis# Configuration options related to the input files
73818dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
73918dff289SGiorgis Georgakoudis
74018dff289SGiorgis Georgakoudis# The INPUT tag is used to specify the files and/or directories that contain
74118dff289SGiorgis Georgakoudis# documented source files. You may enter file names like myfile.cpp or
74218dff289SGiorgis Georgakoudis# directories like /usr/src/myproject. Separate the files or directories with
74318dff289SGiorgis Georgakoudis# spaces.
74418dff289SGiorgis Georgakoudis# Note: If this tag is empty the current directory is searched.
74518dff289SGiorgis Georgakoudis
74618dff289SGiorgis GeorgakoudisINPUT                  = @abs_srcdir@/../runtime \
74718dff289SGiorgis Georgakoudis                         @abs_srcdir@/../libomptarget \
74818dff289SGiorgis Georgakoudis                         @abs_srcdir@/../tools \
74918dff289SGiorgis Georgakoudis                         @abs_srcdir@/doxygen-mainpage.dox
75018dff289SGiorgis Georgakoudis
75118dff289SGiorgis Georgakoudis# This tag can be used to specify the character encoding of the source files
75218dff289SGiorgis Georgakoudis# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
75318dff289SGiorgis Georgakoudis# libiconv (or the iconv built into libc) for the transcoding. See the libiconv
75418dff289SGiorgis Georgakoudis# documentation (see: http://www.gnu.org/software/libiconv) for the list of
75518dff289SGiorgis Georgakoudis# possible encodings.
75618dff289SGiorgis Georgakoudis# The default value is: UTF-8.
75718dff289SGiorgis Georgakoudis
75818dff289SGiorgis GeorgakoudisINPUT_ENCODING         = UTF-8
75918dff289SGiorgis Georgakoudis
76018dff289SGiorgis Georgakoudis# If the value of the INPUT tag contains directories, you can use the
76118dff289SGiorgis Georgakoudis# FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
76218dff289SGiorgis Georgakoudis# *.h) to filter out the source-files in the directories. If left blank the
76318dff289SGiorgis Georgakoudis# following patterns are tested:*.c, *.cc, *.cxx, *.cpp, *.c++, *.java, *.ii,
76418dff289SGiorgis Georgakoudis# *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, *.hh, *.hxx, *.hpp,
76518dff289SGiorgis Georgakoudis# *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc, *.m, *.markdown,
76618dff289SGiorgis Georgakoudis# *.md, *.mm, *.dox, *.py, *.f90, *.f, *.for, *.tcl, *.vhd, *.vhdl, *.ucf,
76718dff289SGiorgis Georgakoudis# *.qsf, *.as and *.js.
76818dff289SGiorgis Georgakoudis
76918dff289SGiorgis GeorgakoudisFILE_PATTERNS          =
77018dff289SGiorgis Georgakoudis
77118dff289SGiorgis Georgakoudis# The RECURSIVE tag can be used to specify whether or not subdirectories should
77218dff289SGiorgis Georgakoudis# be searched for input files as well.
77318dff289SGiorgis Georgakoudis# The default value is: NO.
77418dff289SGiorgis Georgakoudis
77518dff289SGiorgis GeorgakoudisRECURSIVE              = YES
77618dff289SGiorgis Georgakoudis
77718dff289SGiorgis Georgakoudis# The EXCLUDE tag can be used to specify files and/or directories that should be
77818dff289SGiorgis Georgakoudis# excluded from the INPUT source files. This way you can easily exclude a
77918dff289SGiorgis Georgakoudis# subdirectory from a directory tree whose root is specified with the INPUT tag.
78018dff289SGiorgis Georgakoudis#
78118dff289SGiorgis Georgakoudis# Note that relative paths are relative to the directory from which doxygen is
78218dff289SGiorgis Georgakoudis# run.
78318dff289SGiorgis Georgakoudis
78418dff289SGiorgis GeorgakoudisEXCLUDE                =
78518dff289SGiorgis Georgakoudis
78618dff289SGiorgis Georgakoudis# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
78718dff289SGiorgis Georgakoudis# directories that are symbolic links (a Unix file system feature) are excluded
78818dff289SGiorgis Georgakoudis# from the input.
78918dff289SGiorgis Georgakoudis# The default value is: NO.
79018dff289SGiorgis Georgakoudis
79118dff289SGiorgis GeorgakoudisEXCLUDE_SYMLINKS       = NO
79218dff289SGiorgis Georgakoudis
79318dff289SGiorgis Georgakoudis# If the value of the INPUT tag contains directories, you can use the
79418dff289SGiorgis Georgakoudis# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
79518dff289SGiorgis Georgakoudis# certain files from those directories.
79618dff289SGiorgis Georgakoudis#
79718dff289SGiorgis Georgakoudis# Note that the wildcards are matched against the file with absolute path, so to
79818dff289SGiorgis Georgakoudis# exclude all test directories for example use the pattern */test/*
79918dff289SGiorgis Georgakoudis
80018dff289SGiorgis GeorgakoudisEXCLUDE_PATTERNS       =
80118dff289SGiorgis Georgakoudis
80218dff289SGiorgis Georgakoudis# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
80318dff289SGiorgis Georgakoudis# (namespaces, classes, functions, etc.) that should be excluded from the
80418dff289SGiorgis Georgakoudis# output. The symbol name can be a fully qualified name, a word, or if the
80518dff289SGiorgis Georgakoudis# wildcard * is used, a substring. Examples: ANamespace, AClass,
80618dff289SGiorgis Georgakoudis# AClass::ANamespace, ANamespace::*Test
80718dff289SGiorgis Georgakoudis#
80818dff289SGiorgis Georgakoudis# Note that the wildcards are matched against the file with absolute path, so to
80918dff289SGiorgis Georgakoudis# exclude all test directories use the pattern */test/*
81018dff289SGiorgis Georgakoudis
81118dff289SGiorgis GeorgakoudisEXCLUDE_SYMBOLS        =
81218dff289SGiorgis Georgakoudis
81318dff289SGiorgis Georgakoudis# The EXAMPLE_PATH tag can be used to specify one or more files or directories
81418dff289SGiorgis Georgakoudis# that contain example code fragments that are included (see the \include
81518dff289SGiorgis Georgakoudis# command).
81618dff289SGiorgis Georgakoudis
81718dff289SGiorgis GeorgakoudisEXAMPLE_PATH           = @abs_srcdir@/../examples
81818dff289SGiorgis Georgakoudis
81918dff289SGiorgis Georgakoudis# If the value of the EXAMPLE_PATH tag contains directories, you can use the
82018dff289SGiorgis Georgakoudis# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
82118dff289SGiorgis Georgakoudis# *.h) to filter out the source-files in the directories. If left blank all
82218dff289SGiorgis Georgakoudis# files are included.
82318dff289SGiorgis Georgakoudis
82418dff289SGiorgis GeorgakoudisEXAMPLE_PATTERNS       =
82518dff289SGiorgis Georgakoudis
82618dff289SGiorgis Georgakoudis# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
82718dff289SGiorgis Georgakoudis# searched for input files to be used with the \include or \dontinclude commands
82818dff289SGiorgis Georgakoudis# irrespective of the value of the RECURSIVE tag.
82918dff289SGiorgis Georgakoudis# The default value is: NO.
83018dff289SGiorgis Georgakoudis
83118dff289SGiorgis GeorgakoudisEXAMPLE_RECURSIVE      = YES
83218dff289SGiorgis Georgakoudis
83318dff289SGiorgis Georgakoudis# The IMAGE_PATH tag can be used to specify one or more files or directories
83418dff289SGiorgis Georgakoudis# that contain images that are to be included in the documentation (see the
83518dff289SGiorgis Georgakoudis# \image command).
83618dff289SGiorgis Georgakoudis
83718dff289SGiorgis GeorgakoudisIMAGE_PATH             = @abs_srcdir@/img
83818dff289SGiorgis Georgakoudis
83918dff289SGiorgis Georgakoudis# The INPUT_FILTER tag can be used to specify a program that doxygen should
84018dff289SGiorgis Georgakoudis# invoke to filter for each input file. Doxygen will invoke the filter program
84118dff289SGiorgis Georgakoudis# by executing (via popen()) the command:
84218dff289SGiorgis Georgakoudis#
84318dff289SGiorgis Georgakoudis# <filter> <input-file>
84418dff289SGiorgis Georgakoudis#
84518dff289SGiorgis Georgakoudis# where <filter> is the value of the INPUT_FILTER tag, and <input-file> is the
84618dff289SGiorgis Georgakoudis# name of an input file. Doxygen will then use the output that the filter
84718dff289SGiorgis Georgakoudis# program writes to standard output. If FILTER_PATTERNS is specified, this tag
84818dff289SGiorgis Georgakoudis# will be ignored.
84918dff289SGiorgis Georgakoudis#
85018dff289SGiorgis Georgakoudis# Note that the filter must not add or remove lines; it is applied before the
85118dff289SGiorgis Georgakoudis# code is scanned, but not when the output code is generated. If lines are added
85218dff289SGiorgis Georgakoudis# or removed, the anchors will not be placed correctly.
85318dff289SGiorgis Georgakoudis
85418dff289SGiorgis GeorgakoudisINPUT_FILTER           =
85518dff289SGiorgis Georgakoudis
85618dff289SGiorgis Georgakoudis# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
85718dff289SGiorgis Georgakoudis# basis. Doxygen will compare the file name with each pattern and apply the
85818dff289SGiorgis Georgakoudis# filter if there is a match. The filters are a list of the form: pattern=filter
85918dff289SGiorgis Georgakoudis# (like *.cpp=my_cpp_filter). See INPUT_FILTER for further information on how
86018dff289SGiorgis Georgakoudis# filters are used. If the FILTER_PATTERNS tag is empty or if none of the
86118dff289SGiorgis Georgakoudis# patterns match the file name, INPUT_FILTER is applied.
86218dff289SGiorgis Georgakoudis
86318dff289SGiorgis GeorgakoudisFILTER_PATTERNS        =
86418dff289SGiorgis Georgakoudis
86518dff289SGiorgis Georgakoudis# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
86618dff289SGiorgis Georgakoudis# INPUT_FILTER ) will also be used to filter the input files that are used for
86718dff289SGiorgis Georgakoudis# producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES).
86818dff289SGiorgis Georgakoudis# The default value is: NO.
86918dff289SGiorgis Georgakoudis
87018dff289SGiorgis GeorgakoudisFILTER_SOURCE_FILES    = NO
87118dff289SGiorgis Georgakoudis
87218dff289SGiorgis Georgakoudis# The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file
87318dff289SGiorgis Georgakoudis# pattern. A pattern will override the setting for FILTER_PATTERN (if any) and
87418dff289SGiorgis Georgakoudis# it is also possible to disable source filtering for a specific pattern using
87518dff289SGiorgis Georgakoudis# *.ext= (so without naming a filter).
87618dff289SGiorgis Georgakoudis# This tag requires that the tag FILTER_SOURCE_FILES is set to YES.
87718dff289SGiorgis Georgakoudis
87818dff289SGiorgis GeorgakoudisFILTER_SOURCE_PATTERNS =
87918dff289SGiorgis Georgakoudis
88018dff289SGiorgis Georgakoudis# If the USE_MDFILE_AS_MAINPAGE tag refers to the name of a markdown file that
88118dff289SGiorgis Georgakoudis# is part of the input, its contents will be placed on the main page
88218dff289SGiorgis Georgakoudis# (index.html). This can be useful if you have a project on for instance GitHub
88318dff289SGiorgis Georgakoudis# and want to reuse the introduction page also for the doxygen output.
88418dff289SGiorgis Georgakoudis
88518dff289SGiorgis GeorgakoudisUSE_MDFILE_AS_MAINPAGE =
88618dff289SGiorgis Georgakoudis
88718dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
88818dff289SGiorgis Georgakoudis# Configuration options related to source browsing
88918dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
89018dff289SGiorgis Georgakoudis
89118dff289SGiorgis Georgakoudis# If the SOURCE_BROWSER tag is set to YES then a list of source files will be
89218dff289SGiorgis Georgakoudis# generated. Documented entities will be cross-referenced with these sources.
89318dff289SGiorgis Georgakoudis#
89418dff289SGiorgis Georgakoudis# Note: To get rid of all source code in the generated output, make sure that
89518dff289SGiorgis Georgakoudis# also VERBATIM_HEADERS is set to NO.
89618dff289SGiorgis Georgakoudis# The default value is: NO.
89718dff289SGiorgis Georgakoudis
89818dff289SGiorgis GeorgakoudisSOURCE_BROWSER         = YES
89918dff289SGiorgis Georgakoudis
90018dff289SGiorgis Georgakoudis# Setting the INLINE_SOURCES tag to YES will include the body of functions,
90118dff289SGiorgis Georgakoudis# classes and enums directly into the documentation.
90218dff289SGiorgis Georgakoudis# The default value is: NO.
90318dff289SGiorgis Georgakoudis
90418dff289SGiorgis GeorgakoudisINLINE_SOURCES         = NO
90518dff289SGiorgis Georgakoudis
90618dff289SGiorgis Georgakoudis# Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any
90718dff289SGiorgis Georgakoudis# special comment blocks from generated source code fragments. Normal C, C++ and
90818dff289SGiorgis Georgakoudis# Fortran comments will always remain visible.
90918dff289SGiorgis Georgakoudis# The default value is: YES.
91018dff289SGiorgis Georgakoudis
91118dff289SGiorgis GeorgakoudisSTRIP_CODE_COMMENTS    = NO
91218dff289SGiorgis Georgakoudis
91318dff289SGiorgis Georgakoudis# If the REFERENCED_BY_RELATION tag is set to YES then for each documented
91418dff289SGiorgis Georgakoudis# function all documented functions referencing it will be listed.
91518dff289SGiorgis Georgakoudis# The default value is: NO.
91618dff289SGiorgis Georgakoudis
91718dff289SGiorgis GeorgakoudisREFERENCED_BY_RELATION = YES
91818dff289SGiorgis Georgakoudis
91918dff289SGiorgis Georgakoudis# If the REFERENCES_RELATION tag is set to YES then for each documented function
92018dff289SGiorgis Georgakoudis# all documented entities called/used by that function will be listed.
92118dff289SGiorgis Georgakoudis# The default value is: NO.
92218dff289SGiorgis Georgakoudis
92318dff289SGiorgis GeorgakoudisREFERENCES_RELATION    = YES
92418dff289SGiorgis Georgakoudis
92518dff289SGiorgis Georgakoudis# If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set
92618dff289SGiorgis Georgakoudis# to YES, then the hyperlinks from functions in REFERENCES_RELATION and
92718dff289SGiorgis Georgakoudis# REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will
92818dff289SGiorgis Georgakoudis# link to the documentation.
92918dff289SGiorgis Georgakoudis# The default value is: YES.
93018dff289SGiorgis Georgakoudis
93118dff289SGiorgis GeorgakoudisREFERENCES_LINK_SOURCE = YES
93218dff289SGiorgis Georgakoudis
93318dff289SGiorgis Georgakoudis# If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the
93418dff289SGiorgis Georgakoudis# source code will show a tooltip with additional information such as prototype,
93518dff289SGiorgis Georgakoudis# brief description and links to the definition and documentation. Since this
93618dff289SGiorgis Georgakoudis# will make the HTML file larger and loading of large files a bit slower, you
93718dff289SGiorgis Georgakoudis# can opt to disable this feature.
93818dff289SGiorgis Georgakoudis# The default value is: YES.
93918dff289SGiorgis Georgakoudis# This tag requires that the tag SOURCE_BROWSER is set to YES.
94018dff289SGiorgis Georgakoudis
94118dff289SGiorgis GeorgakoudisSOURCE_TOOLTIPS        = YES
94218dff289SGiorgis Georgakoudis
94318dff289SGiorgis Georgakoudis# If the USE_HTAGS tag is set to YES then the references to source code will
94418dff289SGiorgis Georgakoudis# point to the HTML generated by the htags(1) tool instead of doxygen built-in
94518dff289SGiorgis Georgakoudis# source browser. The htags tool is part of GNU's global source tagging system
94618dff289SGiorgis Georgakoudis# (see http://www.gnu.org/software/global/global.html). You will need version
94718dff289SGiorgis Georgakoudis# 4.8.6 or higher.
94818dff289SGiorgis Georgakoudis#
94918dff289SGiorgis Georgakoudis# To use it do the following:
95018dff289SGiorgis Georgakoudis# - Install the latest version of global
95118dff289SGiorgis Georgakoudis# - Enable SOURCE_BROWSER and USE_HTAGS in the config file
95218dff289SGiorgis Georgakoudis# - Make sure the INPUT points to the root of the source tree
95318dff289SGiorgis Georgakoudis# - Run doxygen as normal
95418dff289SGiorgis Georgakoudis#
95518dff289SGiorgis Georgakoudis# Doxygen will invoke htags (and that will in turn invoke gtags), so these
95618dff289SGiorgis Georgakoudis# tools must be available from the command line (i.e. in the search path).
95718dff289SGiorgis Georgakoudis#
95818dff289SGiorgis Georgakoudis# The result: instead of the source browser generated by doxygen, the links to
95918dff289SGiorgis Georgakoudis# source code will now point to the output of htags.
96018dff289SGiorgis Georgakoudis# The default value is: NO.
96118dff289SGiorgis Georgakoudis# This tag requires that the tag SOURCE_BROWSER is set to YES.
96218dff289SGiorgis Georgakoudis
96318dff289SGiorgis GeorgakoudisUSE_HTAGS              = NO
96418dff289SGiorgis Georgakoudis
96518dff289SGiorgis Georgakoudis# If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a
96618dff289SGiorgis Georgakoudis# verbatim copy of the header file for each class for which an include is
96718dff289SGiorgis Georgakoudis# specified. Set to NO to disable this.
96818dff289SGiorgis Georgakoudis# See also: Section \class.
96918dff289SGiorgis Georgakoudis# The default value is: YES.
97018dff289SGiorgis Georgakoudis
97118dff289SGiorgis GeorgakoudisVERBATIM_HEADERS       = YES
97218dff289SGiorgis Georgakoudis
97318dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
97418dff289SGiorgis Georgakoudis# Configuration options related to the alphabetical class index
97518dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
97618dff289SGiorgis Georgakoudis
97718dff289SGiorgis Georgakoudis# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all
97818dff289SGiorgis Georgakoudis# compounds will be generated. Enable this if the project contains a lot of
97918dff289SGiorgis Georgakoudis# classes, structs, unions or interfaces.
98018dff289SGiorgis Georgakoudis# The default value is: YES.
98118dff289SGiorgis Georgakoudis
98218dff289SGiorgis GeorgakoudisALPHABETICAL_INDEX     = YES
98318dff289SGiorgis Georgakoudis
98418dff289SGiorgis Georgakoudis# The COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns in
98518dff289SGiorgis Georgakoudis# which the alphabetical index list will be split.
98618dff289SGiorgis Georgakoudis# Minimum value: 1, maximum value: 20, default value: 5.
98718dff289SGiorgis Georgakoudis# This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
98818dff289SGiorgis Georgakoudis
98918dff289SGiorgis GeorgakoudisCOLS_IN_ALPHA_INDEX    = 4
99018dff289SGiorgis Georgakoudis
99118dff289SGiorgis Georgakoudis# In case all classes in a project start with a common prefix, all classes will
99218dff289SGiorgis Georgakoudis# be put under the same header in the alphabetical index. The IGNORE_PREFIX tag
99318dff289SGiorgis Georgakoudis# can be used to specify a prefix (or a list of prefixes) that should be ignored
99418dff289SGiorgis Georgakoudis# while generating the index headers.
99518dff289SGiorgis Georgakoudis# This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
99618dff289SGiorgis Georgakoudis
99718dff289SGiorgis GeorgakoudisIGNORE_PREFIX          = openmp::
99818dff289SGiorgis Georgakoudis
99918dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
100018dff289SGiorgis Georgakoudis# Configuration options related to the HTML output
100118dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
100218dff289SGiorgis Georgakoudis
100318dff289SGiorgis Georgakoudis# If the GENERATE_HTML tag is set to YES doxygen will generate HTML output
100418dff289SGiorgis Georgakoudis# The default value is: YES.
100518dff289SGiorgis Georgakoudis
100618dff289SGiorgis GeorgakoudisGENERATE_HTML          = YES
100718dff289SGiorgis Georgakoudis
100818dff289SGiorgis Georgakoudis# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a
100918dff289SGiorgis Georgakoudis# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
101018dff289SGiorgis Georgakoudis# it.
101118dff289SGiorgis Georgakoudis# The default directory is: html.
101218dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
101318dff289SGiorgis Georgakoudis
101418dff289SGiorgis GeorgakoudisHTML_OUTPUT            = html
101518dff289SGiorgis Georgakoudis
101618dff289SGiorgis Georgakoudis# The HTML_FILE_EXTENSION tag can be used to specify the file extension for each
101718dff289SGiorgis Georgakoudis# generated HTML page (for example: .htm, .php, .asp).
101818dff289SGiorgis Georgakoudis# The default value is: .html.
101918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
102018dff289SGiorgis Georgakoudis
102118dff289SGiorgis GeorgakoudisHTML_FILE_EXTENSION    = .html
102218dff289SGiorgis Georgakoudis
102318dff289SGiorgis Georgakoudis# The HTML_HEADER tag can be used to specify a user-defined HTML header file for
102418dff289SGiorgis Georgakoudis# each generated HTML page. If the tag is left blank doxygen will generate a
102518dff289SGiorgis Georgakoudis# standard header.
102618dff289SGiorgis Georgakoudis#
102718dff289SGiorgis Georgakoudis# To get valid HTML the header file that includes any scripts and style sheets
102818dff289SGiorgis Georgakoudis# that doxygen needs, which is dependent on the configuration options used (e.g.
102918dff289SGiorgis Georgakoudis# the setting GENERATE_TREEVIEW). It is highly recommended to start with a
103018dff289SGiorgis Georgakoudis# default header using
103118dff289SGiorgis Georgakoudis# doxygen -w html new_header.html new_footer.html new_stylesheet.css
103218dff289SGiorgis Georgakoudis# YourConfigFile
103318dff289SGiorgis Georgakoudis# and then modify the file new_header.html. See also section "Doxygen usage"
103418dff289SGiorgis Georgakoudis# for information on how to generate the default header that doxygen normally
103518dff289SGiorgis Georgakoudis# uses.
103618dff289SGiorgis Georgakoudis# Note: The header is subject to change so you typically have to regenerate the
103718dff289SGiorgis Georgakoudis# default header when upgrading to a newer version of doxygen. For a description
103818dff289SGiorgis Georgakoudis# of the possible markers and block names see the documentation.
103918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
104018dff289SGiorgis Georgakoudis
104118dff289SGiorgis GeorgakoudisHTML_HEADER            =
104218dff289SGiorgis Georgakoudis
104318dff289SGiorgis Georgakoudis# The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each
104418dff289SGiorgis Georgakoudis# generated HTML page. If the tag is left blank doxygen will generate a standard
104518dff289SGiorgis Georgakoudis# footer. See HTML_HEADER for more information on how to generate a default
104618dff289SGiorgis Georgakoudis# footer and what special commands can be used inside the footer. See also
104718dff289SGiorgis Georgakoudis# section "Doxygen usage" for information on how to generate the default footer
104818dff289SGiorgis Georgakoudis# that doxygen normally uses.
104918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
105018dff289SGiorgis Georgakoudis
105118dff289SGiorgis GeorgakoudisHTML_FOOTER            =
105218dff289SGiorgis Georgakoudis
105318dff289SGiorgis Georgakoudis# The HTML_STYLESHEET tag can be used to specify a user-defined cascading style
105418dff289SGiorgis Georgakoudis# sheet that is used by each HTML page. It can be used to fine-tune the look of
105518dff289SGiorgis Georgakoudis# the HTML output. If left blank doxygen will generate a default style sheet.
105618dff289SGiorgis Georgakoudis# See also section "Doxygen usage" for information on how to generate the style
105718dff289SGiorgis Georgakoudis# sheet that doxygen normally uses.
105818dff289SGiorgis Georgakoudis# Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as
105918dff289SGiorgis Georgakoudis# it is more robust and this tag (HTML_STYLESHEET) will in the future become
106018dff289SGiorgis Georgakoudis# obsolete.
106118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
106218dff289SGiorgis Georgakoudis
106318dff289SGiorgis GeorgakoudisHTML_STYLESHEET        =
106418dff289SGiorgis Georgakoudis
106518dff289SGiorgis Georgakoudis# The HTML_EXTRA_STYLESHEET tag can be used to specify an additional user-
106618dff289SGiorgis Georgakoudis# defined cascading style sheet that is included after the standard style sheets
106718dff289SGiorgis Georgakoudis# created by doxygen. Using this option one can overrule certain style aspects.
106818dff289SGiorgis Georgakoudis# This is preferred over using HTML_STYLESHEET since it does not replace the
106918dff289SGiorgis Georgakoudis# standard style sheet and is therefore more robust against future updates.
107018dff289SGiorgis Georgakoudis# Doxygen will copy the style sheet file to the output directory. For an example
107118dff289SGiorgis Georgakoudis# see the documentation.
107218dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
107318dff289SGiorgis Georgakoudis
107418dff289SGiorgis GeorgakoudisHTML_EXTRA_STYLESHEET  =
107518dff289SGiorgis Georgakoudis
107618dff289SGiorgis Georgakoudis# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
107718dff289SGiorgis Georgakoudis# other source files which should be copied to the HTML output directory. Note
107818dff289SGiorgis Georgakoudis# that these files will be copied to the base HTML output directory. Use the
107918dff289SGiorgis Georgakoudis# $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these
108018dff289SGiorgis Georgakoudis# files. In the HTML_STYLESHEET file, use the file name only. Also note that the
108118dff289SGiorgis Georgakoudis# files will be copied as-is; there are no commands or markers available.
108218dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
108318dff289SGiorgis Georgakoudis
108418dff289SGiorgis GeorgakoudisHTML_EXTRA_FILES       =
108518dff289SGiorgis Georgakoudis
108618dff289SGiorgis Georgakoudis# The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
108718dff289SGiorgis Georgakoudis# will adjust the colors in the stylesheet and background images according to
108818dff289SGiorgis Georgakoudis# this color. Hue is specified as an angle on a colorwheel, see
108918dff289SGiorgis Georgakoudis# http://en.wikipedia.org/wiki/Hue for more information. For instance the value
109018dff289SGiorgis Georgakoudis# 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300
109118dff289SGiorgis Georgakoudis# purple, and 360 is red again.
109218dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 359, default value: 220.
109318dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
109418dff289SGiorgis Georgakoudis
109518dff289SGiorgis GeorgakoudisHTML_COLORSTYLE_HUE    = 220
109618dff289SGiorgis Georgakoudis
109718dff289SGiorgis Georgakoudis# The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors
109818dff289SGiorgis Georgakoudis# in the HTML output. For a value of 0 the output will use grayscales only. A
109918dff289SGiorgis Georgakoudis# value of 255 will produce the most vivid colors.
110018dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 255, default value: 100.
110118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
110218dff289SGiorgis Georgakoudis
110318dff289SGiorgis GeorgakoudisHTML_COLORSTYLE_SAT    = 100
110418dff289SGiorgis Georgakoudis
110518dff289SGiorgis Georgakoudis# The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the
110618dff289SGiorgis Georgakoudis# luminance component of the colors in the HTML output. Values below 100
110718dff289SGiorgis Georgakoudis# gradually make the output lighter, whereas values above 100 make the output
110818dff289SGiorgis Georgakoudis# darker. The value divided by 100 is the actual gamma applied, so 80 represents
110918dff289SGiorgis Georgakoudis# a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not
111018dff289SGiorgis Georgakoudis# change the gamma.
111118dff289SGiorgis Georgakoudis# Minimum value: 40, maximum value: 240, default value: 80.
111218dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
111318dff289SGiorgis Georgakoudis
111418dff289SGiorgis GeorgakoudisHTML_COLORSTYLE_GAMMA  = 80
111518dff289SGiorgis Georgakoudis
111618dff289SGiorgis Georgakoudis# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
111718dff289SGiorgis Georgakoudis# page will contain the date and time when the page was generated. Setting this
111818dff289SGiorgis Georgakoudis# to NO can help when comparing the output of multiple runs.
111918dff289SGiorgis Georgakoudis# The default value is: YES.
112018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
112118dff289SGiorgis Georgakoudis
112218dff289SGiorgis GeorgakoudisHTML_TIMESTAMP         = YES
112318dff289SGiorgis Georgakoudis
112418dff289SGiorgis Georgakoudis# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
112518dff289SGiorgis Georgakoudis# documentation will contain sections that can be hidden and shown after the
112618dff289SGiorgis Georgakoudis# page has loaded.
112718dff289SGiorgis Georgakoudis# The default value is: NO.
112818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
112918dff289SGiorgis Georgakoudis
113018dff289SGiorgis GeorgakoudisHTML_DYNAMIC_SECTIONS  = NO
113118dff289SGiorgis Georgakoudis
113218dff289SGiorgis Georgakoudis# With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries
113318dff289SGiorgis Georgakoudis# shown in the various tree structured indices initially; the user can expand
113418dff289SGiorgis Georgakoudis# and collapse entries dynamically later on. Doxygen will expand the tree to
113518dff289SGiorgis Georgakoudis# such a level that at most the specified number of entries are visible (unless
113618dff289SGiorgis Georgakoudis# a fully collapsed tree already exceeds this amount). So setting the number of
113718dff289SGiorgis Georgakoudis# entries 1 will produce a full collapsed tree by default. 0 is a special value
113818dff289SGiorgis Georgakoudis# representing an infinite number of entries and will result in a full expanded
113918dff289SGiorgis Georgakoudis# tree by default.
114018dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 9999, default value: 100.
114118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
114218dff289SGiorgis Georgakoudis
114318dff289SGiorgis GeorgakoudisHTML_INDEX_NUM_ENTRIES = 100
114418dff289SGiorgis Georgakoudis
114518dff289SGiorgis Georgakoudis# If the GENERATE_DOCSET tag is set to YES, additional index files will be
114618dff289SGiorgis Georgakoudis# generated that can be used as input for Apple's Xcode 3 integrated development
114718dff289SGiorgis Georgakoudis# environment (see: http://developer.apple.com/tools/xcode/), introduced with
114818dff289SGiorgis Georgakoudis# OSX 10.5 (Leopard). To create a documentation set, doxygen will generate a
114918dff289SGiorgis Georgakoudis# Makefile in the HTML output directory. Running make will produce the docset in
115018dff289SGiorgis Georgakoudis# that directory and running make install will install the docset in
115118dff289SGiorgis Georgakoudis# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at
115218dff289SGiorgis Georgakoudis# startup. See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html
115318dff289SGiorgis Georgakoudis# for more information.
115418dff289SGiorgis Georgakoudis# The default value is: NO.
115518dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
115618dff289SGiorgis Georgakoudis
115718dff289SGiorgis GeorgakoudisGENERATE_DOCSET        = NO
115818dff289SGiorgis Georgakoudis
115918dff289SGiorgis Georgakoudis# This tag determines the name of the docset feed. A documentation feed provides
116018dff289SGiorgis Georgakoudis# an umbrella under which multiple documentation sets from a single provider
116118dff289SGiorgis Georgakoudis# (such as a company or product suite) can be grouped.
116218dff289SGiorgis Georgakoudis# The default value is: Doxygen generated docs.
116318dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_DOCSET is set to YES.
116418dff289SGiorgis Georgakoudis
116518dff289SGiorgis GeorgakoudisDOCSET_FEEDNAME        = "Doxygen generated docs"
116618dff289SGiorgis Georgakoudis
116718dff289SGiorgis Georgakoudis# This tag specifies a string that should uniquely identify the documentation
116818dff289SGiorgis Georgakoudis# set bundle. This should be a reverse domain-name style string, e.g.
116918dff289SGiorgis Georgakoudis# com.mycompany.MyDocSet. Doxygen will append .docset to the name.
117018dff289SGiorgis Georgakoudis# The default value is: org.doxygen.Project.
117118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_DOCSET is set to YES.
117218dff289SGiorgis Georgakoudis
117318dff289SGiorgis GeorgakoudisDOCSET_BUNDLE_ID       = org.doxygen.Project
117418dff289SGiorgis Georgakoudis
117518dff289SGiorgis Georgakoudis# The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify
117618dff289SGiorgis Georgakoudis# the documentation publisher. This should be a reverse domain-name style
117718dff289SGiorgis Georgakoudis# string, e.g. com.mycompany.MyDocSet.documentation.
117818dff289SGiorgis Georgakoudis# The default value is: org.doxygen.Publisher.
117918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_DOCSET is set to YES.
118018dff289SGiorgis Georgakoudis
118118dff289SGiorgis GeorgakoudisDOCSET_PUBLISHER_ID    = org.doxygen.Publisher
118218dff289SGiorgis Georgakoudis
118318dff289SGiorgis Georgakoudis# The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher.
118418dff289SGiorgis Georgakoudis# The default value is: Publisher.
118518dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_DOCSET is set to YES.
118618dff289SGiorgis Georgakoudis
118718dff289SGiorgis GeorgakoudisDOCSET_PUBLISHER_NAME  = Publisher
118818dff289SGiorgis Georgakoudis
118918dff289SGiorgis Georgakoudis# If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three
119018dff289SGiorgis Georgakoudis# additional HTML index files: index.hhp, index.hhc, and index.hhk. The
119118dff289SGiorgis Georgakoudis# index.hhp is a project file that can be read by Microsoft's HTML Help Workshop
119218dff289SGiorgis Georgakoudis# (see: http://www.microsoft.com/en-us/download/details.aspx?id=21138) on
119318dff289SGiorgis Georgakoudis# Windows.
119418dff289SGiorgis Georgakoudis#
119518dff289SGiorgis Georgakoudis# The HTML Help Workshop contains a compiler that can convert all HTML output
119618dff289SGiorgis Georgakoudis# generated by doxygen into a single compiled HTML file (.chm). Compiled HTML
119718dff289SGiorgis Georgakoudis# files are now used as the Windows 98 help format, and will replace the old
119818dff289SGiorgis Georgakoudis# Windows help format (.hlp) on all Windows platforms in the future. Compressed
119918dff289SGiorgis Georgakoudis# HTML files also contain an index, a table of contents, and you can search for
120018dff289SGiorgis Georgakoudis# words in the documentation. The HTML workshop also contains a viewer for
120118dff289SGiorgis Georgakoudis# compressed HTML files.
120218dff289SGiorgis Georgakoudis# The default value is: NO.
120318dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
120418dff289SGiorgis Georgakoudis
120518dff289SGiorgis GeorgakoudisGENERATE_HTMLHELP      = NO
120618dff289SGiorgis Georgakoudis
120718dff289SGiorgis Georgakoudis# The CHM_FILE tag can be used to specify the file name of the resulting .chm
120818dff289SGiorgis Georgakoudis# file. You can add a path in front of the file if the result should not be
120918dff289SGiorgis Georgakoudis# written to the html output directory.
121018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
121118dff289SGiorgis Georgakoudis
121218dff289SGiorgis GeorgakoudisCHM_FILE               =
121318dff289SGiorgis Georgakoudis
121418dff289SGiorgis Georgakoudis# The HHC_LOCATION tag can be used to specify the location (absolute path
121518dff289SGiorgis Georgakoudis# including file name) of the HTML help compiler ( hhc.exe). If non-empty
121618dff289SGiorgis Georgakoudis# doxygen will try to run the HTML help compiler on the generated index.hhp.
121718dff289SGiorgis Georgakoudis# The file has to be specified with full path.
121818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
121918dff289SGiorgis Georgakoudis
122018dff289SGiorgis GeorgakoudisHHC_LOCATION           =
122118dff289SGiorgis Georgakoudis
122218dff289SGiorgis Georgakoudis# The GENERATE_CHI flag controls if a separate .chi index file is generated (
1223c3b15b71SQuinn Pham# YES) or that it should be included in the main .chm file ( NO).
122418dff289SGiorgis Georgakoudis# The default value is: NO.
122518dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
122618dff289SGiorgis Georgakoudis
122718dff289SGiorgis GeorgakoudisGENERATE_CHI           = NO
122818dff289SGiorgis Georgakoudis
122918dff289SGiorgis Georgakoudis# The CHM_INDEX_ENCODING is used to encode HtmlHelp index ( hhk), content ( hhc)
123018dff289SGiorgis Georgakoudis# and project file content.
123118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
123218dff289SGiorgis Georgakoudis
123318dff289SGiorgis GeorgakoudisCHM_INDEX_ENCODING     =
123418dff289SGiorgis Georgakoudis
123518dff289SGiorgis Georgakoudis# The BINARY_TOC flag controls whether a binary table of contents is generated (
123618dff289SGiorgis Georgakoudis# YES) or a normal table of contents ( NO) in the .chm file.
123718dff289SGiorgis Georgakoudis# The default value is: NO.
123818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
123918dff289SGiorgis Georgakoudis
124018dff289SGiorgis GeorgakoudisBINARY_TOC             = NO
124118dff289SGiorgis Georgakoudis
124218dff289SGiorgis Georgakoudis# The TOC_EXPAND flag can be set to YES to add extra items for group members to
124318dff289SGiorgis Georgakoudis# the table of contents of the HTML help documentation and to the tree view.
124418dff289SGiorgis Georgakoudis# The default value is: NO.
124518dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
124618dff289SGiorgis Georgakoudis
124718dff289SGiorgis GeorgakoudisTOC_EXPAND             = NO
124818dff289SGiorgis Georgakoudis
124918dff289SGiorgis Georgakoudis# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and
125018dff289SGiorgis Georgakoudis# QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that
125118dff289SGiorgis Georgakoudis# can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help
125218dff289SGiorgis Georgakoudis# (.qch) of the generated HTML documentation.
125318dff289SGiorgis Georgakoudis# The default value is: NO.
125418dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
125518dff289SGiorgis Georgakoudis
125618dff289SGiorgis GeorgakoudisGENERATE_QHP           = @openmp_doxygen_generate_qhp@
125718dff289SGiorgis Georgakoudis
125818dff289SGiorgis Georgakoudis# If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify
125918dff289SGiorgis Georgakoudis# the file name of the resulting .qch file. The path specified is relative to
126018dff289SGiorgis Georgakoudis# the HTML output folder.
126118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_QHP is set to YES.
126218dff289SGiorgis Georgakoudis
126318dff289SGiorgis GeorgakoudisQCH_FILE               = @openmp_doxygen_qch_filename@
126418dff289SGiorgis Georgakoudis
126518dff289SGiorgis Georgakoudis# The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help
126618dff289SGiorgis Georgakoudis# Project output. For more information please see Qt Help Project / Namespace
126718dff289SGiorgis Georgakoudis# (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#namespace).
126818dff289SGiorgis Georgakoudis# The default value is: org.doxygen.Project.
126918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_QHP is set to YES.
127018dff289SGiorgis Georgakoudis
127118dff289SGiorgis GeorgakoudisQHP_NAMESPACE          = @openmp_doxygen_qhp_namespace@
127218dff289SGiorgis Georgakoudis
127318dff289SGiorgis Georgakoudis# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt
127418dff289SGiorgis Georgakoudis# Help Project output. For more information please see Qt Help Project / Virtual
127518dff289SGiorgis Georgakoudis# Folders (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#virtual-
127618dff289SGiorgis Georgakoudis# folders).
127718dff289SGiorgis Georgakoudis# The default value is: doc.
127818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_QHP is set to YES.
127918dff289SGiorgis Georgakoudis
128018dff289SGiorgis GeorgakoudisQHP_VIRTUAL_FOLDER     = doc
128118dff289SGiorgis Georgakoudis
128218dff289SGiorgis Georgakoudis# If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom
128318dff289SGiorgis Georgakoudis# filter to add. For more information please see Qt Help Project / Custom
128418dff289SGiorgis Georgakoudis# Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-
128518dff289SGiorgis Georgakoudis# filters).
128618dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_QHP is set to YES.
128718dff289SGiorgis Georgakoudis
128818dff289SGiorgis GeorgakoudisQHP_CUST_FILTER_NAME   = @openmp_doxygen_qhp_cust_filter_name@
128918dff289SGiorgis Georgakoudis
129018dff289SGiorgis Georgakoudis# The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the
129118dff289SGiorgis Georgakoudis# custom filter to add. For more information please see Qt Help Project / Custom
129218dff289SGiorgis Georgakoudis# Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-
129318dff289SGiorgis Georgakoudis# filters).
129418dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_QHP is set to YES.
129518dff289SGiorgis Georgakoudis
129618dff289SGiorgis GeorgakoudisQHP_CUST_FILTER_ATTRS  = @openmp_doxygen_qhp_cust_filter_attrs@
129718dff289SGiorgis Georgakoudis
129818dff289SGiorgis Georgakoudis# The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this
129918dff289SGiorgis Georgakoudis# project's filter section matches. Qt Help Project / Filter Attributes (see:
130018dff289SGiorgis Georgakoudis# http://qt-project.org/doc/qt-4.8/qthelpproject.html#filter-attributes).
130118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_QHP is set to YES.
130218dff289SGiorgis Georgakoudis
130318dff289SGiorgis GeorgakoudisQHP_SECT_FILTER_ATTRS  =
130418dff289SGiorgis Georgakoudis
130518dff289SGiorgis Georgakoudis# The QHG_LOCATION tag can be used to specify the location of Qt's
130618dff289SGiorgis Georgakoudis# qhelpgenerator. If non-empty doxygen will try to run qhelpgenerator on the
130718dff289SGiorgis Georgakoudis# generated .qhp file.
130818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_QHP is set to YES.
130918dff289SGiorgis Georgakoudis
131018dff289SGiorgis GeorgakoudisQHG_LOCATION           = @openmp_doxygen_qhelpgenerator_path@
131118dff289SGiorgis Georgakoudis
131218dff289SGiorgis Georgakoudis# If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be
131318dff289SGiorgis Georgakoudis# generated, together with the HTML files, they form an Eclipse help plugin. To
131418dff289SGiorgis Georgakoudis# install this plugin and make it available under the help contents menu in
131518dff289SGiorgis Georgakoudis# Eclipse, the contents of the directory containing the HTML and XML files needs
131618dff289SGiorgis Georgakoudis# to be copied into the plugins directory of eclipse. The name of the directory
131718dff289SGiorgis Georgakoudis# within the plugins directory should be the same as the ECLIPSE_DOC_ID value.
131818dff289SGiorgis Georgakoudis# After copying Eclipse needs to be restarted before the help appears.
131918dff289SGiorgis Georgakoudis# The default value is: NO.
132018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
132118dff289SGiorgis Georgakoudis
132218dff289SGiorgis GeorgakoudisGENERATE_ECLIPSEHELP   = NO
132318dff289SGiorgis Georgakoudis
132418dff289SGiorgis Georgakoudis# A unique identifier for the Eclipse help plugin. When installing the plugin
132518dff289SGiorgis Georgakoudis# the directory name containing the HTML and XML files should also have this
132618dff289SGiorgis Georgakoudis# name. Each documentation set should have its own identifier.
132718dff289SGiorgis Georgakoudis# The default value is: org.doxygen.Project.
132818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES.
132918dff289SGiorgis Georgakoudis
133018dff289SGiorgis GeorgakoudisECLIPSE_DOC_ID         = org.doxygen.Project
133118dff289SGiorgis Georgakoudis
133218dff289SGiorgis Georgakoudis# If you want full control over the layout of the generated HTML pages it might
133318dff289SGiorgis Georgakoudis# be necessary to disable the index and replace it with your own. The
133418dff289SGiorgis Georgakoudis# DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top
133518dff289SGiorgis Georgakoudis# of each HTML page. A value of NO enables the index and the value YES disables
133618dff289SGiorgis Georgakoudis# it. Since the tabs in the index contain the same information as the navigation
133718dff289SGiorgis Georgakoudis# tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES.
133818dff289SGiorgis Georgakoudis# The default value is: NO.
133918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
134018dff289SGiorgis Georgakoudis
134118dff289SGiorgis GeorgakoudisDISABLE_INDEX          = NO
134218dff289SGiorgis Georgakoudis
134318dff289SGiorgis Georgakoudis# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
134418dff289SGiorgis Georgakoudis# structure should be generated to display hierarchical information. If the tag
134518dff289SGiorgis Georgakoudis# value is set to YES, a side panel will be generated containing a tree-like
134618dff289SGiorgis Georgakoudis# index structure (just like the one that is generated for HTML Help). For this
134718dff289SGiorgis Georgakoudis# to work a browser that supports JavaScript, DHTML, CSS and frames is required
134818dff289SGiorgis Georgakoudis# (i.e. any modern browser). Windows users are probably better off using the
134918dff289SGiorgis Georgakoudis# HTML help feature. Via custom stylesheets (see HTML_EXTRA_STYLESHEET) one can
135018dff289SGiorgis Georgakoudis# further fine-tune the look of the index. As an example, the default style
135118dff289SGiorgis Georgakoudis# sheet generated by doxygen has an example that shows how to put an image at
135218dff289SGiorgis Georgakoudis# the root of the tree instead of the PROJECT_NAME. Since the tree basically has
135318dff289SGiorgis Georgakoudis# the same information as the tab index, you could consider setting
135418dff289SGiorgis Georgakoudis# DISABLE_INDEX to YES when enabling this option.
135518dff289SGiorgis Georgakoudis# The default value is: NO.
135618dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
135718dff289SGiorgis Georgakoudis
135818dff289SGiorgis GeorgakoudisGENERATE_TREEVIEW      = NO
135918dff289SGiorgis Georgakoudis
136018dff289SGiorgis Georgakoudis# The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that
136118dff289SGiorgis Georgakoudis# doxygen will group on one line in the generated HTML documentation.
136218dff289SGiorgis Georgakoudis#
136318dff289SGiorgis Georgakoudis# Note that a value of 0 will completely suppress the enum values from appearing
136418dff289SGiorgis Georgakoudis# in the overview section.
136518dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 20, default value: 4.
136618dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
136718dff289SGiorgis Georgakoudis
136818dff289SGiorgis GeorgakoudisENUM_VALUES_PER_LINE   = 4
136918dff289SGiorgis Georgakoudis
137018dff289SGiorgis Georgakoudis# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used
137118dff289SGiorgis Georgakoudis# to set the initial width (in pixels) of the frame in which the tree is shown.
137218dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 1500, default value: 250.
137318dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
137418dff289SGiorgis Georgakoudis
137518dff289SGiorgis GeorgakoudisTREEVIEW_WIDTH         = 250
137618dff289SGiorgis Georgakoudis
137718dff289SGiorgis Georgakoudis# When the EXT_LINKS_IN_WINDOW option is set to YES doxygen will open links to
137818dff289SGiorgis Georgakoudis# external symbols imported via tag files in a separate window.
137918dff289SGiorgis Georgakoudis# The default value is: NO.
138018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
138118dff289SGiorgis Georgakoudis
138218dff289SGiorgis GeorgakoudisEXT_LINKS_IN_WINDOW    = NO
138318dff289SGiorgis Georgakoudis
138418dff289SGiorgis Georgakoudis# Use this tag to change the font size of LaTeX formulas included as images in
138518dff289SGiorgis Georgakoudis# the HTML documentation. When you change the font size after a successful
138618dff289SGiorgis Georgakoudis# doxygen run you need to manually remove any form_*.png images from the HTML
138718dff289SGiorgis Georgakoudis# output directory to force them to be regenerated.
138818dff289SGiorgis Georgakoudis# Minimum value: 8, maximum value: 50, default value: 10.
138918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
139018dff289SGiorgis Georgakoudis
139118dff289SGiorgis GeorgakoudisFORMULA_FONTSIZE       = 10
139218dff289SGiorgis Georgakoudis
139318dff289SGiorgis Georgakoudis# Use the FORMULA_TRANPARENT tag to determine whether or not the images
139418dff289SGiorgis Georgakoudis# generated for formulas are transparent PNGs. Transparent PNGs are not
139518dff289SGiorgis Georgakoudis# supported properly for IE 6.0, but are supported on all modern browsers.
139618dff289SGiorgis Georgakoudis#
139718dff289SGiorgis Georgakoudis# Note that when changing this option you need to delete any form_*.png files in
139818dff289SGiorgis Georgakoudis# the HTML output directory before the changes have effect.
139918dff289SGiorgis Georgakoudis# The default value is: YES.
140018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
140118dff289SGiorgis Georgakoudis
140218dff289SGiorgis GeorgakoudisFORMULA_TRANSPARENT    = YES
140318dff289SGiorgis Georgakoudis
140418dff289SGiorgis Georgakoudis# Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see
140518dff289SGiorgis Georgakoudis# http://www.mathjax.org) which uses client side Javascript for the rendering
140618dff289SGiorgis Georgakoudis# instead of using prerendered bitmaps. Use this if you do not have LaTeX
140718dff289SGiorgis Georgakoudis# installed or if you want to formulas look prettier in the HTML output. When
140818dff289SGiorgis Georgakoudis# enabled you may also need to install MathJax separately and configure the path
140918dff289SGiorgis Georgakoudis# to it using the MATHJAX_RELPATH option.
141018dff289SGiorgis Georgakoudis# The default value is: NO.
141118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
141218dff289SGiorgis Georgakoudis
141318dff289SGiorgis GeorgakoudisUSE_MATHJAX            = NO
141418dff289SGiorgis Georgakoudis
141518dff289SGiorgis Georgakoudis# When MathJax is enabled you can set the default output format to be used for
141618dff289SGiorgis Georgakoudis# the MathJax output. See the MathJax site (see:
141718dff289SGiorgis Georgakoudis# http://docs.mathjax.org/en/latest/output.html) for more details.
141818dff289SGiorgis Georgakoudis# Possible values are: HTML-CSS (which is slower, but has the best
141918dff289SGiorgis Georgakoudis# compatibility), NativeMML (i.e. MathML) and SVG.
142018dff289SGiorgis Georgakoudis# The default value is: HTML-CSS.
142118dff289SGiorgis Georgakoudis# This tag requires that the tag USE_MATHJAX is set to YES.
142218dff289SGiorgis Georgakoudis
142318dff289SGiorgis GeorgakoudisMATHJAX_FORMAT         = HTML-CSS
142418dff289SGiorgis Georgakoudis
142518dff289SGiorgis Georgakoudis# When MathJax is enabled you need to specify the location relative to the HTML
142618dff289SGiorgis Georgakoudis# output directory using the MATHJAX_RELPATH option. The destination directory
142718dff289SGiorgis Georgakoudis# should contain the MathJax.js script. For instance, if the mathjax directory
142818dff289SGiorgis Georgakoudis# is located at the same level as the HTML output directory, then
142918dff289SGiorgis Georgakoudis# MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax
143018dff289SGiorgis Georgakoudis# Content Delivery Network so you can quickly see the result without installing
143118dff289SGiorgis Georgakoudis# MathJax. However, it is strongly recommended to install a local copy of
143218dff289SGiorgis Georgakoudis# MathJax from http://www.mathjax.org before deployment.
143318dff289SGiorgis Georgakoudis# The default value is: http://cdn.mathjax.org/mathjax/latest.
143418dff289SGiorgis Georgakoudis# This tag requires that the tag USE_MATHJAX is set to YES.
143518dff289SGiorgis Georgakoudis
143618dff289SGiorgis GeorgakoudisMATHJAX_RELPATH        = http://cdn.mathjax.org/mathjax/latest
143718dff289SGiorgis Georgakoudis
143818dff289SGiorgis Georgakoudis# The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax
143918dff289SGiorgis Georgakoudis# extension names that should be enabled during MathJax rendering. For example
144018dff289SGiorgis Georgakoudis# MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols
144118dff289SGiorgis Georgakoudis# This tag requires that the tag USE_MATHJAX is set to YES.
144218dff289SGiorgis Georgakoudis
144318dff289SGiorgis GeorgakoudisMATHJAX_EXTENSIONS     =
144418dff289SGiorgis Georgakoudis
144518dff289SGiorgis Georgakoudis# The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces
144618dff289SGiorgis Georgakoudis# of code that will be used on startup of the MathJax code. See the MathJax site
144718dff289SGiorgis Georgakoudis# (see: http://docs.mathjax.org/en/latest/output.html) for more details. For an
144818dff289SGiorgis Georgakoudis# example see the documentation.
144918dff289SGiorgis Georgakoudis# This tag requires that the tag USE_MATHJAX is set to YES.
145018dff289SGiorgis Georgakoudis
145118dff289SGiorgis GeorgakoudisMATHJAX_CODEFILE       =
145218dff289SGiorgis Georgakoudis
145318dff289SGiorgis Georgakoudis# When the SEARCHENGINE tag is enabled doxygen will generate a search box for
145418dff289SGiorgis Georgakoudis# the HTML output. The underlying search engine uses javascript and DHTML and
145518dff289SGiorgis Georgakoudis# should work on any modern browser. Note that when using HTML help
145618dff289SGiorgis Georgakoudis# (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET)
145718dff289SGiorgis Georgakoudis# there is already a search function so this one should typically be disabled.
145818dff289SGiorgis Georgakoudis# For large projects the javascript based search engine can be slow, then
145918dff289SGiorgis Georgakoudis# enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to
146018dff289SGiorgis Georgakoudis# search using the keyboard; to jump to the search box use <access key> + S
146118dff289SGiorgis Georgakoudis# (what the <access key> is depends on the OS and browser, but it is typically
146218dff289SGiorgis Georgakoudis# <CTRL>, <ALT>/<option>, or both). Inside the search box use the <cursor down
146318dff289SGiorgis Georgakoudis# key> to jump into the search results window, the results can be navigated
146418dff289SGiorgis Georgakoudis# using the <cursor keys>. Press <Enter> to select an item or <escape> to cancel
146518dff289SGiorgis Georgakoudis# the search. The filter options can be selected when the cursor is inside the
146618dff289SGiorgis Georgakoudis# search box by pressing <Shift>+<cursor down>. Also here use the <cursor keys>
146718dff289SGiorgis Georgakoudis# to select a filter and <Enter> or <escape> to activate or cancel the filter
146818dff289SGiorgis Georgakoudis# option.
146918dff289SGiorgis Georgakoudis# The default value is: YES.
147018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_HTML is set to YES.
147118dff289SGiorgis Georgakoudis
147218dff289SGiorgis GeorgakoudisSEARCHENGINE           = @enable_searchengine@
147318dff289SGiorgis Georgakoudis
147418dff289SGiorgis Georgakoudis# When the SERVER_BASED_SEARCH tag is enabled the search engine will be
147518dff289SGiorgis Georgakoudis# implemented using a web server instead of a web client using Javascript. There
147618dff289SGiorgis Georgakoudis# are two flavours of web server based searching depending on the
147718dff289SGiorgis Georgakoudis# EXTERNAL_SEARCH setting. When disabled, doxygen will generate a PHP script for
147818dff289SGiorgis Georgakoudis# searching and an index file used by the script. When EXTERNAL_SEARCH is
147918dff289SGiorgis Georgakoudis# enabled the indexing and searching needs to be provided by external tools. See
148018dff289SGiorgis Georgakoudis# the section "External Indexing and Searching" for details.
148118dff289SGiorgis Georgakoudis# The default value is: NO.
148218dff289SGiorgis Georgakoudis# This tag requires that the tag SEARCHENGINE is set to YES.
148318dff289SGiorgis Georgakoudis
148418dff289SGiorgis GeorgakoudisSERVER_BASED_SEARCH    = @enable_server_based_search@
148518dff289SGiorgis Georgakoudis
148618dff289SGiorgis Georgakoudis# When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP
148718dff289SGiorgis Georgakoudis# script for searching. Instead the search results are written to an XML file
148818dff289SGiorgis Georgakoudis# which needs to be processed by an external indexer. Doxygen will invoke an
148918dff289SGiorgis Georgakoudis# external search engine pointed to by the SEARCHENGINE_URL option to obtain the
149018dff289SGiorgis Georgakoudis# search results.
149118dff289SGiorgis Georgakoudis#
149218dff289SGiorgis Georgakoudis# Doxygen ships with an example indexer ( doxyindexer) and search engine
149318dff289SGiorgis Georgakoudis# (doxysearch.cgi) which are based on the open source search engine library
149418dff289SGiorgis Georgakoudis# Xapian (see: http://xapian.org/).
149518dff289SGiorgis Georgakoudis#
149618dff289SGiorgis Georgakoudis# See the section "External Indexing and Searching" for details.
149718dff289SGiorgis Georgakoudis# The default value is: NO.
149818dff289SGiorgis Georgakoudis# This tag requires that the tag SEARCHENGINE is set to YES.
149918dff289SGiorgis Georgakoudis
150018dff289SGiorgis GeorgakoudisEXTERNAL_SEARCH        = @enable_external_search@
150118dff289SGiorgis Georgakoudis
150218dff289SGiorgis Georgakoudis# The SEARCHENGINE_URL should point to a search engine hosted by a web server
150318dff289SGiorgis Georgakoudis# which will return the search results when EXTERNAL_SEARCH is enabled.
150418dff289SGiorgis Georgakoudis#
150518dff289SGiorgis Georgakoudis# Doxygen ships with an example indexer ( doxyindexer) and search engine
150618dff289SGiorgis Georgakoudis# (doxysearch.cgi) which are based on the open source search engine library
150718dff289SGiorgis Georgakoudis# Xapian (see: http://xapian.org/). See the section "External Indexing and
150818dff289SGiorgis Georgakoudis# Searching" for details.
150918dff289SGiorgis Georgakoudis# This tag requires that the tag SEARCHENGINE is set to YES.
151018dff289SGiorgis Georgakoudis
151118dff289SGiorgis GeorgakoudisSEARCHENGINE_URL       = @searchengine_url@
151218dff289SGiorgis Georgakoudis
151318dff289SGiorgis Georgakoudis# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the unindexed
151418dff289SGiorgis Georgakoudis# search data is written to a file for indexing by an external tool. With the
151518dff289SGiorgis Georgakoudis# SEARCHDATA_FILE tag the name of this file can be specified.
151618dff289SGiorgis Georgakoudis# The default file is: searchdata.xml.
151718dff289SGiorgis Georgakoudis# This tag requires that the tag SEARCHENGINE is set to YES.
151818dff289SGiorgis Georgakoudis
151918dff289SGiorgis GeorgakoudisSEARCHDATA_FILE        = searchdata.xml
152018dff289SGiorgis Georgakoudis
152118dff289SGiorgis Georgakoudis# When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the
152218dff289SGiorgis Georgakoudis# EXTERNAL_SEARCH_ID tag can be used as an identifier for the project. This is
152318dff289SGiorgis Georgakoudis# useful in combination with EXTRA_SEARCH_MAPPINGS to search through multiple
152418dff289SGiorgis Georgakoudis# projects and redirect the results back to the right project.
152518dff289SGiorgis Georgakoudis# This tag requires that the tag SEARCHENGINE is set to YES.
152618dff289SGiorgis Georgakoudis
152718dff289SGiorgis GeorgakoudisEXTERNAL_SEARCH_ID     = openmp
152818dff289SGiorgis Georgakoudis
152918dff289SGiorgis Georgakoudis# The EXTRA_SEARCH_MAPPINGS tag can be used to enable searching through doxygen
153018dff289SGiorgis Georgakoudis# projects other than the one defined by this configuration file, but that are
153118dff289SGiorgis Georgakoudis# all added to the same external search index. Each project needs to have a
153218dff289SGiorgis Georgakoudis# unique id set via EXTERNAL_SEARCH_ID. The search mapping then maps the id of
153318dff289SGiorgis Georgakoudis# to a relative location where the documentation can be found. The format is:
153418dff289SGiorgis Georgakoudis# EXTRA_SEARCH_MAPPINGS = tagname1=loc1 tagname2=loc2 ...
153518dff289SGiorgis Georgakoudis# This tag requires that the tag SEARCHENGINE is set to YES.
153618dff289SGiorgis Georgakoudis
153718dff289SGiorgis GeorgakoudisEXTRA_SEARCH_MAPPINGS  = @extra_search_mappings@
153818dff289SGiorgis Georgakoudis
153918dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
154018dff289SGiorgis Georgakoudis# Configuration options related to the LaTeX output
154118dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
154218dff289SGiorgis Georgakoudis
154318dff289SGiorgis Georgakoudis# If the GENERATE_LATEX tag is set to YES doxygen will generate LaTeX output.
154418dff289SGiorgis Georgakoudis# The default value is: YES.
154518dff289SGiorgis Georgakoudis
154618dff289SGiorgis GeorgakoudisGENERATE_LATEX         = NO
154718dff289SGiorgis Georgakoudis
154818dff289SGiorgis Georgakoudis# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
154918dff289SGiorgis Georgakoudis# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
155018dff289SGiorgis Georgakoudis# it.
155118dff289SGiorgis Georgakoudis# The default directory is: latex.
155218dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
155318dff289SGiorgis Georgakoudis
155418dff289SGiorgis GeorgakoudisLATEX_OUTPUT           = latex
155518dff289SGiorgis Georgakoudis
155618dff289SGiorgis Georgakoudis# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
155718dff289SGiorgis Georgakoudis# invoked.
155818dff289SGiorgis Georgakoudis#
155918dff289SGiorgis Georgakoudis# Note that when enabling USE_PDFLATEX this option is only used for generating
156018dff289SGiorgis Georgakoudis# bitmaps for formulas in the HTML output, but not in the Makefile that is
156118dff289SGiorgis Georgakoudis# written to the output directory.
156218dff289SGiorgis Georgakoudis# The default file is: latex.
156318dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
156418dff289SGiorgis Georgakoudis
156518dff289SGiorgis GeorgakoudisLATEX_CMD_NAME         = latex
156618dff289SGiorgis Georgakoudis
156718dff289SGiorgis Georgakoudis# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate
156818dff289SGiorgis Georgakoudis# index for LaTeX.
156918dff289SGiorgis Georgakoudis# The default file is: makeindex.
157018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
157118dff289SGiorgis Georgakoudis
157218dff289SGiorgis GeorgakoudisMAKEINDEX_CMD_NAME     = makeindex
157318dff289SGiorgis Georgakoudis
157418dff289SGiorgis Georgakoudis# If the COMPACT_LATEX tag is set to YES doxygen generates more compact LaTeX
157518dff289SGiorgis Georgakoudis# documents. This may be useful for small projects and may help to save some
157618dff289SGiorgis Georgakoudis# trees in general.
157718dff289SGiorgis Georgakoudis# The default value is: NO.
157818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
157918dff289SGiorgis Georgakoudis
158018dff289SGiorgis GeorgakoudisCOMPACT_LATEX          = NO
158118dff289SGiorgis Georgakoudis
158218dff289SGiorgis Georgakoudis# The PAPER_TYPE tag can be used to set the paper type that is used by the
158318dff289SGiorgis Georgakoudis# printer.
158418dff289SGiorgis Georgakoudis# Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x
158518dff289SGiorgis Georgakoudis# 14 inches) and executive (7.25 x 10.5 inches).
158618dff289SGiorgis Georgakoudis# The default value is: a4.
158718dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
158818dff289SGiorgis Georgakoudis
158918dff289SGiorgis GeorgakoudisPAPER_TYPE             = a4
159018dff289SGiorgis Georgakoudis
159118dff289SGiorgis Georgakoudis# The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
159218dff289SGiorgis Georgakoudis# that should be included in the LaTeX output. To get the times font for
159318dff289SGiorgis Georgakoudis# instance you can specify
159418dff289SGiorgis Georgakoudis# EXTRA_PACKAGES=times
159518dff289SGiorgis Georgakoudis# If left blank no extra packages will be included.
159618dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
159718dff289SGiorgis Georgakoudis
159818dff289SGiorgis GeorgakoudisEXTRA_PACKAGES         =
159918dff289SGiorgis Georgakoudis
160018dff289SGiorgis Georgakoudis# The LATEX_HEADER tag can be used to specify a personal LaTeX header for the
160118dff289SGiorgis Georgakoudis# generated LaTeX document. The header should contain everything until the first
160218dff289SGiorgis Georgakoudis# chapter. If it is left blank doxygen will generate a standard header. See
160318dff289SGiorgis Georgakoudis# section "Doxygen usage" for information on how to let doxygen write the
160418dff289SGiorgis Georgakoudis# default header to a separate file.
160518dff289SGiorgis Georgakoudis#
160618dff289SGiorgis Georgakoudis# Note: Only use a user-defined header if you know what you are doing! The
160718dff289SGiorgis Georgakoudis# following commands have a special meaning inside the header: $title,
160818dff289SGiorgis Georgakoudis# $datetime, $date, $doxygenversion, $projectname, $projectnumber. Doxygen will
160918dff289SGiorgis Georgakoudis# replace them by respectively the title of the page, the current date and time,
161018dff289SGiorgis Georgakoudis# only the current date, the version number of doxygen, the project name (see
161118dff289SGiorgis Georgakoudis# PROJECT_NAME), or the project number (see PROJECT_NUMBER).
161218dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
161318dff289SGiorgis Georgakoudis
161418dff289SGiorgis GeorgakoudisLATEX_HEADER           =
161518dff289SGiorgis Georgakoudis
161618dff289SGiorgis Georgakoudis# The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for the
161718dff289SGiorgis Georgakoudis# generated LaTeX document. The footer should contain everything after the last
161818dff289SGiorgis Georgakoudis# chapter. If it is left blank doxygen will generate a standard footer.
161918dff289SGiorgis Georgakoudis#
162018dff289SGiorgis Georgakoudis# Note: Only use a user-defined footer if you know what you are doing!
162118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
162218dff289SGiorgis Georgakoudis
162318dff289SGiorgis GeorgakoudisLATEX_FOOTER           =
162418dff289SGiorgis Georgakoudis
162518dff289SGiorgis Georgakoudis# The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or
162618dff289SGiorgis Georgakoudis# other source files which should be copied to the LATEX_OUTPUT output
162718dff289SGiorgis Georgakoudis# directory. Note that the files will be copied as-is; there are no commands or
162818dff289SGiorgis Georgakoudis# markers available.
162918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
163018dff289SGiorgis Georgakoudis
163118dff289SGiorgis GeorgakoudisLATEX_EXTRA_FILES      =
163218dff289SGiorgis Georgakoudis
163318dff289SGiorgis Georgakoudis# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is
163418dff289SGiorgis Georgakoudis# prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will
163518dff289SGiorgis Georgakoudis# contain links (just like the HTML output) instead of page references. This
163618dff289SGiorgis Georgakoudis# makes the output suitable for online browsing using a PDF viewer.
163718dff289SGiorgis Georgakoudis# The default value is: YES.
163818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
163918dff289SGiorgis Georgakoudis
164018dff289SGiorgis GeorgakoudisPDF_HYPERLINKS         = YES
164118dff289SGiorgis Georgakoudis
164218dff289SGiorgis Georgakoudis# If the LATEX_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate
164318dff289SGiorgis Georgakoudis# the PDF file directly from the LaTeX files. Set this option to YES to get a
164418dff289SGiorgis Georgakoudis# higher quality PDF documentation.
164518dff289SGiorgis Georgakoudis# The default value is: YES.
164618dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
164718dff289SGiorgis Georgakoudis
164818dff289SGiorgis GeorgakoudisUSE_PDFLATEX           = YES
164918dff289SGiorgis Georgakoudis
165018dff289SGiorgis Georgakoudis# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode
165118dff289SGiorgis Georgakoudis# command to the generated LaTeX files. This will instruct LaTeX to keep running
165218dff289SGiorgis Georgakoudis# if errors occur, instead of asking the user for help. This option is also used
165318dff289SGiorgis Georgakoudis# when generating formulas in HTML.
165418dff289SGiorgis Georgakoudis# The default value is: NO.
165518dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
165618dff289SGiorgis Georgakoudis
165718dff289SGiorgis GeorgakoudisLATEX_BATCHMODE        = NO
165818dff289SGiorgis Georgakoudis
165918dff289SGiorgis Georgakoudis# If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the
166018dff289SGiorgis Georgakoudis# index chapters (such as File Index, Compound Index, etc.) in the output.
166118dff289SGiorgis Georgakoudis# The default value is: NO.
166218dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
166318dff289SGiorgis Georgakoudis
166418dff289SGiorgis GeorgakoudisLATEX_HIDE_INDICES     = NO
166518dff289SGiorgis Georgakoudis
166618dff289SGiorgis Georgakoudis# If the LATEX_SOURCE_CODE tag is set to YES then doxygen will include source
166718dff289SGiorgis Georgakoudis# code with syntax highlighting in the LaTeX output.
166818dff289SGiorgis Georgakoudis#
166918dff289SGiorgis Georgakoudis# Note that which sources are shown also depends on other settings such as
167018dff289SGiorgis Georgakoudis# SOURCE_BROWSER.
167118dff289SGiorgis Georgakoudis# The default value is: NO.
167218dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
167318dff289SGiorgis Georgakoudis
167418dff289SGiorgis GeorgakoudisLATEX_SOURCE_CODE      = NO
167518dff289SGiorgis Georgakoudis
167618dff289SGiorgis Georgakoudis# The LATEX_BIB_STYLE tag can be used to specify the style to use for the
167718dff289SGiorgis Georgakoudis# bibliography, e.g. plainnat, or ieeetr. See
167818dff289SGiorgis Georgakoudis# http://en.wikipedia.org/wiki/BibTeX and \cite for more info.
167918dff289SGiorgis Georgakoudis# The default value is: plain.
168018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_LATEX is set to YES.
168118dff289SGiorgis Georgakoudis
168218dff289SGiorgis GeorgakoudisLATEX_BIB_STYLE        = plain
168318dff289SGiorgis Georgakoudis
168418dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
168518dff289SGiorgis Georgakoudis# Configuration options related to the RTF output
168618dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
168718dff289SGiorgis Georgakoudis
168818dff289SGiorgis Georgakoudis# If the GENERATE_RTF tag is set to YES doxygen will generate RTF output. The
168918dff289SGiorgis Georgakoudis# RTF output is optimized for Word 97 and may not look too pretty with other RTF
169018dff289SGiorgis Georgakoudis# readers/editors.
169118dff289SGiorgis Georgakoudis# The default value is: NO.
169218dff289SGiorgis Georgakoudis
169318dff289SGiorgis GeorgakoudisGENERATE_RTF           = NO
169418dff289SGiorgis Georgakoudis
169518dff289SGiorgis Georgakoudis# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a
169618dff289SGiorgis Georgakoudis# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
169718dff289SGiorgis Georgakoudis# it.
169818dff289SGiorgis Georgakoudis# The default directory is: rtf.
169918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_RTF is set to YES.
170018dff289SGiorgis Georgakoudis
170118dff289SGiorgis GeorgakoudisRTF_OUTPUT             = rtf
170218dff289SGiorgis Georgakoudis
170318dff289SGiorgis Georgakoudis# If the COMPACT_RTF tag is set to YES doxygen generates more compact RTF
170418dff289SGiorgis Georgakoudis# documents. This may be useful for small projects and may help to save some
170518dff289SGiorgis Georgakoudis# trees in general.
170618dff289SGiorgis Georgakoudis# The default value is: NO.
170718dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_RTF is set to YES.
170818dff289SGiorgis Georgakoudis
170918dff289SGiorgis GeorgakoudisCOMPACT_RTF            = NO
171018dff289SGiorgis Georgakoudis
171118dff289SGiorgis Georgakoudis# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will
171218dff289SGiorgis Georgakoudis# contain hyperlink fields. The RTF file will contain links (just like the HTML
171318dff289SGiorgis Georgakoudis# output) instead of page references. This makes the output suitable for online
171418dff289SGiorgis Georgakoudis# browsing using Word or some other Word compatible readers that support those
171518dff289SGiorgis Georgakoudis# fields.
171618dff289SGiorgis Georgakoudis#
171718dff289SGiorgis Georgakoudis# Note: WordPad (write) and others do not support links.
171818dff289SGiorgis Georgakoudis# The default value is: NO.
171918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_RTF is set to YES.
172018dff289SGiorgis Georgakoudis
172118dff289SGiorgis GeorgakoudisRTF_HYPERLINKS         = NO
172218dff289SGiorgis Georgakoudis
172318dff289SGiorgis Georgakoudis# Load stylesheet definitions from file. Syntax is similar to doxygen's config
172418dff289SGiorgis Georgakoudis# file, i.e. a series of assignments. You only have to provide replacements,
172518dff289SGiorgis Georgakoudis# missing definitions are set to their default value.
172618dff289SGiorgis Georgakoudis#
172718dff289SGiorgis Georgakoudis# See also section "Doxygen usage" for information on how to generate the
172818dff289SGiorgis Georgakoudis# default style sheet that doxygen normally uses.
172918dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_RTF is set to YES.
173018dff289SGiorgis Georgakoudis
173118dff289SGiorgis GeorgakoudisRTF_STYLESHEET_FILE    =
173218dff289SGiorgis Georgakoudis
173318dff289SGiorgis Georgakoudis# Set optional variables used in the generation of an RTF document. Syntax is
173418dff289SGiorgis Georgakoudis# similar to doxygen's config file. A template extensions file can be generated
173518dff289SGiorgis Georgakoudis# using doxygen -e rtf extensionFile.
173618dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_RTF is set to YES.
173718dff289SGiorgis Georgakoudis
173818dff289SGiorgis GeorgakoudisRTF_EXTENSIONS_FILE    =
173918dff289SGiorgis Georgakoudis
174018dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
174118dff289SGiorgis Georgakoudis# Configuration options related to the man page output
174218dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
174318dff289SGiorgis Georgakoudis
174418dff289SGiorgis Georgakoudis# If the GENERATE_MAN tag is set to YES doxygen will generate man pages for
174518dff289SGiorgis Georgakoudis# classes and files.
174618dff289SGiorgis Georgakoudis# The default value is: NO.
174718dff289SGiorgis Georgakoudis
174818dff289SGiorgis GeorgakoudisGENERATE_MAN           = NO
174918dff289SGiorgis Georgakoudis
175018dff289SGiorgis Georgakoudis# The MAN_OUTPUT tag is used to specify where the man pages will be put. If a
175118dff289SGiorgis Georgakoudis# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
175218dff289SGiorgis Georgakoudis# it. A directory man3 will be created inside the directory specified by
175318dff289SGiorgis Georgakoudis# MAN_OUTPUT.
175418dff289SGiorgis Georgakoudis# The default directory is: man.
175518dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_MAN is set to YES.
175618dff289SGiorgis Georgakoudis
175718dff289SGiorgis GeorgakoudisMAN_OUTPUT             = man
175818dff289SGiorgis Georgakoudis
175918dff289SGiorgis Georgakoudis# The MAN_EXTENSION tag determines the extension that is added to the generated
176018dff289SGiorgis Georgakoudis# man pages. In case the manual section does not start with a number, the number
176118dff289SGiorgis Georgakoudis# 3 is prepended. The dot (.) at the beginning of the MAN_EXTENSION tag is
176218dff289SGiorgis Georgakoudis# optional.
176318dff289SGiorgis Georgakoudis# The default value is: .3.
176418dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_MAN is set to YES.
176518dff289SGiorgis Georgakoudis
176618dff289SGiorgis GeorgakoudisMAN_EXTENSION          = .3
176718dff289SGiorgis Georgakoudis
176818dff289SGiorgis Georgakoudis# If the MAN_LINKS tag is set to YES and doxygen generates man output, then it
176918dff289SGiorgis Georgakoudis# will generate one additional man file for each entity documented in the real
177018dff289SGiorgis Georgakoudis# man page(s). These additional files only source the real man page, but without
177118dff289SGiorgis Georgakoudis# them the man command would be unable to find the correct page.
177218dff289SGiorgis Georgakoudis# The default value is: NO.
177318dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_MAN is set to YES.
177418dff289SGiorgis Georgakoudis
177518dff289SGiorgis GeorgakoudisMAN_LINKS              = NO
177618dff289SGiorgis Georgakoudis
177718dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
177818dff289SGiorgis Georgakoudis# Configuration options related to the XML output
177918dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
178018dff289SGiorgis Georgakoudis
178118dff289SGiorgis Georgakoudis# If the GENERATE_XML tag is set to YES doxygen will generate an XML file that
178218dff289SGiorgis Georgakoudis# captures the structure of the code including all documentation.
178318dff289SGiorgis Georgakoudis# The default value is: NO.
178418dff289SGiorgis Georgakoudis
178518dff289SGiorgis GeorgakoudisGENERATE_XML           = NO
178618dff289SGiorgis Georgakoudis
178718dff289SGiorgis Georgakoudis# The XML_OUTPUT tag is used to specify where the XML pages will be put. If a
178818dff289SGiorgis Georgakoudis# relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
178918dff289SGiorgis Georgakoudis# it.
179018dff289SGiorgis Georgakoudis# The default directory is: xml.
179118dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_XML is set to YES.
179218dff289SGiorgis Georgakoudis
179318dff289SGiorgis GeorgakoudisXML_OUTPUT             = xml
179418dff289SGiorgis Georgakoudis
179518dff289SGiorgis Georgakoudis# If the XML_PROGRAMLISTING tag is set to YES doxygen will dump the program
179618dff289SGiorgis Georgakoudis# listings (including syntax highlighting and cross-referencing information) to
179718dff289SGiorgis Georgakoudis# the XML output. Note that enabling this will significantly increase the size
179818dff289SGiorgis Georgakoudis# of the XML output.
179918dff289SGiorgis Georgakoudis# The default value is: YES.
180018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_XML is set to YES.
180118dff289SGiorgis Georgakoudis
180218dff289SGiorgis GeorgakoudisXML_PROGRAMLISTING     = YES
180318dff289SGiorgis Georgakoudis
180418dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
180518dff289SGiorgis Georgakoudis# Configuration options related to the DOCBOOK output
180618dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
180718dff289SGiorgis Georgakoudis
180818dff289SGiorgis Georgakoudis# If the GENERATE_DOCBOOK tag is set to YES doxygen will generate Docbook files
180918dff289SGiorgis Georgakoudis# that can be used to generate PDF.
181018dff289SGiorgis Georgakoudis# The default value is: NO.
181118dff289SGiorgis Georgakoudis
181218dff289SGiorgis GeorgakoudisGENERATE_DOCBOOK       = NO
181318dff289SGiorgis Georgakoudis
181418dff289SGiorgis Georgakoudis# The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put.
181518dff289SGiorgis Georgakoudis# If a relative path is entered the value of OUTPUT_DIRECTORY will be put in
181618dff289SGiorgis Georgakoudis# front of it.
181718dff289SGiorgis Georgakoudis# The default directory is: docbook.
181818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_DOCBOOK is set to YES.
181918dff289SGiorgis Georgakoudis
182018dff289SGiorgis GeorgakoudisDOCBOOK_OUTPUT         = docbook
182118dff289SGiorgis Georgakoudis
182218dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
182318dff289SGiorgis Georgakoudis# Configuration options for the AutoGen Definitions output
182418dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
182518dff289SGiorgis Georgakoudis
182618dff289SGiorgis Georgakoudis# If the GENERATE_AUTOGEN_DEF tag is set to YES doxygen will generate an AutoGen
182718dff289SGiorgis Georgakoudis# Definitions (see http://autogen.sf.net) file that captures the structure of
182818dff289SGiorgis Georgakoudis# the code including all documentation. Note that this feature is still
182918dff289SGiorgis Georgakoudis# experimental and incomplete at the moment.
183018dff289SGiorgis Georgakoudis# The default value is: NO.
183118dff289SGiorgis Georgakoudis
183218dff289SGiorgis GeorgakoudisGENERATE_AUTOGEN_DEF   = NO
183318dff289SGiorgis Georgakoudis
183418dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
183518dff289SGiorgis Georgakoudis# Configuration options related to the Perl module output
183618dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
183718dff289SGiorgis Georgakoudis
183818dff289SGiorgis Georgakoudis# If the GENERATE_PERLMOD tag is set to YES doxygen will generate a Perl module
183918dff289SGiorgis Georgakoudis# file that captures the structure of the code including all documentation.
184018dff289SGiorgis Georgakoudis#
184118dff289SGiorgis Georgakoudis# Note that this feature is still experimental and incomplete at the moment.
184218dff289SGiorgis Georgakoudis# The default value is: NO.
184318dff289SGiorgis Georgakoudis
184418dff289SGiorgis GeorgakoudisGENERATE_PERLMOD       = NO
184518dff289SGiorgis Georgakoudis
184618dff289SGiorgis Georgakoudis# If the PERLMOD_LATEX tag is set to YES doxygen will generate the necessary
184718dff289SGiorgis Georgakoudis# Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI
184818dff289SGiorgis Georgakoudis# output from the Perl module output.
184918dff289SGiorgis Georgakoudis# The default value is: NO.
185018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_PERLMOD is set to YES.
185118dff289SGiorgis Georgakoudis
185218dff289SGiorgis GeorgakoudisPERLMOD_LATEX          = NO
185318dff289SGiorgis Georgakoudis
185418dff289SGiorgis Georgakoudis# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be nicely
185518dff289SGiorgis Georgakoudis# formatted so it can be parsed by a human reader. This is useful if you want to
185618dff289SGiorgis Georgakoudis# understand what is going on. On the other hand, if this tag is set to NO the
185718dff289SGiorgis Georgakoudis# size of the Perl module output will be much smaller and Perl will parse it
185818dff289SGiorgis Georgakoudis# just the same.
185918dff289SGiorgis Georgakoudis# The default value is: YES.
186018dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_PERLMOD is set to YES.
186118dff289SGiorgis Georgakoudis
186218dff289SGiorgis GeorgakoudisPERLMOD_PRETTY         = YES
186318dff289SGiorgis Georgakoudis
186418dff289SGiorgis Georgakoudis# The names of the make variables in the generated doxyrules.make file are
186518dff289SGiorgis Georgakoudis# prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. This is useful
186618dff289SGiorgis Georgakoudis# so different doxyrules.make files included by the same Makefile don't
186718dff289SGiorgis Georgakoudis# overwrite each other's variables.
186818dff289SGiorgis Georgakoudis# This tag requires that the tag GENERATE_PERLMOD is set to YES.
186918dff289SGiorgis Georgakoudis
187018dff289SGiorgis GeorgakoudisPERLMOD_MAKEVAR_PREFIX =
187118dff289SGiorgis Georgakoudis
187218dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
187318dff289SGiorgis Georgakoudis# Configuration options related to the preprocessor
187418dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
187518dff289SGiorgis Georgakoudis
187618dff289SGiorgis Georgakoudis# If the ENABLE_PREPROCESSING tag is set to YES doxygen will evaluate all
187718dff289SGiorgis Georgakoudis# C-preprocessor directives found in the sources and include files.
187818dff289SGiorgis Georgakoudis# The default value is: YES.
187918dff289SGiorgis Georgakoudis
188018dff289SGiorgis GeorgakoudisENABLE_PREPROCESSING   = YES
188118dff289SGiorgis Georgakoudis
188218dff289SGiorgis Georgakoudis# If the MACRO_EXPANSION tag is set to YES doxygen will expand all macro names
188318dff289SGiorgis Georgakoudis# in the source code. If set to NO only conditional compilation will be
188418dff289SGiorgis Georgakoudis# performed. Macro expansion can be done in a controlled way by setting
188518dff289SGiorgis Georgakoudis# EXPAND_ONLY_PREDEF to YES.
188618dff289SGiorgis Georgakoudis# The default value is: NO.
188718dff289SGiorgis Georgakoudis# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
188818dff289SGiorgis Georgakoudis
188918dff289SGiorgis GeorgakoudisMACRO_EXPANSION        = YES
189018dff289SGiorgis Georgakoudis
189118dff289SGiorgis Georgakoudis# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then
189218dff289SGiorgis Georgakoudis# the macro expansion is limited to the macros specified with the PREDEFINED and
189318dff289SGiorgis Georgakoudis# EXPAND_AS_DEFINED tags.
189418dff289SGiorgis Georgakoudis# The default value is: NO.
189518dff289SGiorgis Georgakoudis# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
189618dff289SGiorgis Georgakoudis
189718dff289SGiorgis GeorgakoudisEXPAND_ONLY_PREDEF     = YES
189818dff289SGiorgis Georgakoudis
189918dff289SGiorgis Georgakoudis# If the SEARCH_INCLUDES tag is set to YES the includes files in the
190018dff289SGiorgis Georgakoudis# INCLUDE_PATH will be searched if a #include is found.
190118dff289SGiorgis Georgakoudis# The default value is: YES.
190218dff289SGiorgis Georgakoudis# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
190318dff289SGiorgis Georgakoudis
190418dff289SGiorgis GeorgakoudisSEARCH_INCLUDES        = YES
190518dff289SGiorgis Georgakoudis
190618dff289SGiorgis Georgakoudis# The INCLUDE_PATH tag can be used to specify one or more directories that
190718dff289SGiorgis Georgakoudis# contain include files that are not input files but should be processed by the
190818dff289SGiorgis Georgakoudis# preprocessor.
190918dff289SGiorgis Georgakoudis# This tag requires that the tag SEARCH_INCLUDES is set to YES.
191018dff289SGiorgis Georgakoudis
191118dff289SGiorgis GeorgakoudisINCLUDE_PATH           = ../include
191218dff289SGiorgis Georgakoudis
191318dff289SGiorgis Georgakoudis# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
191418dff289SGiorgis Georgakoudis# patterns (like *.h and *.hpp) to filter out the header-files in the
191518dff289SGiorgis Georgakoudis# directories. If left blank, the patterns specified with FILE_PATTERNS will be
191618dff289SGiorgis Georgakoudis# used.
191718dff289SGiorgis Georgakoudis# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
191818dff289SGiorgis Georgakoudis
191918dff289SGiorgis GeorgakoudisINCLUDE_FILE_PATTERNS  =
192018dff289SGiorgis Georgakoudis
192118dff289SGiorgis Georgakoudis# The PREDEFINED tag can be used to specify one or more macro names that are
192218dff289SGiorgis Georgakoudis# defined before the preprocessor is started (similar to the -D option of e.g.
192318dff289SGiorgis Georgakoudis# gcc). The argument of the tag is a list of macros of the form: name or
192418dff289SGiorgis Georgakoudis# name=definition (no spaces). If the definition and the "=" are omitted, "=1"
192518dff289SGiorgis Georgakoudis# is assumed. To prevent a macro definition from being undefined via #undef or
192618dff289SGiorgis Georgakoudis# recursively expanded use the := operator instead of the = operator.
192718dff289SGiorgis Georgakoudis# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
192818dff289SGiorgis Georgakoudis
192918dff289SGiorgis GeorgakoudisPREDEFINED             =
193018dff289SGiorgis Georgakoudis
193118dff289SGiorgis Georgakoudis# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
193218dff289SGiorgis Georgakoudis# tag can be used to specify a list of macro names that should be expanded. The
193318dff289SGiorgis Georgakoudis# macro definition that is found in the sources will be used. Use the PREDEFINED
193418dff289SGiorgis Georgakoudis# tag if you want to use a different macro definition that overrules the
193518dff289SGiorgis Georgakoudis# definition found in the source code.
193618dff289SGiorgis Georgakoudis# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
193718dff289SGiorgis Georgakoudis
193818dff289SGiorgis GeorgakoudisEXPAND_AS_DEFINED      =
193918dff289SGiorgis Georgakoudis
194018dff289SGiorgis Georgakoudis# If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will
194118dff289SGiorgis Georgakoudis# remove all references to function-like macros that are alone on a line, have an
194218dff289SGiorgis Georgakoudis# all uppercase name, and do not end with a semicolon. Such function macros are
194318dff289SGiorgis Georgakoudis# typically used for boiler-plate code, and will confuse the parser if not
194418dff289SGiorgis Georgakoudis# removed.
194518dff289SGiorgis Georgakoudis# The default value is: YES.
194618dff289SGiorgis Georgakoudis# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
194718dff289SGiorgis Georgakoudis
194818dff289SGiorgis GeorgakoudisSKIP_FUNCTION_MACROS   = YES
194918dff289SGiorgis Georgakoudis
195018dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
195118dff289SGiorgis Georgakoudis# Configuration options related to external references
195218dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
195318dff289SGiorgis Georgakoudis
195418dff289SGiorgis Georgakoudis# The TAGFILES tag can be used to specify one or more tag files. For each tag
195518dff289SGiorgis Georgakoudis# file the location of the external documentation should be added. The format of
195618dff289SGiorgis Georgakoudis# a tag file without this location is as follows:
195718dff289SGiorgis Georgakoudis# TAGFILES = file1 file2 ...
195818dff289SGiorgis Georgakoudis# Adding location for the tag files is done as follows:
195918dff289SGiorgis Georgakoudis# TAGFILES = file1=loc1 "file2 = loc2" ...
196018dff289SGiorgis Georgakoudis# where loc1 and loc2 can be relative or absolute paths or URLs. See the
196118dff289SGiorgis Georgakoudis# section "Linking to external documentation" for more information about the use
196218dff289SGiorgis Georgakoudis# of tag files.
196318dff289SGiorgis Georgakoudis# Note: Each tag file must have an unique name (where the name does NOT include
196418dff289SGiorgis Georgakoudis# the path). If a tag file is not located in the directory in which doxygen is
196518dff289SGiorgis Georgakoudis# run, you must also specify the path to the tagfile here.
196618dff289SGiorgis Georgakoudis
196718dff289SGiorgis GeorgakoudisTAGFILES               =
196818dff289SGiorgis Georgakoudis
196918dff289SGiorgis Georgakoudis# When a file name is specified after GENERATE_TAGFILE, doxygen will create a
197018dff289SGiorgis Georgakoudis# tag file that is based on the input files it reads. See section "Linking to
197118dff289SGiorgis Georgakoudis# external documentation" for more information about the usage of tag files.
197218dff289SGiorgis Georgakoudis
197318dff289SGiorgis GeorgakoudisGENERATE_TAGFILE       =
197418dff289SGiorgis Georgakoudis
197518dff289SGiorgis Georgakoudis# If the ALLEXTERNALS tag is set to YES all external class will be listed in the
197618dff289SGiorgis Georgakoudis# class index. If set to NO only the inherited external classes will be listed.
197718dff289SGiorgis Georgakoudis# The default value is: NO.
197818dff289SGiorgis Georgakoudis
197918dff289SGiorgis GeorgakoudisALLEXTERNALS           = YES
198018dff289SGiorgis Georgakoudis
198118dff289SGiorgis Georgakoudis# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed in
198218dff289SGiorgis Georgakoudis# the modules index. If set to NO, only the current project's groups will be
198318dff289SGiorgis Georgakoudis# listed.
198418dff289SGiorgis Georgakoudis# The default value is: YES.
198518dff289SGiorgis Georgakoudis
198618dff289SGiorgis GeorgakoudisEXTERNAL_GROUPS        = YES
198718dff289SGiorgis Georgakoudis
198818dff289SGiorgis Georgakoudis# If the EXTERNAL_PAGES tag is set to YES all external pages will be listed in
198918dff289SGiorgis Georgakoudis# the related pages index. If set to NO, only the current project's pages will
199018dff289SGiorgis Georgakoudis# be listed.
199118dff289SGiorgis Georgakoudis# The default value is: YES.
199218dff289SGiorgis Georgakoudis
199318dff289SGiorgis GeorgakoudisEXTERNAL_PAGES         = YES
199418dff289SGiorgis Georgakoudis
199518dff289SGiorgis Georgakoudis# The PERL_PATH should be the absolute path and name of the perl script
199618dff289SGiorgis Georgakoudis# interpreter (i.e. the result of 'which perl').
199718dff289SGiorgis Georgakoudis# The default file (with absolute path) is: /usr/bin/perl.
199818dff289SGiorgis Georgakoudis
199918dff289SGiorgis GeorgakoudisPERL_PATH              = /usr/bin/perl
200018dff289SGiorgis Georgakoudis
200118dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
200218dff289SGiorgis Georgakoudis# Configuration options related to the dot tool
200318dff289SGiorgis Georgakoudis#---------------------------------------------------------------------------
200418dff289SGiorgis Georgakoudis
200518dff289SGiorgis Georgakoudis# If the CLASS_DIAGRAMS tag is set to YES doxygen will generate a class diagram
200618dff289SGiorgis Georgakoudis# (in HTML and LaTeX) for classes with base or super classes. Setting the tag to
200718dff289SGiorgis Georgakoudis# NO turns the diagrams off. Note that this option also works with HAVE_DOT
200818dff289SGiorgis Georgakoudis# disabled, but it is recommended to install and use dot, since it yields more
200918dff289SGiorgis Georgakoudis# powerful graphs.
201018dff289SGiorgis Georgakoudis# The default value is: YES.
201118dff289SGiorgis Georgakoudis
201218dff289SGiorgis GeorgakoudisCLASS_DIAGRAMS         = YES
201318dff289SGiorgis Georgakoudis
201418dff289SGiorgis Georgakoudis# You can define message sequence charts within doxygen comments using the \msc
201518dff289SGiorgis Georgakoudis# command. Doxygen will then run the mscgen tool (see:
201618dff289SGiorgis Georgakoudis# http://www.mcternan.me.uk/mscgen/)) to produce the chart and insert it in the
201718dff289SGiorgis Georgakoudis# documentation. The MSCGEN_PATH tag allows you to specify the directory where
201818dff289SGiorgis Georgakoudis# the mscgen tool resides. If left empty the tool is assumed to be found in the
201918dff289SGiorgis Georgakoudis# default search path.
202018dff289SGiorgis Georgakoudis
202118dff289SGiorgis GeorgakoudisMSCGEN_PATH            =
202218dff289SGiorgis Georgakoudis
202318dff289SGiorgis Georgakoudis# You can include diagrams made with dia in doxygen documentation. Doxygen will
202418dff289SGiorgis Georgakoudis# then run dia to produce the diagram and insert it in the documentation. The
202518dff289SGiorgis Georgakoudis# DIA_PATH tag allows you to specify the directory where the dia binary resides.
202618dff289SGiorgis Georgakoudis# If left empty dia is assumed to be found in the default search path.
202718dff289SGiorgis Georgakoudis
202818dff289SGiorgis GeorgakoudisDIA_PATH               =
202918dff289SGiorgis Georgakoudis
203018dff289SGiorgis Georgakoudis# If set to YES, the inheritance and collaboration graphs will hide inheritance
203118dff289SGiorgis Georgakoudis# and usage relations if the target is undocumented or is not a class.
203218dff289SGiorgis Georgakoudis# The default value is: YES.
203318dff289SGiorgis Georgakoudis
203418dff289SGiorgis GeorgakoudisHIDE_UNDOC_RELATIONS   = NO
203518dff289SGiorgis Georgakoudis
203618dff289SGiorgis Georgakoudis# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
203718dff289SGiorgis Georgakoudis# available from the path. This tool is part of Graphviz (see:
203818dff289SGiorgis Georgakoudis# http://www.graphviz.org/), a graph visualization toolkit from AT&T and Lucent
203918dff289SGiorgis Georgakoudis# Bell Labs. The other options in this section have no effect if this option is
204018dff289SGiorgis Georgakoudis# set to NO
204118dff289SGiorgis Georgakoudis# The default value is: NO.
204218dff289SGiorgis Georgakoudis
204318dff289SGiorgis GeorgakoudisHAVE_DOT               = YES
204418dff289SGiorgis Georgakoudis
204518dff289SGiorgis Georgakoudis# The DOT_NUM_THREADS specifies the number of dot invocations doxygen is allowed
204618dff289SGiorgis Georgakoudis# to run in parallel. When set to 0 doxygen will base this on the number of
204718dff289SGiorgis Georgakoudis# processors available in the system. You can set it explicitly to a value
204818dff289SGiorgis Georgakoudis# larger than 0 to get control over the balance between CPU load and processing
204918dff289SGiorgis Georgakoudis# speed.
205018dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 32, default value: 0.
205118dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
205218dff289SGiorgis Georgakoudis
205318dff289SGiorgis GeorgakoudisDOT_NUM_THREADS        = 0
205418dff289SGiorgis Georgakoudis
205518dff289SGiorgis Georgakoudis# When you want a differently looking font n the dot files that doxygen
205618dff289SGiorgis Georgakoudis# generates you can specify the font name using DOT_FONTNAME. You need to make
205718dff289SGiorgis Georgakoudis# sure dot is able to find the font, which can be done by putting it in a
205818dff289SGiorgis Georgakoudis# standard location or by setting the DOTFONTPATH environment variable or by
205918dff289SGiorgis Georgakoudis# setting DOT_FONTPATH to the directory containing the font.
206018dff289SGiorgis Georgakoudis# The default value is: Helvetica.
206118dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
206218dff289SGiorgis Georgakoudis
206318dff289SGiorgis GeorgakoudisDOT_FONTNAME           = Helvetica
206418dff289SGiorgis Georgakoudis
206518dff289SGiorgis Georgakoudis# The DOT_FONTSIZE tag can be used to set the size (in points) of the font of
206618dff289SGiorgis Georgakoudis# dot graphs.
206718dff289SGiorgis Georgakoudis# Minimum value: 4, maximum value: 24, default value: 10.
206818dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
206918dff289SGiorgis Georgakoudis
207018dff289SGiorgis GeorgakoudisDOT_FONTSIZE           = 10
207118dff289SGiorgis Georgakoudis
207218dff289SGiorgis Georgakoudis# By default doxygen will tell dot to use the default font as specified with
207318dff289SGiorgis Georgakoudis# DOT_FONTNAME. If you specify a different font using DOT_FONTNAME you can set
207418dff289SGiorgis Georgakoudis# the path where dot can find it using this tag.
207518dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
207618dff289SGiorgis Georgakoudis
207718dff289SGiorgis GeorgakoudisDOT_FONTPATH           =
207818dff289SGiorgis Georgakoudis
207918dff289SGiorgis Georgakoudis# If the CLASS_GRAPH tag is set to YES then doxygen will generate a graph for
208018dff289SGiorgis Georgakoudis# each documented class showing the direct and indirect inheritance relations.
208118dff289SGiorgis Georgakoudis# Setting this tag to YES will force the CLASS_DIAGRAMS tag to NO.
208218dff289SGiorgis Georgakoudis# The default value is: YES.
208318dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
208418dff289SGiorgis Georgakoudis
208518dff289SGiorgis GeorgakoudisCLASS_GRAPH            = YES
208618dff289SGiorgis Georgakoudis
208718dff289SGiorgis Georgakoudis# If the COLLABORATION_GRAPH tag is set to YES then doxygen will generate a
208818dff289SGiorgis Georgakoudis# graph for each documented class showing the direct and indirect implementation
208918dff289SGiorgis Georgakoudis# dependencies (inheritance, containment, and class references variables) of the
209018dff289SGiorgis Georgakoudis# class with other documented classes.
209118dff289SGiorgis Georgakoudis# The default value is: YES.
209218dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
209318dff289SGiorgis Georgakoudis
2094*eadf6db5STimm BäderCOLLABORATION_GRAPH    = NO
209518dff289SGiorgis Georgakoudis
209618dff289SGiorgis Georgakoudis# If the GROUP_GRAPHS tag is set to YES then doxygen will generate a graph for
209718dff289SGiorgis Georgakoudis# groups, showing the direct groups dependencies.
209818dff289SGiorgis Georgakoudis# The default value is: YES.
209918dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
210018dff289SGiorgis Georgakoudis
210118dff289SGiorgis GeorgakoudisGROUP_GRAPHS           = YES
210218dff289SGiorgis Georgakoudis
210318dff289SGiorgis Georgakoudis# If the UML_LOOK tag is set to YES doxygen will generate inheritance and
210418dff289SGiorgis Georgakoudis# collaboration diagrams in a style similar to the OMG's Unified Modeling
210518dff289SGiorgis Georgakoudis# Language.
210618dff289SGiorgis Georgakoudis# The default value is: NO.
210718dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
210818dff289SGiorgis Georgakoudis
210918dff289SGiorgis GeorgakoudisUML_LOOK               = NO
211018dff289SGiorgis Georgakoudis
211118dff289SGiorgis Georgakoudis# If the UML_LOOK tag is enabled, the fields and methods are shown inside the
211218dff289SGiorgis Georgakoudis# class node. If there are many fields or methods and many nodes the graph may
211318dff289SGiorgis Georgakoudis# become too big to be useful. The UML_LIMIT_NUM_FIELDS threshold limits the
211418dff289SGiorgis Georgakoudis# number of items for each type to make the size more manageable. Set this to 0
211518dff289SGiorgis Georgakoudis# for no limit. Note that the threshold may be exceeded by 50% before the limit
211618dff289SGiorgis Georgakoudis# is enforced. So when you set the threshold to 10, up to 15 fields may appear,
211718dff289SGiorgis Georgakoudis# but if the number exceeds 15, the total amount of fields shown is limited to
211818dff289SGiorgis Georgakoudis# 10.
211918dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 100, default value: 10.
212018dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
212118dff289SGiorgis Georgakoudis
212218dff289SGiorgis GeorgakoudisUML_LIMIT_NUM_FIELDS   = 10
212318dff289SGiorgis Georgakoudis
212418dff289SGiorgis Georgakoudis# If the TEMPLATE_RELATIONS tag is set to YES then the inheritance and
212518dff289SGiorgis Georgakoudis# collaboration graphs will show the relations between templates and their
212618dff289SGiorgis Georgakoudis# instances.
212718dff289SGiorgis Georgakoudis# The default value is: NO.
212818dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
212918dff289SGiorgis Georgakoudis
213018dff289SGiorgis GeorgakoudisTEMPLATE_RELATIONS     = YES
213118dff289SGiorgis Georgakoudis
213218dff289SGiorgis Georgakoudis# If the INCLUDE_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are set to
213318dff289SGiorgis Georgakoudis# YES then doxygen will generate a graph for each documented file showing the
213418dff289SGiorgis Georgakoudis# direct and indirect include dependencies of the file with other documented
213518dff289SGiorgis Georgakoudis# files.
213618dff289SGiorgis Georgakoudis# The default value is: YES.
213718dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
213818dff289SGiorgis Georgakoudis
2139*eadf6db5STimm BäderINCLUDE_GRAPH          = NO
214018dff289SGiorgis Georgakoudis
214118dff289SGiorgis Georgakoudis# If the INCLUDED_BY_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are
214218dff289SGiorgis Georgakoudis# set to YES then doxygen will generate a graph for each documented file showing
214318dff289SGiorgis Georgakoudis# the direct and indirect include dependencies of the file with other documented
214418dff289SGiorgis Georgakoudis# files.
214518dff289SGiorgis Georgakoudis# The default value is: YES.
214618dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
214718dff289SGiorgis Georgakoudis
2148*eadf6db5STimm BäderINCLUDED_BY_GRAPH      = NO
214918dff289SGiorgis Georgakoudis
215018dff289SGiorgis Georgakoudis# If the CALL_GRAPH tag is set to YES then doxygen will generate a call
215118dff289SGiorgis Georgakoudis# dependency graph for every global function or class method.
215218dff289SGiorgis Georgakoudis#
215318dff289SGiorgis Georgakoudis# Note that enabling this option will significantly increase the time of a run.
215418dff289SGiorgis Georgakoudis# So in most cases it will be better to enable call graphs for selected
215518dff289SGiorgis Georgakoudis# functions only using the \callgraph command.
215618dff289SGiorgis Georgakoudis# The default value is: NO.
215718dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
215818dff289SGiorgis Georgakoudis
215918dff289SGiorgis GeorgakoudisCALL_GRAPH             = NO
216018dff289SGiorgis Georgakoudis
216118dff289SGiorgis Georgakoudis# If the CALLER_GRAPH tag is set to YES then doxygen will generate a caller
216218dff289SGiorgis Georgakoudis# dependency graph for every global function or class method.
216318dff289SGiorgis Georgakoudis#
216418dff289SGiorgis Georgakoudis# Note that enabling this option will significantly increase the time of a run.
216518dff289SGiorgis Georgakoudis# So in most cases it will be better to enable caller graphs for selected
216618dff289SGiorgis Georgakoudis# functions only using the \callergraph command.
216718dff289SGiorgis Georgakoudis# The default value is: NO.
216818dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
216918dff289SGiorgis Georgakoudis
217018dff289SGiorgis GeorgakoudisCALLER_GRAPH           = NO
217118dff289SGiorgis Georgakoudis
217218dff289SGiorgis Georgakoudis# If the GRAPHICAL_HIERARCHY tag is set to YES then doxygen will graphical
217318dff289SGiorgis Georgakoudis# hierarchy of all classes instead of a textual one.
217418dff289SGiorgis Georgakoudis# The default value is: YES.
217518dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
217618dff289SGiorgis Georgakoudis
217718dff289SGiorgis GeorgakoudisGRAPHICAL_HIERARCHY    = YES
217818dff289SGiorgis Georgakoudis
217918dff289SGiorgis Georgakoudis# If the DIRECTORY_GRAPH tag is set to YES then doxygen will show the
218018dff289SGiorgis Georgakoudis# dependencies a directory has on other directories in a graphical way. The
218118dff289SGiorgis Georgakoudis# dependency relations are determined by the #include relations between the
218218dff289SGiorgis Georgakoudis# files in the directories.
218318dff289SGiorgis Georgakoudis# The default value is: YES.
218418dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
218518dff289SGiorgis Georgakoudis
218618dff289SGiorgis GeorgakoudisDIRECTORY_GRAPH        = YES
218718dff289SGiorgis Georgakoudis
218818dff289SGiorgis Georgakoudis# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
218918dff289SGiorgis Georgakoudis# generated by dot.
219018dff289SGiorgis Georgakoudis# Note: If you choose svg you need to set HTML_FILE_EXTENSION to xhtml in order
219118dff289SGiorgis Georgakoudis# to make the SVG files visible in IE 9+ (other browsers do not have this
219218dff289SGiorgis Georgakoudis# requirement).
219318dff289SGiorgis Georgakoudis# Possible values are: png, jpg, gif and svg.
219418dff289SGiorgis Georgakoudis# The default value is: png.
219518dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
219618dff289SGiorgis Georgakoudis
219718dff289SGiorgis GeorgakoudisDOT_IMAGE_FORMAT       = @DOT_IMAGE_FORMAT@
219818dff289SGiorgis Georgakoudis
219918dff289SGiorgis Georgakoudis# If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to
220018dff289SGiorgis Georgakoudis# enable generation of interactive SVG images that allow zooming and panning.
220118dff289SGiorgis Georgakoudis#
220218dff289SGiorgis Georgakoudis# Note that this requires a modern browser other than Internet Explorer. Tested
220318dff289SGiorgis Georgakoudis# and working are Firefox, Chrome, Safari, and Opera.
220418dff289SGiorgis Georgakoudis# Note: For IE 9+ you need to set HTML_FILE_EXTENSION to xhtml in order to make
220518dff289SGiorgis Georgakoudis# the SVG files visible. Older versions of IE do not have SVG support.
220618dff289SGiorgis Georgakoudis# The default value is: NO.
220718dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
220818dff289SGiorgis Georgakoudis
220918dff289SGiorgis GeorgakoudisINTERACTIVE_SVG        = NO
221018dff289SGiorgis Georgakoudis
221118dff289SGiorgis Georgakoudis# The DOT_PATH tag can be used to specify the path where the dot tool can be
221218dff289SGiorgis Georgakoudis# found. If left blank, it is assumed the dot tool can be found in the path.
221318dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
221418dff289SGiorgis Georgakoudis
221518dff289SGiorgis GeorgakoudisDOT_PATH               = @DOT@
221618dff289SGiorgis Georgakoudis
221718dff289SGiorgis Georgakoudis# The DOTFILE_DIRS tag can be used to specify one or more directories that
221818dff289SGiorgis Georgakoudis# contain dot files that are included in the documentation (see the \dotfile
221918dff289SGiorgis Georgakoudis# command).
222018dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
222118dff289SGiorgis Georgakoudis
222218dff289SGiorgis GeorgakoudisDOTFILE_DIRS           =
222318dff289SGiorgis Georgakoudis
222418dff289SGiorgis Georgakoudis# The MSCFILE_DIRS tag can be used to specify one or more directories that
222518dff289SGiorgis Georgakoudis# contain msc files that are included in the documentation (see the \mscfile
222618dff289SGiorgis Georgakoudis# command).
222718dff289SGiorgis Georgakoudis
222818dff289SGiorgis GeorgakoudisMSCFILE_DIRS           =
222918dff289SGiorgis Georgakoudis
223018dff289SGiorgis Georgakoudis# The DIAFILE_DIRS tag can be used to specify one or more directories that
223118dff289SGiorgis Georgakoudis# contain dia files that are included in the documentation (see the \diafile
223218dff289SGiorgis Georgakoudis# command).
223318dff289SGiorgis Georgakoudis
223418dff289SGiorgis GeorgakoudisDIAFILE_DIRS           =
223518dff289SGiorgis Georgakoudis
223618dff289SGiorgis Georgakoudis# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of nodes
223718dff289SGiorgis Georgakoudis# that will be shown in the graph. If the number of nodes in a graph becomes
223818dff289SGiorgis Georgakoudis# larger than this value, doxygen will truncate the graph, which is visualized
223918dff289SGiorgis Georgakoudis# by representing a node as a red box. Note that doxygen if the number of direct
224018dff289SGiorgis Georgakoudis# children of the root node in a graph is already larger than
224118dff289SGiorgis Georgakoudis# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that
224218dff289SGiorgis Georgakoudis# the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
224318dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 10000, default value: 50.
224418dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
224518dff289SGiorgis Georgakoudis
224618dff289SGiorgis GeorgakoudisDOT_GRAPH_MAX_NODES    = 50
224718dff289SGiorgis Georgakoudis
224818dff289SGiorgis Georgakoudis# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the graphs
224918dff289SGiorgis Georgakoudis# generated by dot. A depth value of 3 means that only nodes reachable from the
225018dff289SGiorgis Georgakoudis# root by following a path via at most 3 edges will be shown. Nodes that lay
225118dff289SGiorgis Georgakoudis# further from the root node will be omitted. Note that setting this option to 1
225218dff289SGiorgis Georgakoudis# or 2 may greatly reduce the computation time needed for large code bases. Also
225318dff289SGiorgis Georgakoudis# note that the size of a graph can be further restricted by
225418dff289SGiorgis Georgakoudis# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.
225518dff289SGiorgis Georgakoudis# Minimum value: 0, maximum value: 1000, default value: 0.
225618dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
225718dff289SGiorgis Georgakoudis
225818dff289SGiorgis GeorgakoudisMAX_DOT_GRAPH_DEPTH    = 0
225918dff289SGiorgis Georgakoudis
226018dff289SGiorgis Georgakoudis# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent
226118dff289SGiorgis Georgakoudis# background. This is disabled by default, because dot on Windows does not seem
226218dff289SGiorgis Georgakoudis# to support this out of the box.
226318dff289SGiorgis Georgakoudis#
226418dff289SGiorgis Georgakoudis# Warning: Depending on the platform used, enabling this option may lead to
226518dff289SGiorgis Georgakoudis# badly anti-aliased labels on the edges of a graph (i.e. they become hard to
226618dff289SGiorgis Georgakoudis# read).
226718dff289SGiorgis Georgakoudis# The default value is: NO.
226818dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
226918dff289SGiorgis Georgakoudis
227018dff289SGiorgis GeorgakoudisDOT_TRANSPARENT        = YES
227118dff289SGiorgis Georgakoudis
227218dff289SGiorgis Georgakoudis# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output
227318dff289SGiorgis Georgakoudis# files in one run (i.e. multiple -o and -T options on the command line). This
227418dff289SGiorgis Georgakoudis# makes dot run faster, but since only newer versions of dot (>1.8.10) support
227518dff289SGiorgis Georgakoudis# this, this feature is disabled by default.
227618dff289SGiorgis Georgakoudis# The default value is: NO.
227718dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
227818dff289SGiorgis Georgakoudis
227918dff289SGiorgis GeorgakoudisDOT_MULTI_TARGETS      = YES
228018dff289SGiorgis Georgakoudis
228118dff289SGiorgis Georgakoudis# If the GENERATE_LEGEND tag is set to YES doxygen will generate a legend page
228218dff289SGiorgis Georgakoudis# explaining the meaning of the various boxes and arrows in the dot generated
228318dff289SGiorgis Georgakoudis# graphs.
228418dff289SGiorgis Georgakoudis# The default value is: YES.
228518dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
228618dff289SGiorgis Georgakoudis
228718dff289SGiorgis GeorgakoudisGENERATE_LEGEND        = YES
228818dff289SGiorgis Georgakoudis
228918dff289SGiorgis Georgakoudis# If the DOT_CLEANUP tag is set to YES doxygen will remove the intermediate dot
229018dff289SGiorgis Georgakoudis# files that are used to generate the various graphs.
229118dff289SGiorgis Georgakoudis# The default value is: YES.
229218dff289SGiorgis Georgakoudis# This tag requires that the tag HAVE_DOT is set to YES.
229318dff289SGiorgis Georgakoudis
229418dff289SGiorgis GeorgakoudisDOT_CLEANUP            = YES
2295