1# Doxyfile 1.5.5 2 3# This file describes the settings to be used by the documentation system 4# doxygen (www.doxygen.org) for a project 5# 6# All text after a hash (#) is considered a comment and will be ignored 7# The format is: 8# TAG = value [value, ...] 9# For lists items can also be appended using: 10# TAG += value [value, ...] 11# Values that contain spaces should be placed between quotes (" ") 12 13#--------------------------------------------------------------------------- 14# Project related configuration options 15#--------------------------------------------------------------------------- 16 17# This tag specifies the encoding used for all characters in the config file 18# that follow. The default is UTF-8 which is also the encoding used for all 19# text before the first occurrence of this tag. Doxygen uses libiconv (or the 20# iconv built into libc) for the transcoding. See 21# http://www.gnu.org/software/libiconv for the list of possible encodings. 22 23DOXYFILE_ENCODING = UTF-8 24 25# The PROJECT_NAME tag is a single word (or a sequence of words surrounded 26# by quotes) that should identify the project. 27 28PROJECT_NAME = @library@ 29 30# The PROJECT_NUMBER tag can be used to enter a project or revision number. 31# This could be handy for archiving the generated documentation or 32# if some version control system is used. 33 34PROJECT_NUMBER = 35 36# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) 37# base path where the generated documentation will be put. 38# If a relative path is entered, it will be relative to the location 39# where doxygen was started. If left blank the current directory will be used. 40 41OUTPUT_DIRECTORY = @DOXYGEN_OUTPUT_DIR@/html/@library@ 42 43# If the CREATE_add_subdirectory tag is set to YES, then doxygen will create 44# 4096 sub-directories (in 2 levels) under the output directory of each output 45# format and will distribute the generated files over these directories. 46# Enabling this option can be useful when feeding doxygen a huge amount of 47# source files, where putting all generated files in the same directory would 48# otherwise cause performance problems for the file system. 49 50CREATE_add_subdirectory = NO 51 52# The OUTPUT_LANGUAGE tag is used to specify the language in which all 53# documentation generated by doxygen is written. Doxygen will use this 54# information to generate all constant output in the proper language. 55# The default language is English, other supported languages are: 56# Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional, 57# Croatian, Czech, Danish, Dutch, Farsi, Finnish, French, German, Greek, 58# Hungarian, Italian, Japanese, Japanese-en (Japanese with English messages), 59# Korean, Korean-en, Lithuanian, Norwegian, Macedonian, Persian, Polish, 60# Portuguese, Romanian, Russian, Serbian, Slovak, Slovene, Spanish, Swedish, 61# and Ukrainian. 62 63OUTPUT_LANGUAGE = English 64 65# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will 66# include brief member descriptions after the members that are listed in 67# the file and class documentation (similar to JavaDoc). 68# Set to NO to disable this. 69 70BRIEF_MEMBER_DESC = YES 71 72# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend 73# the brief description of a member or function before the detailed description. 74# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the 75# brief descriptions will be completely suppressed. 76 77REPEAT_BRIEF = YES 78 79# This tag implements a quasi-intelligent brief description abbreviator 80# that is used to form the text in various listings. Each string 81# in this list, if found as the leading text of the brief description, will be 82# stripped from the text and the result after processing the whole list, is 83# used as the annotated text. Otherwise, the brief description is used as-is. 84# If left blank, the following values are used ("$name" is automatically 85# replaced with the name of the entity): "The $name class" "The $name widget" 86# "The $name file" "is" "provides" "specifies" "contains" 87# "represents" "a" "an" "the" 88 89ABBREVIATE_BRIEF = 90 91# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then 92# Doxygen will generate a detailed section even if there is only a brief 93# description. 94 95ALWAYS_DETAILED_SEC = NO 96 97# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all 98# inherited members of a class in the documentation of that class as if those 99# members were ordinary class members. Constructors, destructors and assignment 100# operators of the base classes will not be shown. 101 102INLINE_INHERITED_MEMB = YES 103 104# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full 105# path before files name in the file list and in the header files. If set 106# to NO the shortest path that makes the file name unique will be used. 107 108FULL_PATH_NAMES = YES 109 110# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag 111# can be used to strip a user-defined part of the path. Stripping is 112# only done if one of the specified strings matches the left-hand part of 113# the path. The tag can be used to show relative paths in the file list. 114# If left blank the directory from which doxygen is run is used as the 115# path to strip. 116 117STRIP_FROM_PATH = @VXL_ROOT_SOURCE_DIR@/ 118 119# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of 120# the path mentioned in the documentation of a class, which tells 121# the reader which header file to include in order to use a class. 122# If left blank only the name of the header file containing the class 123# definition is used. Otherwise one should specify the include paths that 124# are normally passed to the compiler using the -I flag. 125 126STRIP_FROM_INC_PATH = 127 128# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter 129# (but less readable) file names. This can be useful is your file systems 130# doesn't support long names like on DOS, Mac, or CD-ROM. 131 132SHORT_NAMES = NO 133 134# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen 135# will interpret the first line (until the first dot) of a JavaDoc-style 136# comment as the brief description. If set to NO, the JavaDoc 137# comments will behave just like regular Qt-style comments 138# (thus requiring an explicit @brief command for a brief description.) 139 140JAVADOC_AUTOBRIEF = YES 141 142# If the QT_AUTOBRIEF tag is set to YES then Doxygen will 143# interpret the first line (until the first dot) of a Qt-style 144# comment as the brief description. If set to NO, the comments 145# will behave just like regular Qt-style comments (thus requiring 146# an explicit \brief command for a brief description.) 147 148QT_AUTOBRIEF = NO 149 150# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen 151# treat a multi-line C++ special comment block (i.e. a block of //! or /// 152# comments) as a brief description. This used to be the default behaviour. 153# The new default is to treat a multi-line C++ comment block as a detailed 154# description. Set this tag to YES if you prefer the old behaviour instead. 155 156MULTILINE_CPP_IS_BRIEF = NO 157 158# If the DETAILS_AT_TOP tag is set to YES then Doxygen 159# will output the detailed description near the top, like JavaDoc. 160# If set to NO, the detailed description appears after the member 161# documentation. 162 163DETAILS_AT_TOP = YES 164 165# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented 166# member inherits the documentation from any documented member that it 167# re-implements. 168 169INHERIT_DOCS = YES 170 171# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce 172# a new page for each member. If set to NO, the documentation of a member will 173# be part of the file/class/namespace that contains it. 174 175SEPARATE_MEMBER_PAGES = NO 176 177# The TAB_SIZE tag can be used to set the number of spaces in a tab. 178# Doxygen uses this value to replace tabs by spaces in code fragments. 179 180TAB_SIZE = 2 181 182# This tag can be used to specify a number of aliases that acts 183# as commands in the documentation. An alias has the form "name=value". 184# For example adding "sideeffect=\par Side Effects:\n" will allow you to 185# put the command \sideeffect (or @sideeffect) in the documentation, which 186# will result in a user-defined paragraph with heading "Side Effects:". 187# You can put \n's in the value part of an alias to insert newlines. 188 189ALIASES = 190 191# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C 192# sources only. Doxygen will then generate output that is more tailored for C. 193# For instance, some of the names that are used will be different. The list 194# of all members will be omitted, etc. 195 196OPTIMIZE_OUTPUT_FOR_C = NO 197 198# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java 199# sources only. Doxygen will then generate output that is more tailored for 200# Java. For instance, namespaces will be presented as packages, qualified 201# scopes will look different, etc. 202 203OPTIMIZE_OUTPUT_JAVA = NO 204 205# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran 206# sources only. Doxygen will then generate output that is more tailored for 207# Fortran. 208 209OPTIMIZE_FOR_FORTRAN = NO 210 211# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL 212# sources. Doxygen will then generate output that is tailored for 213# VHDL. 214 215OPTIMIZE_OUTPUT_VHDL = NO 216 217# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want 218# to include (a tag file for) the STL sources as input, then you should 219# set this tag to YES in order to let doxygen match functions declarations and 220# definitions whose arguments contain STL classes (e.g. func(std::string); v.s. 221# func(std::string) {}). This also make the inheritance and collaboration 222# diagrams that involve STL classes more complete and accurate. 223 224BUILTIN_STL_SUPPORT = NO 225 226# If you use Microsoft's C++/CLI language, you should set this option to YES to 227# enable parsing support. 228 229CPP_CLI_SUPPORT = NO 230 231# Set the SIP_SUPPORT tag to YES if your project consists of sip sources only. 232# Doxygen will parse them like normal C++ but will assume all classes use public 233# instead of private inheritance when no explicit protection keyword is present. 234 235SIP_SUPPORT = NO 236 237# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC 238# tag is set to YES, then doxygen will reuse the documentation of the first 239# member in the group (if any) for the other members of the group. By default 240# all members of a group must be documented explicitly. 241 242DISTRIBUTE_GROUP_DOC = NO 243 244# Set the SUBGROUPING tag to YES (the default) to allow class member groups of 245# the same type (for instance a group of public functions) to be put as a 246# subgroup of that type (e.g. under the Public Functions section). Set it to 247# NO to prevent subgrouping. Alternatively, this can be done per class using 248# the \nosubgrouping command. 249 250SUBGROUPING = YES 251 252# When TYPEDEF_HIDES_STRUCT is enabled, a typedef of a struct, union, or enum 253# is documented as struct, union, or enum with the name of the typedef. So 254# typedef struct TypeS {} TypeT, will appear in the documentation as a struct 255# with name TypeT. When disabled the typedef will appear as a member of a file, 256# namespace, or class. And the struct will be named TypeS. This can typically 257# be useful for C code in case the coding convention dictates that all compound 258# types are typedef'ed and only the typedef is referenced, never the tag name. 259 260TYPEDEF_HIDES_STRUCT = NO 261 262#--------------------------------------------------------------------------- 263# Build related configuration options 264#--------------------------------------------------------------------------- 265 266# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in 267# documentation are documented, even if no documentation was available. 268# Private class members and static file members will be hidden unless 269# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES 270 271EXTRACT_ALL = YES 272 273# If the EXTRACT_PRIVATE tag is set to YES all private members of a class 274# will be included in the documentation. 275 276EXTRACT_PRIVATE = YES 277 278# If the EXTRACT_STATIC tag is set to YES all static members of a file 279# will be included in the documentation. 280 281EXTRACT_STATIC = NO 282 283# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) 284# defined locally in source files will be included in the documentation. 285# If set to NO only classes defined in header files are included. 286 287EXTRACT_LOCAL_CLASSES = YES 288 289# This flag is only useful for Objective-C code. When set to YES local 290# methods, which are defined in the implementation section but not in 291# the interface are included in the documentation. 292# If set to NO (the default) only methods in the interface are included. 293 294EXTRACT_LOCAL_METHODS = NO 295 296# If this flag is set to YES, the members of anonymous namespaces will be 297# extracted and appear in the documentation as a namespace called 298# 'anonymous_namespace{file}', where file will be replaced with the base 299# name of the file that contains the anonymous namespace. By default 300# anonymous namespace are hidden. 301 302EXTRACT_ANON_NSPACES = NO 303 304# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all 305# undocumented members of documented classes, files or namespaces. 306# If set to NO (the default) these members will be included in the 307# various overviews, but no documentation section is generated. 308# This option has no effect if EXTRACT_ALL is enabled. 309 310HIDE_UNDOC_MEMBERS = NO 311 312# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all 313# undocumented classes that are normally visible in the class hierarchy. 314# If set to NO (the default) these classes will be included in the various 315# overviews. This option has no effect if EXTRACT_ALL is enabled. 316 317HIDE_UNDOC_CLASSES = NO 318 319# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all 320# friend (class|struct|union) declarations. 321# If set to NO (the default) these declarations will be included in the 322# documentation. 323 324HIDE_FRIEND_COMPOUNDS = NO 325 326# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any 327# documentation blocks found inside the body of a function. 328# If set to NO (the default) these blocks will be appended to the 329# function's detailed documentation block. 330 331HIDE_IN_BODY_DOCS = NO 332 333# The INTERNAL_DOCS tag determines if documentation 334# that is typed after a \internal command is included. If the tag is set 335# to NO (the default) then the documentation will be excluded. 336# Set it to YES to include the internal documentation. 337 338INTERNAL_DOCS = NO 339 340# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate 341# file names in lower-case letters. If set to YES upper-case letters are also 342# allowed. This is useful if you have classes or files whose names only differ 343# in case and if your file system supports case sensitive file names. Windows 344# and Mac users are advised to set this option to NO. 345 346CASE_SENSE_NAMES = YES 347 348# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen 349# will show members with their full class and namespace scopes in the 350# documentation. If set to YES the scope will be hidden. 351 352HIDE_SCOPE_NAMES = NO 353 354# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen 355# will put a list of the files that are included by a file in the documentation 356# of that file. 357 358SHOW_INCLUDE_FILES = YES 359 360# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] 361# is inserted in the documentation for inline members. 362 363INLINE_INFO = YES 364 365# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen 366# will sort the (detailed) documentation of file and class members 367# alphabetically by member name. If set to NO the members will appear in 368# declaration order. 369 370SORT_MEMBER_DOCS = YES 371 372# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the 373# brief documentation of file, namespace and class members alphabetically 374# by member name. If set to NO (the default) the members will appear in 375# declaration order. 376 377SORT_BRIEF_DOCS = NO 378 379# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the 380# hierarchy of group names into alphabetical order. If set to NO (the default) 381# the group names will appear in their defined order. 382 383SORT_GROUP_NAMES = NO 384 385# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be 386# sorted by fully-qualified names, including namespaces. If set to 387# NO (the default), the class list will be sorted only by class name, 388# not including the namespace part. 389# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. 390# Note: This option applies only to the class list, not to the 391# alphabetical list. 392 393SORT_BY_SCOPE_NAME = NO 394 395# The GENERATE_TODOLIST tag can be used to enable (YES) or 396# disable (NO) the todo list. This list is created by putting \todo 397# commands in the documentation. 398 399GENERATE_TODOLIST = YES 400 401# The GENERATE_TESTLIST tag can be used to enable (YES) or 402# disable (NO) the test list. This list is created by putting \test 403# commands in the documentation. 404 405GENERATE_TESTLIST = YES 406 407# The GENERATE_BUGLIST tag can be used to enable (YES) or 408# disable (NO) the bug list. This list is created by putting \bug 409# commands in the documentation. 410 411GENERATE_BUGLIST = YES 412 413# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or 414# disable (NO) the deprecated list. This list is created by putting 415# \deprecated commands in the documentation. 416 417GENERATE_DEPRECATEDLIST= YES 418 419# The ENABLED_SECTIONS tag can be used to enable conditional 420# documentation sections, marked by \if sectionname ... \endif. 421 422ENABLED_SECTIONS = 423 424# The MAX_INITIALIZER_LINES tag determines the maximum number of lines 425# the initial value of a variable or define consists of for it to appear in 426# the documentation. If the initializer consists of more lines than specified 427# here it will be hidden. Use a value of 0 to hide initializers completely. 428# The appearance of the initializer of individual variables and defines in the 429# documentation can be controlled using \showinitializer or \hideinitializer 430# command in the documentation regardless of this setting. 431 432MAX_INITIALIZER_LINES = 30 433 434# Set the SHOW_USED_FILES tag to NO to disable the list of files generated 435# at the bottom of the documentation of classes and structs. If set to YES the 436# list will mention the files that were used to generate the documentation. 437 438SHOW_USED_FILES = YES 439 440# If the sources in your project are distributed over multiple directories 441# then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy 442# in the documentation. The default is NO. 443 444SHOW_DIRECTORIES = NO 445 446# The FILE_VERSION_FILTER tag can be used to specify a program or script that 447# doxygen should invoke to get the current version for each file (typically from 448# the version control system). Doxygen will invoke the program by executing (via 449# popen()) the command <command> <input-file>, where <command> is the value of 450# the FILE_VERSION_FILTER tag, and <input-file> is the name of an input file 451# provided by doxygen. Whatever the program writes to standard output 452# is used as the file version. See the manual for examples. 453 454FILE_VERSION_FILTER = 455 456#--------------------------------------------------------------------------- 457# configuration options related to warning and progress messages 458#--------------------------------------------------------------------------- 459 460# The QUIET tag can be used to turn on/off the messages that are generated 461# by doxygen. Possible values are YES and NO. If left blank NO is used. 462 463QUIET = NO 464 465# The WARNINGS tag can be used to turn on/off the warning messages that are 466# generated by doxygen. Possible values are YES and NO. If left blank 467# NO is used. 468 469WARNINGS = YES 470 471# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings 472# for undocumented members. If EXTRACT_ALL is set to YES then this flag will 473# automatically be disabled. 474 475WARN_IF_UNDOCUMENTED = YES 476 477# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for 478# potential errors in the documentation, such as not documenting some 479# parameters in a documented function, or documenting parameters that 480# don't exist or using markup commands wrongly. 481 482WARN_IF_DOC_ERROR = YES 483 484# This WARN_NO_PARAMDOC option can be abled to get warnings for 485# functions that are documented, but have no documentation for their parameters 486# or return value. If set to NO (the default) doxygen will only warn about 487# wrong or incomplete parameter documentation, but not about the absence of 488# documentation. 489 490WARN_NO_PARAMDOC = NO 491 492# The WARN_FORMAT tag determines the format of the warning messages that 493# doxygen can produce. The string should contain the $file, $line, and $text 494# tags, which will be replaced by the file and line number from which the 495# warning originated and the warning text. Optionally the format may contain 496# $version, which will be replaced by the version of the file (if it could 497# be obtained via FILE_VERSION_FILTER) 498 499WARN_FORMAT = "$file:$line: $text" 500 501# The WARN_LOGFILE tag can be used to specify a file to which warning 502# and error messages should be written. If left blank the output is written 503# to stderr. 504 505WARN_LOGFILE = 506 507#--------------------------------------------------------------------------- 508# configuration options related to the input files 509#--------------------------------------------------------------------------- 510 511# The INPUT tag can be used to specify the files and/or directories that contain 512# documented source files. You may enter file names like "myfile.cpp" or 513# directories like "/usr/src/myproject". Separate the files or directories 514# with spaces. 515 516INPUT = ./@library@ 517 518# This tag can be used to specify the character encoding of the source files 519# that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is 520# also the default input encoding. Doxygen uses libiconv (or the iconv built 521# into libc) for the transcoding. See http://www.gnu.org/software/libiconv for 522# the list of possible encodings. 523 524INPUT_ENCODING = UTF-8 525 526# If the value of the INPUT tag contains directories, you can use the 527# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 528# and *.h) to filter out the source-files in the directories. If left 529# blank the following patterns are tested: 530# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx 531# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py *.f90 532 533FILE_PATTERNS = *.h \ 534 *.cxx \ 535 *.hxx \ 536 *_doxy.txt 537 538# The RECURSIVE tag can be used to turn specify whether or not subdirectories 539# should be searched for input files as well. Possible values are YES and NO. 540# If left blank NO is used. 541 542RECURSIVE = YES 543 544# The EXCLUDE tag can be used to specify files and/or directories that should 545# excluded from the INPUT source files. This way you can easily exclude a 546# subdirectory from a directory tree whose root is specified with the INPUT tag. 547 548EXCLUDE = 549 550# The EXCLUDE_SYMLINKS tag can be used select whether or not files or 551# directories that are symbolic links (a Unix filesystem feature) are excluded 552# from the input. 553 554EXCLUDE_SYMLINKS = NO 555 556# If the value of the INPUT tag contains directories, you can use the 557# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude 558# certain files from those directories. Note that the wildcards are matched 559# against the file with absolute path, so to exclude all test directories 560# for example use the pattern */test/* 561 562EXCLUDE_PATTERNS = */Linux2/* \ 563 */Test/* \ 564 */tests/* \ 565 */Templates/* \ 566 */example* 567 568# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names 569# (namespaces, classes, functions, etc.) that should be excluded from the 570# output. The symbol name can be a fully qualified name, a word, or if the 571# wildcard * is used, a substring. Examples: ANamespace, AClass, 572# AClass::ANamespace, ANamespace::*Test 573 574EXCLUDE_SYMBOLS = 575 576# The EXAMPLE_PATH tag can be used to specify one or more files or 577# directories that contain example code fragments that are included (see 578# the \include command). 579 580EXAMPLE_PATH = . 581 582# If the value of the EXAMPLE_PATH tag contains directories, you can use the 583# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 584# and *.h) to filter out the source-files in the directories. If left 585# blank all files are included. 586 587EXAMPLE_PATTERNS = 588 589# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be 590# searched for input files to be used with the \include or \dontinclude 591# commands irrespective of the value of the RECURSIVE tag. 592# Possible values are YES and NO. If left blank NO is used. 593 594EXAMPLE_RECURSIVE = NO 595 596# The IMAGE_PATH tag can be used to specify one or more files or 597# directories that contain image that are included in the documentation (see 598# the \image command). 599 600IMAGE_PATH = 601 602# The INPUT_FILTER tag can be used to specify a program that doxygen should 603# invoke to filter for each input file. Doxygen will invoke the filter program 604# by executing (via popen()) the command <filter> <input-file>, where <filter> 605# is the value of the INPUT_FILTER tag, and <input-file> is the name of an 606# input file. Doxygen will then use the output that the filter program writes 607# to standard output. If FILTER_PATTERNS is specified, this tag will be 608# ignored. 609 610INPUT_FILTER = @DOXYGEN_INPUT_FILTER@ 611 612# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern 613# basis. Doxygen will compare the file name with each pattern and apply the 614# filter if there is a match. The filters are a list of the form: 615# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further 616# info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER 617# is applied to all files. 618 619FILTER_PATTERNS = 620 621# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using 622# INPUT_FILTER) will be used to filter the input files when producing source 623# files to browse (i.e. when SOURCE_BROWSER is set to YES). 624 625FILTER_SOURCE_FILES = NO 626 627#--------------------------------------------------------------------------- 628# configuration options related to source browsing 629#--------------------------------------------------------------------------- 630 631# If the SOURCE_BROWSER tag is set to YES then a list of source files will 632# be generated. Documented entities will be cross-referenced with these sources. 633# Note: To get rid of all source code in the generated output, make sure also 634# VERBATIM_HEADERS is set to NO. 635 636SOURCE_BROWSER = YES 637 638# Setting the INLINE_SOURCES tag to YES will include the body 639# of functions and classes directly in the documentation. 640 641INLINE_SOURCES = NO 642 643# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct 644# doxygen to hide any special comment blocks from generated source code 645# fragments. Normal C and C++ comments will always remain visible. 646 647STRIP_CODE_COMMENTS = NO 648 649# If the REFERENCED_BY_RELATION tag is set to YES (the default) 650# then for each documented function all documented 651# functions referencing it will be listed. 652 653REFERENCED_BY_RELATION = NO 654 655# If the REFERENCES_RELATION tag is set to YES (the default) 656# then for each documented function all documented entities 657# called/used by that function will be listed. 658 659REFERENCES_RELATION = NO 660 661# If the REFERENCES_LINK_SOURCE tag is set to YES (the default) 662# and SOURCE_BROWSER tag is set to YES, then the hyperlinks from 663# functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will 664# link to the source code. Otherwise they will link to the documentstion. 665 666REFERENCES_LINK_SOURCE = YES 667 668# If the USE_HTAGS tag is set to YES then the references to source code 669# will point to the HTML generated by the htags(1) tool instead of doxygen 670# built-in source browser. The htags tool is part of GNU's global source 671# tagging system (see http://www.gnu.org/software/global/global.html). You 672# will need version 4.8.6 or higher. 673 674USE_HTAGS = NO 675 676# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen 677# will generate a verbatim copy of the header file for each class for 678# which an include is specified. Set to NO to disable this. 679 680VERBATIM_HEADERS = YES 681 682#--------------------------------------------------------------------------- 683# configuration options related to the alphabetical class index 684#--------------------------------------------------------------------------- 685 686# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index 687# of all compounds will be generated. Enable this if the project 688# contains a lot of classes, structs, unions or interfaces. 689 690ALPHABETICAL_INDEX = YES 691 692# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then 693# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns 694# in which this list will be split (can be a number in the range [1..20]) 695 696COLS_IN_ALPHA_INDEX = 2 697 698# In case all classes in a project start with a common prefix, all 699# classes will be put under the same header in the alphabetical index. 700# The IGNORE_PREFIX tag can be used to specify one or more prefixes that 701# should be ignored while generating the index headers. 702 703IGNORE_PREFIX = @prefix@ 704 705#--------------------------------------------------------------------------- 706# configuration options related to the HTML output 707#--------------------------------------------------------------------------- 708 709# If the GENERATE_HTML tag is set to YES (the default) Doxygen will 710# generate HTML output. 711 712GENERATE_HTML = YES 713 714# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. 715# If a relative path is entered the value of OUTPUT_DIRECTORY will be 716# put in front of it. If left blank `html' will be used as the default path. 717 718HTML_OUTPUT = 719 720# The HTML_FILE_EXTENSION tag can be used to specify the file extension for 721# each generated HTML page (for example: .htm,.php,.asp). If it is left blank 722# doxygen will generate files with .html extension. 723 724HTML_FILE_EXTENSION = .html 725 726# The HTML_HEADER tag can be used to specify a personal HTML header for 727# each generated HTML page. If it is left blank doxygen will generate a 728# standard header. 729 730HTML_HEADER = "@CMAKE_BINARY_DIR@/doxy/output/doxy_header.html" 731 732# The HTML_FOOTER tag can be used to specify a personal HTML footer for 733# each generated HTML page. If it is left blank doxygen will generate a 734# standard footer. 735 736HTML_FOOTER = 737 738# The HTML_STYLESHEET tag can be used to specify a user-defined cascading 739# style sheet that is used by each HTML page. It can be used to 740# fine-tune the look of the HTML output. If the tag is left blank doxygen 741# will generate a default style sheet. Note that doxygen will try to copy 742# the style sheet file to the HTML output directory, so don't put your own 743# stylesheet in the HTML output directory as well, or it will be erased! 744 745HTML_STYLESHEET = @DOXYGEN_STYLESHEET@ 746 747# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, 748# files or namespaces will be aligned in HTML using tables. If set to 749# NO a bullet list will be used. 750 751HTML_ALIGN_MEMBERS = YES 752 753# If the GENERATE_HTMLHELP tag is set to YES, additional index files 754# will be generated that can be used as input for tools like the 755# Microsoft HTML help workshop to generate a compiled HTML help file (.chm) 756# of the generated HTML documentation. 757 758GENERATE_HTMLHELP = NO 759 760# If the GENERATE_DOCSET tag is set to YES, additional index files 761# will be generated that can be used as input for Apple's Xcode 3 762# integrated development environment, introduced with OSX 10.5 (Leopard). 763# To create a documentation set, doxygen will generate a Makefile in the 764# HTML output directory. Running make will produce the docset in that 765# directory and running "make install" will install the docset in 766# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find 767# it at startup. 768 769GENERATE_DOCSET = NO 770 771# When GENERATE_DOCSET tag is set to YES, this tag determines the name of the 772# feed. A documentation feed provides an umbrella under which multiple 773# documentation sets from a single provider (such as a company or product suite) 774# can be grouped. 775 776DOCSET_FEEDNAME = "Doxygen generated docs" 777 778# When GENERATE_DOCSET tag is set to YES, this tag specifies a string that 779# should uniquely identify the documentation set bundle. This should be a 780# reverse domain-name style string, e.g. com.mycompany.MyDocSet. Doxygen 781# will append .docset to the name. 782 783DOCSET_BUNDLE_ID = org.doxygen.Project 784 785# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML 786# documentation will contain sections that can be hidden and shown after the 787# page has loaded. For this to work a browser that supports 788# JavaScript and DHTML is required (for instance Mozilla 1.0+, Firefox 789# Netscape 6.0+, Internet explorer 5.0+, Konqueror, or Safari). 790 791HTML_DYNAMIC_SECTIONS = NO 792 793# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can 794# be used to specify the file name of the resulting .chm file. You 795# can add a path in front of the file if the result should not be 796# written to the html output directory. 797 798CHM_FILE = 799 800# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can 801# be used to specify the location (absolute path including file name) of 802# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run 803# the HTML help compiler on the generated index.hhp. 804 805HHC_LOCATION = 806 807# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag 808# controls if a separate .chi index file is generated (YES) or that 809# it should be included in the master .chm file (NO). 810 811GENERATE_CHI = NO 812 813# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag 814# controls whether a binary table of contents is generated (YES) or a 815# normal table of contents (NO) in the .chm file. 816 817BINARY_TOC = NO 818 819# The TOC_EXPAND flag can be set to YES to add extra items for group members 820# to the contents of the HTML help documentation and to the tree view. 821 822TOC_EXPAND = NO 823 824# The DISABLE_INDEX tag can be used to turn on/off the condensed index at 825# top of each HTML page. The value NO (the default) enables the index and 826# the value YES disables it. 827 828DISABLE_INDEX = NO 829 830# This tag can be used to set the number of enum values (range [1..20]) 831# that doxygen will group on one line in the generated HTML documentation. 832 833ENUM_VALUES_PER_LINE = 4 834 835# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be 836# generated containing a tree-like index structure (just like the one that 837# is generated for HTML Help). For this to work a browser that supports 838# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, 839# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are 840# probably better off using the HTML help feature. 841 842GENERATE_TREEVIEW = NO 843 844# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 845# used to set the initial width (in pixels) of the frame in which the tree 846# is shown. 847 848TREEVIEW_WIDTH = 250 849 850#--------------------------------------------------------------------------- 851# configuration options related to the LaTeX output 852#--------------------------------------------------------------------------- 853 854# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will 855# generate Latex output. 856 857GENERATE_LATEX = NO 858 859# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. 860# If a relative path is entered the value of OUTPUT_DIRECTORY will be 861# put in front of it. If left blank `latex' will be used as the default path. 862 863LATEX_OUTPUT = 864 865# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be 866# invoked. If left blank `latex' will be used as the default command name. 867 868LATEX_CMD_NAME = latex 869 870# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to 871# generate index for LaTeX. If left blank `makeindex' will be used as the 872# default command name. 873 874MAKEINDEX_CMD_NAME = makeindex 875 876# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact 877# LaTeX documents. This may be useful for small projects and may help to 878# save some trees in general. 879 880COMPACT_LATEX = NO 881 882# The PAPER_TYPE tag can be used to set the paper type that is used 883# by the printer. Possible values are: a4, a4wide, letter, legal and 884# executive. If left blank a4wide will be used. 885 886PAPER_TYPE = a4wide 887 888# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX 889# packages that should be included in the LaTeX output. 890 891EXTRA_PACKAGES = 892 893# The LATEX_HEADER tag can be used to specify a personal LaTeX header for 894# the generated latex document. The header should contain everything until 895# the first chapter. If it is left blank doxygen will generate a 896# standard header. Notice: only use this tag if you know what you are doing! 897 898LATEX_HEADER = 899 900# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated 901# is prepared for conversion to pdf (using ps2pdf). The pdf file will 902# contain links (just like the HTML output) instead of page references 903# This makes the output suitable for online browsing using a pdf viewer. 904 905PDF_HYPERLINKS = NO 906 907# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of 908# plain latex in the generated Makefile. Set this option to YES to get a 909# higher quality PDF documentation. 910 911USE_PDFLATEX = NO 912 913# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. 914# command to the generated LaTeX files. This will instruct LaTeX to keep 915# running if errors occur, instead of asking the user for help. 916# This option is also used when generating formulas in HTML. 917 918LATEX_BATCHMODE = NO 919 920# If LATEX_HIDE_INDICES is set to YES then doxygen will not 921# include the index chapters (such as File Index, Compound Index, etc.) 922# in the output. 923 924LATEX_HIDE_INDICES = NO 925 926#--------------------------------------------------------------------------- 927# configuration options related to the RTF output 928#--------------------------------------------------------------------------- 929 930# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output 931# The RTF output is optimized for Word 97 and may not look very pretty with 932# other RTF readers or editors. 933 934GENERATE_RTF = NO 935 936# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. 937# If a relative path is entered the value of OUTPUT_DIRECTORY will be 938# put in front of it. If left blank `rtf' will be used as the default path. 939 940RTF_OUTPUT = 941 942# If the COMPACT_RTF tag is set to YES Doxygen generates more compact 943# RTF documents. This may be useful for small projects and may help to 944# save some trees in general. 945 946COMPACT_RTF = NO 947 948# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated 949# will contain hyperlink fields. The RTF file will 950# contain links (just like the HTML output) instead of page references. 951# This makes the output suitable for online browsing using WORD or other 952# programs which support those fields. 953# Note: wordpad (write) and others do not support links. 954 955RTF_HYPERLINKS = NO 956 957# Load stylesheet definitions from file. Syntax is similar to doxygen's 958# config file, i.e. a series of assignments. You only have to provide 959# replacements, missing definitions are set to their default value. 960 961RTF_STYLESHEET_FILE = 962 963# Set optional variables used in the generation of an rtf document. 964# Syntax is similar to doxygen's config file. 965 966RTF_EXTENSIONS_FILE = 967 968#--------------------------------------------------------------------------- 969# configuration options related to the man page output 970#--------------------------------------------------------------------------- 971 972# If the GENERATE_MAN tag is set to YES (the default) Doxygen will 973# generate man pages 974 975GENERATE_MAN = NO 976 977# The MAN_OUTPUT tag is used to specify where the man pages will be put. 978# If a relative path is entered the value of OUTPUT_DIRECTORY will be 979# put in front of it. If left blank `man' will be used as the default path. 980 981MAN_OUTPUT = 982 983# The MAN_EXTENSION tag determines the extension that is added to 984# the generated man pages (default is the subroutine's section .3) 985 986MAN_EXTENSION = .3 987 988# If the MAN_LINKS tag is set to YES and Doxygen generates man output, 989# then it will generate one additional man file for each entity 990# documented in the real man page(s). These additional files 991# only source the real man page, but without them the man command 992# would be unable to find the correct page. The default is NO. 993 994MAN_LINKS = NO 995 996#--------------------------------------------------------------------------- 997# configuration options related to the XML output 998#--------------------------------------------------------------------------- 999 1000# If the GENERATE_XML tag is set to YES Doxygen will 1001# generate an XML file that captures the structure of 1002# the code including all documentation. 1003 1004GENERATE_XML = NO 1005 1006# The XML_OUTPUT tag is used to specify where the XML pages will be put. 1007# If a relative path is entered the value of OUTPUT_DIRECTORY will be 1008# put in front of it. If left blank `xml' will be used as the default path. 1009 1010XML_OUTPUT = xml 1011 1012# The XML_SCHEMA tag can be used to specify an XML schema, 1013# which can be used by a validating XML parser to check the 1014# syntax of the XML files. 1015 1016XML_SCHEMA = 1017 1018# The XML_DTD tag can be used to specify an XML DTD, 1019# which can be used by a validating XML parser to check the 1020# syntax of the XML files. 1021 1022XML_DTD = 1023 1024# If the XML_PROGRAMLISTING tag is set to YES Doxygen will 1025# dump the program listings (including syntax highlighting 1026# and cross-referencing information) to the XML output. Note that 1027# enabling this will significantly increase the size of the XML output. 1028 1029XML_PROGRAMLISTING = YES 1030 1031#--------------------------------------------------------------------------- 1032# configuration options for the AutoGen Definitions output 1033#--------------------------------------------------------------------------- 1034 1035# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will 1036# generate an AutoGen Definitions (see autogen.sf.net) file 1037# that captures the structure of the code including all 1038# documentation. Note that this feature is still experimental 1039# and incomplete at the moment. 1040 1041GENERATE_AUTOGEN_DEF = NO 1042 1043#--------------------------------------------------------------------------- 1044# configuration options related to the Perl module output 1045#--------------------------------------------------------------------------- 1046 1047# If the GENERATE_PERLMOD tag is set to YES Doxygen will 1048# generate a Perl module file that captures the structure of 1049# the code including all documentation. Note that this 1050# feature is still experimental and incomplete at the 1051# moment. 1052 1053GENERATE_PERLMOD = NO 1054 1055# If the PERLMOD_LATEX tag is set to YES Doxygen will generate 1056# the necessary Makefile rules, Perl scripts and LaTeX code to be able 1057# to generate PDF and DVI output from the Perl module output. 1058 1059PERLMOD_LATEX = NO 1060 1061# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be 1062# nicely formatted so it can be parsed by a human reader. This is useful 1063# if you want to understand what is going on. On the other hand, if this 1064# tag is set to NO the size of the Perl module output will be much smaller 1065# and Perl will parse it just the same. 1066 1067PERLMOD_PRETTY = YES 1068 1069# The names of the make variables in the generated doxyrules.make file 1070# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. 1071# This is useful so different doxyrules.make files included by the same 1072# Makefile don't overwrite each other's variables. 1073 1074PERLMOD_MAKEVAR_PREFIX = 1075 1076#--------------------------------------------------------------------------- 1077# Configuration options related to the preprocessor 1078#--------------------------------------------------------------------------- 1079 1080# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will 1081# evaluate all C-preprocessor directives found in the sources and include 1082# files. 1083 1084ENABLE_PREPROCESSING = YES 1085 1086# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro 1087# names in the source code. If set to NO (the default) only conditional 1088# compilation will be performed. Macro expansion can be done in a controlled 1089# way by setting EXPAND_ONLY_PREDEF to YES. 1090 1091MACRO_EXPANSION = NO 1092 1093# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES 1094# then the macro expansion is limited to the macros specified with the 1095# PREDEFINED and EXPAND_AS_DEFINED tags. 1096 1097EXPAND_ONLY_PREDEF = NO 1098 1099# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files 1100# in the INCLUDE_PATH (see below) will be search if a #include is found. 1101 1102SEARCH_INCLUDES = YES 1103 1104# The INCLUDE_PATH tag can be used to specify one or more directories that 1105# contain include files that are not input files but should be processed by 1106# the preprocessor. 1107 1108INCLUDE_PATH = 1109 1110# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard 1111# patterns (like *.h and *.hpp) to filter out the header-files in the 1112# directories. If left blank, the patterns specified with FILE_PATTERNS will 1113# be used. 1114 1115INCLUDE_FILE_PATTERNS = 1116 1117# The PREDEFINED tag can be used to specify one or more macro names that 1118# are defined before the preprocessor is started (similar to the -D option of 1119# gcc). The argument of the tag is a list of macros of the form: name 1120# or name=definition (no spaces). If the definition and the = are 1121# omitted =1 is assumed. To prevent a macro definition from being 1122# undefined via #undef or recursively expanded use the := operator 1123# instead of the = operator. 1124 1125PREDEFINED = DOXYGEN_SHOULD_SKIP_THIS 1126 1127# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then 1128# this tag can be used to specify a list of macro names that should be expanded. 1129# The macro definition that is found in the sources will be used. 1130# Use the PREDEFINED tag if you want to use a different macro definition. 1131 1132EXPAND_AS_DEFINED = 1133 1134# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then 1135# doxygen's preprocessor will remove all function-like macros that are alone 1136# on a line, have an all uppercase name, and do not end with a semicolon. Such 1137# function macros are typically used for boiler-plate code, and will confuse 1138# the parser if not removed. 1139 1140SKIP_FUNCTION_MACROS = YES 1141 1142#--------------------------------------------------------------------------- 1143# Configuration::additions related to external references 1144#--------------------------------------------------------------------------- 1145 1146# The TAGFILES option can be used to specify one or more tagfiles. 1147# Optionally an initial location of the external documentation 1148# can be added for each tagfile. The format of a tag file without 1149# this location is as follows: 1150# TAGFILES = file1 file2 ... 1151# Adding location for the tag files is done as follows: 1152# TAGFILES = file1=loc1 "file2 = loc2" ... 1153# where "loc1" and "loc2" can be relative or absolute paths or 1154# URLs. If a location is present for each tag, the installdox tool 1155# does not have to be run to correct the links. 1156# Note that each tag file must have a unique name 1157# (where the name does NOT include the path) 1158# If a tag file is not located in the directory in which doxygen 1159# is run, you must also specify the path to the tagfile here. 1160 1161TAGFILES = @tagfiles@ 1162 1163# When a file name is specified after GENERATE_TAGFILE, doxygen will create 1164# a tag file that is based on the input files it reads. 1165 1166GENERATE_TAGFILE = @DOXYGEN_OUTPUT_DIR@/tags/@libname@.tag 1167 1168# If the ALLEXTERNALS tag is set to YES all external classes will be listed 1169# in the class index. If set to NO only the inherited external classes 1170# will be listed. 1171 1172ALLEXTERNALS = NO 1173 1174# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed 1175# in the modules index. If set to NO, only the current project's groups will 1176# be listed. 1177 1178EXTERNAL_GROUPS = YES 1179 1180# The PERL_PATH should be the absolute path and name of the perl script 1181# interpreter (i.e. the result of `which perl'). 1182 1183PERL_PATH = @PERL_EXECUTABLE@ 1184 1185#--------------------------------------------------------------------------- 1186# Configuration options related to the dot tool 1187#--------------------------------------------------------------------------- 1188 1189# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will 1190# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base 1191# or super classes. Setting the tag to NO turns the diagrams off. Note that 1192# this option is superseded by the HAVE_DOT option below. This is only a 1193# fallback. It is recommended to install and use dot, since it yields more 1194# powerful graphs. 1195 1196CLASS_DIAGRAMS = YES 1197 1198# You can define message sequence charts within doxygen comments using the \msc 1199# command. Doxygen will then run the mscgen tool (see 1200# http://www.mcternan.me.uk/mscgen/) to produce the chart and insert it in the 1201# documentation. The MSCGEN_PATH tag allows you to specify the directory where 1202# the mscgen tool resides. If left empty the tool is assumed to be found in the 1203# default search path. 1204 1205MSCGEN_PATH = 1206 1207# If set to YES, the inheritance and collaboration graphs will hide 1208# inheritance and usage relations if the target is undocumented 1209# or is not a class. 1210 1211HIDE_UNDOC_RELATIONS = YES 1212 1213# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is 1214# available from the path. This tool is part of Graphviz, a graph visualization 1215# toolkit from AT&T and Lucent Bell Labs. The other options in this section 1216# have no effect if this option is set to NO (the default) 1217 1218HAVE_DOT = @DOXYGEN_USE_DOT@ 1219 1220# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen 1221# will generate a graph for each documented class showing the direct and 1222# indirect inheritance relations. Setting this tag to YES will force the 1223# the CLASS_DIAGRAMS tag to NO. 1224 1225CLASS_GRAPH = YES 1226 1227# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen 1228# will generate a graph for each documented class showing the direct and 1229# indirect implementation dependencies (inheritance, containment, and 1230# class references variables) of the class with other documented classes. 1231 1232COLLABORATION_GRAPH = NO 1233 1234# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen 1235# will generate a graph for groups, showing the direct groups dependencies 1236 1237GROUP_GRAPHS = YES 1238 1239# If the UML_LOOK tag is set to YES doxygen will generate inheritance and 1240# collaboration diagrams in a style similar to the OMG's Unified Modeling 1241# Language. 1242 1243UML_LOOK = NO 1244 1245# If set to YES, the inheritance and collaboration graphs will show the 1246# relations between templates and their instances. 1247 1248TEMPLATE_RELATIONS = YES 1249 1250# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT 1251# tags are set to YES then doxygen will generate a graph for each documented 1252# file showing the direct and indirect include dependencies of the file with 1253# other documented files. 1254 1255INCLUDE_GRAPH = NO 1256 1257# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and 1258# HAVE_DOT tags are set to YES then doxygen will generate a graph for each 1259# documented header file showing the documented files that directly or 1260# indirectly include this file. 1261 1262INCLUDED_BY_GRAPH = NO 1263 1264# If the CALL_GRAPH and HAVE_DOT options are set to YES then 1265# doxygen will generate a call dependency graph for every global function 1266# or class method. Note that enabling this option will significantly increase 1267# the time of a run. So in most cases it will be better to enable call graphs 1268# for selected functions only using the \callgraph command. 1269 1270CALL_GRAPH = NO 1271 1272# If the CALLER_GRAPH and HAVE_DOT tags are set to YES then 1273# doxygen will generate a caller dependency graph for every global function 1274# or class method. Note that enabling this option will significantly increase 1275# the time of a run. So in most cases it will be better to enable caller 1276# graphs for selected functions only using the \callergraph command. 1277 1278CALLER_GRAPH = NO 1279 1280# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen 1281# will graphical hierarchy of all classes instead of a textual one. 1282 1283GRAPHICAL_HIERARCHY = YES 1284 1285# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES 1286# then doxygen will show the dependencies a directory has on other directories 1287# in a graphical way. The dependency relations are determined by the #include 1288# relations between the files in the directories. 1289 1290DIRECTORY_GRAPH = YES 1291 1292# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images 1293# generated by dot. Possible values are png, jpg, or gif 1294# If left blank png will be used. 1295 1296DOT_IMAGE_FORMAT = png 1297 1298# The tag DOT_PATH can be used to specify the path where the dot tool can be 1299# found. If left blank, it is assumed the dot tool can be found in the path. 1300 1301DOT_PATH = 1302 1303# The DOTFILE_DIRS tag can be used to specify one or more directories that 1304# contain dot files that are included in the documentation (see the 1305# \dotfile command). 1306 1307DOTFILE_DIRS = 1308 1309# The MAX_DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of 1310# nodes that will be shown in the graph. If the number of nodes in a graph 1311# becomes larger than this value, doxygen will truncate the graph, which is 1312# visualized by representing a node as a red box. Note that doxygen if the 1313# number of direct children of the root node in a graph is already larger than 1314# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note 1315# that the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH. 1316 1317DOT_GRAPH_MAX_NODES = 50 1318 1319# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the 1320# graphs generated by dot. A depth value of 3 means that only nodes reachable 1321# from the root by following a path via at most 3 edges will be shown. Nodes 1322# that lay further from the root node will be omitted. Note that setting this 1323# option to 1 or 2 may greatly reduce the computation time needed for large 1324# code bases. Also note that the size of a graph can be further restricted by 1325# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction. 1326 1327MAX_DOT_GRAPH_DEPTH = 0 1328 1329# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent 1330# background. This is enabled by default, which results in a transparent 1331# background. Warning: Depending on the platform used, enabling this option 1332# may lead to badly anti-aliased labels on the edges of a graph (i.e. they 1333# become hard to read). 1334 1335DOT_TRANSPARENT = YES 1336 1337# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output 1338# files in one run (i.e. multiple -o and -T options on the command line). This 1339# makes dot run faster, but since only newer versions of dot (>1.8.10) 1340# support this, this feature is disabled by default. 1341 1342DOT_MULTI_TARGETS = NO 1343 1344# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will 1345# generate a legend page explaining the meaning of the various boxes and 1346# arrows in the dot generated graphs. 1347 1348GENERATE_LEGEND = YES 1349 1350# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will 1351# remove the intermediate dot files that are used to generate 1352# the various graphs. 1353 1354DOT_CLEANUP = YES 1355 1356#--------------------------------------------------------------------------- 1357# Configuration::additions related to the search engine 1358#--------------------------------------------------------------------------- 1359 1360# The SEARCHENGINE tag specifies whether or not a search engine should be 1361# used. If set to NO the values of all tags below this one will be ignored. 1362 1363SEARCHENGINE = NO 1364