1 1.1 mrg # Doxyfile 1.7.4 2 1.1 mrg 3 1.1 mrg # This file describes the settings to be used by the documentation system 4 1.1 mrg # doxygen (www.doxygen.org) for a project. 5 1.1 mrg # 6 1.1 mrg # All text after a hash (#) is considered a comment and will be ignored. 7 1.1 mrg # The format is: 8 1.1 mrg # TAG = value [value, ...] 9 1.1 mrg # For lists items can also be appended using: 10 1.1 mrg # TAG += value [value, ...] 11 1.1 mrg # Values that contain spaces should be placed between quotes (" "). 12 1.1 mrg 13 1.1 mrg #--------------------------------------------------------------------------- 14 1.1 mrg # Project related configuration options 15 1.1 mrg #--------------------------------------------------------------------------- 16 1.1 mrg 17 1.1 mrg # This tag specifies the encoding used for all characters in the config file 18 1.1 mrg # that follow. The default is UTF-8 which is also the encoding used for all 19 1.1 mrg # text before the first occurrence of this tag. Doxygen uses libiconv (or the 20 1.1 mrg # iconv built into libc) for the transcoding. See 21 1.1 mrg # http://www.gnu.org/software/libiconv for the list of possible encodings. 22 1.1 mrg 23 1.1 mrg DOXYFILE_ENCODING = UTF-8 24 1.1 mrg 25 1.1 mrg # The PROJECT_NAME tag is a single word (or a sequence of words surrounded 26 1.1 mrg # by quotes) that should identify the project. 27 1.1 mrg 28 1.1 mrg PROJECT_NAME = Clover 29 1.1 mrg 30 1.1 mrg # The PROJECT_NUMBER tag can be used to enter a project or revision number. 31 1.1 mrg # This could be handy for archiving the generated documentation or 32 1.1 mrg # if some version control system is used. 33 1.1 mrg 34 1.1 mrg PROJECT_NUMBER = 35 1.1 mrg 36 1.1 mrg # Using the PROJECT_BRIEF tag one can provide an optional one line description 37 1.1 mrg # for a project that appears at the top of each page and should give viewer 38 1.1 mrg # a quick idea about the purpose of the project. Keep the description short. 39 1.1 mrg 40 1.1 mrg PROJECT_BRIEF = 41 1.1 mrg 42 1.1 mrg # With the PROJECT_LOGO tag one can specify an logo or icon that is 43 1.1 mrg # included in the documentation. The maximum height of the logo should not 44 1.1 mrg # exceed 55 pixels and the maximum width should not exceed 200 pixels. 45 1.1 mrg # Doxygen will copy the logo to the output directory. 46 1.1 mrg 47 1.1 mrg PROJECT_LOGO = 48 1.1 mrg 49 1.1 mrg # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) 50 1.1 mrg # base path where the generated documentation will be put. 51 1.1 mrg # If a relative path is entered, it will be relative to the location 52 1.1 mrg # where doxygen was started. If left blank the current directory will be used. 53 1.1 mrg 54 1.1 mrg OUTPUT_DIRECTORY = 55 1.1 mrg 56 1.1 mrg # If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 57 1.1 mrg # 4096 sub-directories (in 2 levels) under the output directory of each output 58 1.1 mrg # format and will distribute the generated files over these directories. 59 1.1 mrg # Enabling this option can be useful when feeding doxygen a huge amount of 60 1.1 mrg # source files, where putting all generated files in the same directory would 61 1.1 mrg # otherwise cause performance problems for the file system. 62 1.1 mrg 63 1.1 mrg CREATE_SUBDIRS = NO 64 1.1 mrg 65 1.1 mrg # The OUTPUT_LANGUAGE tag is used to specify the language in which all 66 1.1 mrg # documentation generated by doxygen is written. Doxygen will use this 67 1.1 mrg # information to generate all constant output in the proper language. 68 1.1 mrg # The default language is English, other supported languages are: 69 1.1 mrg # Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional, 70 1.1 mrg # Croatian, Czech, Danish, Dutch, Esperanto, Farsi, Finnish, French, German, 71 1.1 mrg # Greek, Hungarian, Italian, Japanese, Japanese-en (Japanese with English 72 1.1 mrg # messages), Korean, Korean-en, Lithuanian, Norwegian, Macedonian, Persian, 73 1.1 mrg # Polish, Portuguese, Romanian, Russian, Serbian, Serbian-Cyrillic, Slovak, 74 1.1 mrg # Slovene, Spanish, Swedish, Ukrainian, and Vietnamese. 75 1.1 mrg 76 1.1 mrg OUTPUT_LANGUAGE = English 77 1.1 mrg 78 1.1 mrg # If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will 79 1.1 mrg # include brief member descriptions after the members that are listed in 80 1.1 mrg # the file and class documentation (similar to JavaDoc). 81 1.1 mrg # Set to NO to disable this. 82 1.1 mrg 83 1.1 mrg BRIEF_MEMBER_DESC = YES 84 1.1 mrg 85 1.1 mrg # If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend 86 1.1 mrg # the brief description of a member or function before the detailed description. 87 1.1 mrg # Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the 88 1.1 mrg # brief descriptions will be completely suppressed. 89 1.1 mrg 90 1.1 mrg REPEAT_BRIEF = YES 91 1.1 mrg 92 1.1 mrg # This tag implements a quasi-intelligent brief description abbreviator 93 1.1 mrg # that is used to form the text in various listings. Each string 94 1.1 mrg # in this list, if found as the leading text of the brief description, will be 95 1.1 mrg # stripped from the text and the result after processing the whole list, is 96 1.1 mrg # used as the annotated text. Otherwise, the brief description is used as-is. 97 1.1 mrg # If left blank, the following values are used ("$name" is automatically 98 1.1 mrg # replaced with the name of the entity): "The $name class" "The $name widget" 99 1.1 mrg # "The $name file" "is" "provides" "specifies" "contains" 100 1.1 mrg # "represents" "a" "an" "the" 101 1.1 mrg 102 1.1 mrg ABBREVIATE_BRIEF = 103 1.1 mrg 104 1.1 mrg # If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then 105 1.1 mrg # Doxygen will generate a detailed section even if there is only a brief 106 1.1 mrg # description. 107 1.1 mrg 108 1.1 mrg ALWAYS_DETAILED_SEC = NO 109 1.1 mrg 110 1.1 mrg # If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all 111 1.1 mrg # inherited members of a class in the documentation of that class as if those 112 1.1 mrg # members were ordinary class members. Constructors, destructors and assignment 113 1.1 mrg # operators of the base classes will not be shown. 114 1.1 mrg 115 1.1 mrg INLINE_INHERITED_MEMB = NO 116 1.1 mrg 117 1.1 mrg # If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full 118 1.1 mrg # path before files name in the file list and in the header files. If set 119 1.1 mrg # to NO the shortest path that makes the file name unique will be used. 120 1.1 mrg 121 1.1 mrg FULL_PATH_NAMES = YES 122 1.1 mrg 123 1.1 mrg # If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag 124 1.1 mrg # can be used to strip a user-defined part of the path. Stripping is 125 1.1 mrg # only done if one of the specified strings matches the left-hand part of 126 1.1 mrg # the path. The tag can be used to show relative paths in the file list. 127 1.1 mrg # If left blank the directory from which doxygen is run is used as the 128 1.1 mrg # path to strip. 129 1.1 mrg 130 1.1 mrg STRIP_FROM_PATH = 131 1.1 mrg 132 1.1 mrg # The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of 133 1.1 mrg # the path mentioned in the documentation of a class, which tells 134 1.1 mrg # the reader which header file to include in order to use a class. 135 1.1 mrg # If left blank only the name of the header file containing the class 136 1.1 mrg # definition is used. Otherwise one should specify the include paths that 137 1.1 mrg # are normally passed to the compiler using the -I flag. 138 1.1 mrg 139 1.1 mrg STRIP_FROM_INC_PATH = 140 1.1 mrg 141 1.1 mrg # If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter 142 1.1 mrg # (but less readable) file names. This can be useful if your file system 143 1.1 mrg # doesn't support long names like on DOS, Mac, or CD-ROM. 144 1.1 mrg 145 1.1 mrg SHORT_NAMES = NO 146 1.1 mrg 147 1.1 mrg # If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen 148 1.1 mrg # will interpret the first line (until the first dot) of a JavaDoc-style 149 1.1 mrg # comment as the brief description. If set to NO, the JavaDoc 150 1.1 mrg # comments will behave just like regular Qt-style comments 151 1.1 mrg # (thus requiring an explicit @brief command for a brief description.) 152 1.1 mrg 153 1.1 mrg JAVADOC_AUTOBRIEF = YES 154 1.1 mrg 155 1.1 mrg # If the QT_AUTOBRIEF tag is set to YES then Doxygen will 156 1.1 mrg # interpret the first line (until the first dot) of a Qt-style 157 1.1 mrg # comment as the brief description. If set to NO, the comments 158 1.1 mrg # will behave just like regular Qt-style comments (thus requiring 159 1.1 mrg # an explicit \brief command for a brief description.) 160 1.1 mrg 161 1.1 mrg QT_AUTOBRIEF = NO 162 1.1 mrg 163 1.1 mrg # The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen 164 1.1 mrg # treat a multi-line C++ special comment block (i.e. a block of //! or /// 165 1.1 mrg # comments) as a brief description. This used to be the default behaviour. 166 1.1 mrg # The new default is to treat a multi-line C++ comment block as a detailed 167 1.1 mrg # description. Set this tag to YES if you prefer the old behaviour instead. 168 1.1 mrg 169 1.1 mrg MULTILINE_CPP_IS_BRIEF = NO 170 1.1 mrg 171 1.1 mrg # If the INHERIT_DOCS tag is set to YES (the default) then an undocumented 172 1.1 mrg # member inherits the documentation from any documented member that it 173 1.1 mrg # re-implements. 174 1.1 mrg 175 1.1 mrg INHERIT_DOCS = YES 176 1.1 mrg 177 1.1 mrg # If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce 178 1.1 mrg # a new page for each member. If set to NO, the documentation of a member will 179 1.1 mrg # be part of the file/class/namespace that contains it. 180 1.1 mrg 181 1.1 mrg SEPARATE_MEMBER_PAGES = NO 182 1.1 mrg 183 1.1 mrg # The TAB_SIZE tag can be used to set the number of spaces in a tab. 184 1.1 mrg # Doxygen uses this value to replace tabs by spaces in code fragments. 185 1.1 mrg 186 1.1 mrg TAB_SIZE = 8 187 1.1 mrg 188 1.1 mrg # This tag can be used to specify a number of aliases that acts 189 1.1 mrg # as commands in the documentation. An alias has the form "name=value". 190 1.1 mrg # For example adding "sideeffect=\par Side Effects:\n" will allow you to 191 1.1 mrg # put the command \sideeffect (or @sideeffect) in the documentation, which 192 1.1 mrg # will result in a user-defined paragraph with heading "Side Effects:". 193 1.1 mrg # You can put \n's in the value part of an alias to insert newlines. 194 1.1 mrg 195 1.1 mrg ALIASES = 196 1.1 mrg 197 1.1 mrg # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C 198 1.1 mrg # sources only. Doxygen will then generate output that is more tailored for C. 199 1.1 mrg # For instance, some of the names that are used will be different. The list 200 1.1 mrg # of all members will be omitted, etc. 201 1.1 mrg 202 1.1 mrg OPTIMIZE_OUTPUT_FOR_C = NO 203 1.1 mrg 204 1.1 mrg # Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java 205 1.1 mrg # sources only. Doxygen will then generate output that is more tailored for 206 1.1 mrg # Java. For instance, namespaces will be presented as packages, qualified 207 1.1 mrg # scopes will look different, etc. 208 1.1 mrg 209 1.1 mrg OPTIMIZE_OUTPUT_JAVA = NO 210 1.1 mrg 211 1.1 mrg # Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran 212 1.1 mrg # sources only. Doxygen will then generate output that is more tailored for 213 1.1 mrg # Fortran. 214 1.1 mrg 215 1.1 mrg OPTIMIZE_FOR_FORTRAN = NO 216 1.1 mrg 217 1.1 mrg # Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL 218 1.1 mrg # sources. Doxygen will then generate output that is tailored for 219 1.1 mrg # VHDL. 220 1.1 mrg 221 1.1 mrg OPTIMIZE_OUTPUT_VHDL = NO 222 1.1 mrg 223 1.1 mrg # Doxygen selects the parser to use depending on the extension of the files it 224 1.1 mrg # parses. With this tag you can assign which parser to use for a given extension. 225 1.1 mrg # Doxygen has a built-in mapping, but you can override or extend it using this 226 1.1 mrg # tag. The format is ext=language, where ext is a file extension, and language 227 1.1 mrg # is one of the parsers supported by doxygen: IDL, Java, Javascript, CSharp, C, 228 1.1 mrg # C++, D, PHP, Objective-C, Python, Fortran, VHDL, C, C++. For instance to make 229 1.1 mrg # doxygen treat .inc files as Fortran files (default is PHP), and .f files as C 230 1.1 mrg # (default is Fortran), use: inc=Fortran f=C. Note that for custom extensions 231 1.1 mrg # you also need to set FILE_PATTERNS otherwise the files are not read by doxygen. 232 1.1 mrg 233 1.1 mrg EXTENSION_MAPPING = 234 1.1 mrg 235 1.1 mrg # If you use STL classes (i.e. std::string, std::vector, etc.) but do not want 236 1.1 mrg # to include (a tag file for) the STL sources as input, then you should 237 1.1 mrg # set this tag to YES in order to let doxygen match functions declarations and 238 1.1 mrg # definitions whose arguments contain STL classes (e.g. func(std::string); v.s. 239 1.1 mrg # func(std::string) {}). This also makes the inheritance and collaboration 240 1.1 mrg # diagrams that involve STL classes more complete and accurate. 241 1.1 mrg 242 1.1 mrg BUILTIN_STL_SUPPORT = YES 243 1.1 mrg 244 1.1 mrg # If you use Microsoft's C++/CLI language, you should set this option to YES to 245 1.1 mrg # enable parsing support. 246 1.1 mrg 247 1.1 mrg CPP_CLI_SUPPORT = NO 248 1.1 mrg 249 1.1 mrg # Set the SIP_SUPPORT tag to YES if your project consists of sip sources only. 250 1.1 mrg # Doxygen will parse them like normal C++ but will assume all classes use public 251 1.1 mrg # instead of private inheritance when no explicit protection keyword is present. 252 1.1 mrg 253 1.1 mrg SIP_SUPPORT = NO 254 1.1 mrg 255 1.1 mrg # For Microsoft's IDL there are propget and propput attributes to indicate getter 256 1.1 mrg # and setter methods for a property. Setting this option to YES (the default) 257 1.1 mrg # will make doxygen replace the get and set methods by a property in the 258 1.1 mrg # documentation. This will only work if the methods are indeed getting or 259 1.1 mrg # setting a simple type. If this is not the case, or you want to show the 260 1.1 mrg # methods anyway, you should set this option to NO. 261 1.1 mrg 262 1.1 mrg IDL_PROPERTY_SUPPORT = YES 263 1.1 mrg 264 1.1 mrg # If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC 265 1.1 mrg # tag is set to YES, then doxygen will reuse the documentation of the first 266 1.1 mrg # member in the group (if any) for the other members of the group. By default 267 1.1 mrg # all members of a group must be documented explicitly. 268 1.1 mrg 269 1.1 mrg DISTRIBUTE_GROUP_DOC = NO 270 1.1 mrg 271 1.1 mrg # Set the SUBGROUPING tag to YES (the default) to allow class member groups of 272 1.1 mrg # the same type (for instance a group of public functions) to be put as a 273 1.1 mrg # subgroup of that type (e.g. under the Public Functions section). Set it to 274 1.1 mrg # NO to prevent subgrouping. Alternatively, this can be done per class using 275 1.1 mrg # the \nosubgrouping command. 276 1.1 mrg 277 1.1 mrg SUBGROUPING = YES 278 1.1 mrg 279 1.1 mrg # When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and 280 1.1 mrg # unions are shown inside the group in which they are included (e.g. using 281 1.1 mrg # @ingroup) instead of on a separate page (for HTML and Man pages) or 282 1.1 mrg # section (for LaTeX and RTF). 283 1.1 mrg 284 1.1 mrg INLINE_GROUPED_CLASSES = NO 285 1.1 mrg 286 1.1 mrg # When TYPEDEF_HIDES_STRUCT is enabled, a typedef of a struct, union, or enum 287 1.1 mrg # is documented as struct, union, or enum with the name of the typedef. So 288 1.1 mrg # typedef struct TypeS {} TypeT, will appear in the documentation as a struct 289 1.1 mrg # with name TypeT. When disabled the typedef will appear as a member of a file, 290 1.1 mrg # namespace, or class. And the struct will be named TypeS. This can typically 291 1.1 mrg # be useful for C code in case the coding convention dictates that all compound 292 1.1 mrg # types are typedef'ed and only the typedef is referenced, never the tag name. 293 1.1 mrg 294 1.1 mrg TYPEDEF_HIDES_STRUCT = NO 295 1.1 mrg 296 1.1 mrg # The SYMBOL_CACHE_SIZE determines the size of the internal cache use to 297 1.1 mrg # determine which symbols to keep in memory and which to flush to disk. 298 1.1 mrg # When the cache is full, less often used symbols will be written to disk. 299 1.1 mrg # For small to medium size projects (<1000 input files) the default value is 300 1.1 mrg # probably good enough. For larger projects a too small cache size can cause 301 1.1 mrg # doxygen to be busy swapping symbols to and from disk most of the time 302 1.1 mrg # causing a significant performance penalty. 303 1.1 mrg # If the system has enough physical memory increasing the cache will improve the 304 1.1 mrg # performance by keeping more symbols in memory. Note that the value works on 305 1.1 mrg # a logarithmic scale so increasing the size by one will roughly double the 306 1.1 mrg # memory usage. The cache size is given by this formula: 307 1.1 mrg # 2^(16+SYMBOL_CACHE_SIZE). The valid range is 0..9, the default is 0, 308 1.1 mrg # corresponding to a cache size of 2^16 = 65536 symbols 309 1.1 mrg 310 1.1 mrg SYMBOL_CACHE_SIZE = 0 311 1.1 mrg 312 1.1 mrg #--------------------------------------------------------------------------- 313 1.1 mrg # Build related configuration options 314 1.1 mrg #--------------------------------------------------------------------------- 315 1.1 mrg 316 1.1 mrg # If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in 317 1.1 mrg # documentation are documented, even if no documentation was available. 318 1.1 mrg # Private class members and static file members will be hidden unless 319 1.1 mrg # the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES 320 1.1 mrg 321 1.1 mrg EXTRACT_ALL = NO 322 1.1 mrg 323 1.1 mrg # If the EXTRACT_PRIVATE tag is set to YES all private members of a class 324 1.1 mrg # will be included in the documentation. 325 1.1 mrg 326 1.1 mrg EXTRACT_PRIVATE = NO 327 1.1 mrg 328 1.1 mrg # If the EXTRACT_STATIC tag is set to YES all static members of a file 329 1.1 mrg # will be included in the documentation. 330 1.1 mrg 331 1.1 mrg EXTRACT_STATIC = NO 332 1.1 mrg 333 1.1 mrg # If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) 334 1.1 mrg # defined locally in source files will be included in the documentation. 335 1.1 mrg # If set to NO only classes defined in header files are included. 336 1.1 mrg 337 1.1 mrg EXTRACT_LOCAL_CLASSES = YES 338 1.1 mrg 339 1.1 mrg # This flag is only useful for Objective-C code. When set to YES local 340 1.1 mrg # methods, which are defined in the implementation section but not in 341 1.1 mrg # the interface are included in the documentation. 342 1.1 mrg # If set to NO (the default) only methods in the interface are included. 343 1.1 mrg 344 1.1 mrg EXTRACT_LOCAL_METHODS = NO 345 1.1 mrg 346 1.1 mrg # If this flag is set to YES, the members of anonymous namespaces will be 347 1.1 mrg # extracted and appear in the documentation as a namespace called 348 1.1 mrg # 'anonymous_namespace{file}', where file will be replaced with the base 349 1.1 mrg # name of the file that contains the anonymous namespace. By default 350 1.1 mrg # anonymous namespaces are hidden. 351 1.1 mrg 352 1.1 mrg EXTRACT_ANON_NSPACES = YES 353 1.1 mrg 354 1.1 mrg # If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all 355 1.1 mrg # undocumented members of documented classes, files or namespaces. 356 1.1 mrg # If set to NO (the default) these members will be included in the 357 1.1 mrg # various overviews, but no documentation section is generated. 358 1.1 mrg # This option has no effect if EXTRACT_ALL is enabled. 359 1.1 mrg 360 1.1 mrg HIDE_UNDOC_MEMBERS = NO 361 1.1 mrg 362 1.1 mrg # If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all 363 1.1 mrg # undocumented classes that are normally visible in the class hierarchy. 364 1.1 mrg # If set to NO (the default) these classes will be included in the various 365 1.1 mrg # overviews. This option has no effect if EXTRACT_ALL is enabled. 366 1.1 mrg 367 1.1 mrg HIDE_UNDOC_CLASSES = NO 368 1.1 mrg 369 1.1 mrg # If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all 370 1.1 mrg # friend (class|struct|union) declarations. 371 1.1 mrg # If set to NO (the default) these declarations will be included in the 372 1.1 mrg # documentation. 373 1.1 mrg 374 1.1 mrg HIDE_FRIEND_COMPOUNDS = NO 375 1.1 mrg 376 1.1 mrg # If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any 377 1.1 mrg # documentation blocks found inside the body of a function. 378 1.1 mrg # If set to NO (the default) these blocks will be appended to the 379 1.1 mrg # function's detailed documentation block. 380 1.1 mrg 381 1.1 mrg HIDE_IN_BODY_DOCS = NO 382 1.1 mrg 383 1.1 mrg # The INTERNAL_DOCS tag determines if documentation 384 1.1 mrg # that is typed after a \internal command is included. If the tag is set 385 1.1 mrg # to NO (the default) then the documentation will be excluded. 386 1.1 mrg # Set it to YES to include the internal documentation. 387 1.1 mrg 388 1.1 mrg INTERNAL_DOCS = NO 389 1.1 mrg 390 1.1 mrg # If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate 391 1.1 mrg # file names in lower-case letters. If set to YES upper-case letters are also 392 1.1 mrg # allowed. This is useful if you have classes or files whose names only differ 393 1.1 mrg # in case and if your file system supports case sensitive file names. Windows 394 1.1 mrg # and Mac users are advised to set this option to NO. 395 1.1 mrg 396 1.1 mrg CASE_SENSE_NAMES = YES 397 1.1 mrg 398 1.1 mrg # If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen 399 1.1 mrg # will show members with their full class and namespace scopes in the 400 1.1 mrg # documentation. If set to YES the scope will be hidden. 401 1.1 mrg 402 1.1 mrg HIDE_SCOPE_NAMES = NO 403 1.1 mrg 404 1.1 mrg # If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen 405 1.1 mrg # will put a list of the files that are included by a file in the documentation 406 1.1 mrg # of that file. 407 1.1 mrg 408 1.1 mrg SHOW_INCLUDE_FILES = YES 409 1.1 mrg 410 1.1 mrg # If the FORCE_LOCAL_INCLUDES tag is set to YES then Doxygen 411 1.1 mrg # will list include files with double quotes in the documentation 412 1.1 mrg # rather than with sharp brackets. 413 1.1 mrg 414 1.1 mrg FORCE_LOCAL_INCLUDES = NO 415 1.1 mrg 416 1.1 mrg # If the INLINE_INFO tag is set to YES (the default) then a tag [inline] 417 1.1 mrg # is inserted in the documentation for inline members. 418 1.1 mrg 419 1.1 mrg INLINE_INFO = YES 420 1.1 mrg 421 1.1 mrg # If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen 422 1.1 mrg # will sort the (detailed) documentation of file and class members 423 1.1 mrg # alphabetically by member name. If set to NO the members will appear in 424 1.1 mrg # declaration order. 425 1.1 mrg 426 1.1 mrg SORT_MEMBER_DOCS = YES 427 1.1 mrg 428 1.1 mrg # If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the 429 1.1 mrg # brief documentation of file, namespace and class members alphabetically 430 1.1 mrg # by member name. If set to NO (the default) the members will appear in 431 1.1 mrg # declaration order. 432 1.1 mrg 433 1.1 mrg SORT_BRIEF_DOCS = NO 434 1.1 mrg 435 1.1 mrg # If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen 436 1.1 mrg # will sort the (brief and detailed) documentation of class members so that 437 1.1 mrg # constructors and destructors are listed first. If set to NO (the default) 438 1.1 mrg # the constructors will appear in the respective orders defined by 439 1.1 mrg # SORT_MEMBER_DOCS and SORT_BRIEF_DOCS. 440 1.1 mrg # This tag will be ignored for brief docs if SORT_BRIEF_DOCS is set to NO 441 1.1 mrg # and ignored for detailed docs if SORT_MEMBER_DOCS is set to NO. 442 1.1 mrg 443 1.1 mrg SORT_MEMBERS_CTORS_1ST = NO 444 1.1 mrg 445 1.1 mrg # If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the 446 1.1 mrg # hierarchy of group names into alphabetical order. If set to NO (the default) 447 1.1 mrg # the group names will appear in their defined order. 448 1.1 mrg 449 1.1 mrg SORT_GROUP_NAMES = NO 450 1.1 mrg 451 1.1 mrg # If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be 452 1.1 mrg # sorted by fully-qualified names, including namespaces. If set to 453 1.1 mrg # NO (the default), the class list will be sorted only by class name, 454 1.1 mrg # not including the namespace part. 455 1.1 mrg # Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. 456 1.1 mrg # Note: This option applies only to the class list, not to the 457 1.1 mrg # alphabetical list. 458 1.1 mrg 459 1.1 mrg SORT_BY_SCOPE_NAME = NO 460 1.1 mrg 461 1.1 mrg # If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to 462 1.1 mrg # do proper type resolution of all parameters of a function it will reject a 463 1.1 mrg # match between the prototype and the implementation of a member function even 464 1.1 mrg # if there is only one candidate or it is obvious which candidate to choose 465 1.1 mrg # by doing a simple string match. By disabling STRICT_PROTO_MATCHING doxygen 466 1.1 mrg # will still accept a match between prototype and implementation in such cases. 467 1.1 mrg 468 1.1 mrg STRICT_PROTO_MATCHING = NO 469 1.1 mrg 470 1.1 mrg # The GENERATE_TODOLIST tag can be used to enable (YES) or 471 1.1 mrg # disable (NO) the todo list. This list is created by putting \todo 472 1.1 mrg # commands in the documentation. 473 1.1 mrg 474 1.1 mrg GENERATE_TODOLIST = YES 475 1.1 mrg 476 1.1 mrg # The GENERATE_TESTLIST tag can be used to enable (YES) or 477 1.1 mrg # disable (NO) the test list. This list is created by putting \test 478 1.1 mrg # commands in the documentation. 479 1.1 mrg 480 1.1 mrg GENERATE_TESTLIST = YES 481 1.1 mrg 482 1.1 mrg # The GENERATE_BUGLIST tag can be used to enable (YES) or 483 1.1 mrg # disable (NO) the bug list. This list is created by putting \bug 484 1.1 mrg # commands in the documentation. 485 1.1 mrg 486 1.1 mrg GENERATE_BUGLIST = YES 487 1.1 mrg 488 1.1 mrg # The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or 489 1.1 mrg # disable (NO) the deprecated list. This list is created by putting 490 1.1 mrg # \deprecated commands in the documentation. 491 1.1 mrg 492 1.1 mrg GENERATE_DEPRECATEDLIST= YES 493 1.1 mrg 494 1.1 mrg # The ENABLED_SECTIONS tag can be used to enable conditional 495 1.1 mrg # documentation sections, marked by \if sectionname ... \endif. 496 1.1 mrg 497 1.1 mrg ENABLED_SECTIONS = 498 1.1 mrg 499 1.1 mrg # The MAX_INITIALIZER_LINES tag determines the maximum number of lines 500 1.1 mrg # the initial value of a variable or macro consists of for it to appear in 501 1.1 mrg # the documentation. If the initializer consists of more lines than specified 502 1.1 mrg # here it will be hidden. Use a value of 0 to hide initializers completely. 503 1.1 mrg # The appearance of the initializer of individual variables and macros in the 504 1.1 mrg # documentation can be controlled using \showinitializer or \hideinitializer 505 1.1 mrg # command in the documentation regardless of this setting. 506 1.1 mrg 507 1.1 mrg MAX_INITIALIZER_LINES = 30 508 1.1 mrg 509 1.1 mrg # Set the SHOW_USED_FILES tag to NO to disable the list of files generated 510 1.1 mrg # at the bottom of the documentation of classes and structs. If set to YES the 511 1.1 mrg # list will mention the files that were used to generate the documentation. 512 1.1 mrg 513 1.1 mrg SHOW_USED_FILES = YES 514 1.1 mrg 515 1.1 mrg # If the sources in your project are distributed over multiple directories 516 1.1 mrg # then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy 517 1.1 mrg # in the documentation. The default is NO. 518 1.1 mrg 519 1.1 mrg SHOW_DIRECTORIES = NO 520 1.1 mrg 521 1.1 mrg # Set the SHOW_FILES tag to NO to disable the generation of the Files page. 522 1.1 mrg # This will remove the Files entry from the Quick Index and from the 523 1.1 mrg # Folder Tree View (if specified). The default is YES. 524 1.1 mrg 525 1.1 mrg SHOW_FILES = YES 526 1.1 mrg 527 1.1 mrg # Set the SHOW_NAMESPACES tag to NO to disable the generation of the 528 1.1 mrg # Namespaces page. 529 1.1 mrg # This will remove the Namespaces entry from the Quick Index 530 1.1 mrg # and from the Folder Tree View (if specified). The default is YES. 531 1.1 mrg 532 1.1 mrg SHOW_NAMESPACES = YES 533 1.1 mrg 534 1.1 mrg # The FILE_VERSION_FILTER tag can be used to specify a program or script that 535 1.1 mrg # doxygen should invoke to get the current version for each file (typically from 536 1.1 mrg # the version control system). Doxygen will invoke the program by executing (via 537 1.1 mrg # popen()) the command <command> <input-file>, where <command> is the value of 538 1.1 mrg # the FILE_VERSION_FILTER tag, and <input-file> is the name of an input file 539 1.1 mrg # provided by doxygen. Whatever the program writes to standard output 540 1.1 mrg # is used as the file version. See the manual for examples. 541 1.1 mrg 542 1.1 mrg FILE_VERSION_FILTER = 543 1.1 mrg 544 1.1 mrg # The LAYOUT_FILE tag can be used to specify a layout file which will be parsed 545 1.1 mrg # by doxygen. The layout file controls the global structure of the generated 546 1.1 mrg # output files in an output format independent way. The create the layout file 547 1.1 mrg # that represents doxygen's defaults, run doxygen with the -l option. 548 1.1 mrg # You can optionally specify a file name after the option, if omitted 549 1.1 mrg # DoxygenLayout.xml will be used as the name of the layout file. 550 1.1 mrg 551 1.1 mrg LAYOUT_FILE = 552 1.1 mrg 553 1.1 mrg #--------------------------------------------------------------------------- 554 1.1 mrg # configuration options related to warning and progress messages 555 1.1 mrg #--------------------------------------------------------------------------- 556 1.1 mrg 557 1.1 mrg # The QUIET tag can be used to turn on/off the messages that are generated 558 1.1 mrg # by doxygen. Possible values are YES and NO. If left blank NO is used. 559 1.1 mrg 560 1.1 mrg QUIET = NO 561 1.1 mrg 562 1.1 mrg # The WARNINGS tag can be used to turn on/off the warning messages that are 563 1.1 mrg # generated by doxygen. Possible values are YES and NO. If left blank 564 1.1 mrg # NO is used. 565 1.1 mrg 566 1.1 mrg WARNINGS = YES 567 1.1 mrg 568 1.1 mrg # If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings 569 1.1 mrg # for undocumented members. If EXTRACT_ALL is set to YES then this flag will 570 1.1 mrg # automatically be disabled. 571 1.1 mrg 572 1.1 mrg WARN_IF_UNDOCUMENTED = NO 573 1.1 mrg 574 1.1 mrg # If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for 575 1.1 mrg # potential errors in the documentation, such as not documenting some 576 1.1 mrg # parameters in a documented function, or documenting parameters that 577 1.1 mrg # don't exist or using markup commands wrongly. 578 1.1 mrg 579 1.1 mrg WARN_IF_DOC_ERROR = YES 580 1.1 mrg 581 1.1 mrg # The WARN_NO_PARAMDOC option can be enabled to get warnings for 582 1.1 mrg # functions that are documented, but have no documentation for their parameters 583 1.1 mrg # or return value. If set to NO (the default) doxygen will only warn about 584 1.1 mrg # wrong or incomplete parameter documentation, but not about the absence of 585 1.1 mrg # documentation. 586 1.1 mrg 587 1.1 mrg WARN_NO_PARAMDOC = NO 588 1.1 mrg 589 1.1 mrg # The WARN_FORMAT tag determines the format of the warning messages that 590 1.1 mrg # doxygen can produce. The string should contain the $file, $line, and $text 591 1.1 mrg # tags, which will be replaced by the file and line number from which the 592 1.1 mrg # warning originated and the warning text. Optionally the format may contain 593 1.1 mrg # $version, which will be replaced by the version of the file (if it could 594 1.1 mrg # be obtained via FILE_VERSION_FILTER) 595 1.1 mrg 596 1.1 mrg WARN_FORMAT = "$file:$line: $text" 597 1.1 mrg 598 1.1 mrg # The WARN_LOGFILE tag can be used to specify a file to which warning 599 1.1 mrg # and error messages should be written. If left blank the output is written 600 1.1 mrg # to stderr. 601 1.1 mrg 602 1.1 mrg WARN_LOGFILE = 603 1.1 mrg 604 1.1 mrg #--------------------------------------------------------------------------- 605 1.1 mrg # configuration options related to the input files 606 1.1 mrg #--------------------------------------------------------------------------- 607 1.1 mrg 608 1.1 mrg # The INPUT tag can be used to specify the files and/or directories that contain 609 1.1 mrg # documented source files. You may enter file names like "myfile.cpp" or 610 1.1 mrg # directories like "/usr/src/myproject". Separate the files or directories 611 1.1 mrg # with spaces. 612 1.1 mrg 613 1.1 mrg INPUT = api/ core/ util/ 614 1.1 mrg 615 1.1 mrg # This tag can be used to specify the character encoding of the source files 616 1.1 mrg # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is 617 1.1 mrg # also the default input encoding. Doxygen uses libiconv (or the iconv built 618 1.1 mrg # into libc) for the transcoding. See http://www.gnu.org/software/libiconv for 619 1.1 mrg # the list of possible encodings. 620 1.1 mrg 621 1.1 mrg INPUT_ENCODING = UTF-8 622 1.1 mrg 623 1.1 mrg # If the value of the INPUT tag contains directories, you can use the 624 1.1 mrg # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 625 1.1 mrg # and *.h) to filter out the source-files in the directories. If left 626 1.1 mrg # blank the following patterns are tested: 627 1.1 mrg # *.c *.cc *.cxx *.cpp *.c++ *.d *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh 628 1.1 mrg # *.hxx *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.dox *.py 629 1.1 mrg # *.f90 *.f *.for *.vhd *.vhdl 630 1.1 mrg 631 1.1 mrg FILE_PATTERNS = 632 1.1 mrg 633 1.1 mrg # The RECURSIVE tag can be used to turn specify whether or not subdirectories 634 1.1 mrg # should be searched for input files as well. Possible values are YES and NO. 635 1.1 mrg # If left blank NO is used. 636 1.1 mrg 637 1.1 mrg RECURSIVE = NO 638 1.1 mrg 639 1.1 mrg # The EXCLUDE tag can be used to specify files and/or directories that should 640 1.1 mrg # excluded from the INPUT source files. This way you can easily exclude a 641 1.1 mrg # subdirectory from a directory tree whose root is specified with the INPUT tag. 642 1.1 mrg 643 1.1 mrg EXCLUDE = 644 1.1 mrg 645 1.1 mrg # The EXCLUDE_SYMLINKS tag can be used select whether or not files or 646 1.1 mrg # directories that are symbolic links (a Unix file system feature) are excluded 647 1.1 mrg # from the input. 648 1.1 mrg 649 1.1 mrg EXCLUDE_SYMLINKS = NO 650 1.1 mrg 651 1.1 mrg # If the value of the INPUT tag contains directories, you can use the 652 1.1 mrg # EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude 653 1.1 mrg # certain files from those directories. Note that the wildcards are matched 654 1.1 mrg # against the file with absolute path, so to exclude all test directories 655 1.1 mrg # for example use the pattern */test/* 656 1.1 mrg 657 1.1 mrg EXCLUDE_PATTERNS = 658 1.1 mrg 659 1.1 mrg # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names 660 1.1 mrg # (namespaces, classes, functions, etc.) that should be excluded from the 661 1.1 mrg # output. The symbol name can be a fully qualified name, a word, or if the 662 1.1 mrg # wildcard * is used, a substring. Examples: ANamespace, AClass, 663 1.1 mrg # AClass::ANamespace, ANamespace::*Test 664 1.1 mrg 665 1.1 mrg EXCLUDE_SYMBOLS = 666 1.1 mrg 667 1.1 mrg # The EXAMPLE_PATH tag can be used to specify one or more files or 668 1.1 mrg # directories that contain example code fragments that are included (see 669 1.1 mrg # the \include command). 670 1.1 mrg 671 1.1 mrg EXAMPLE_PATH = 672 1.1 mrg 673 1.1 mrg # If the value of the EXAMPLE_PATH tag contains directories, you can use the 674 1.1 mrg # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 675 1.1 mrg # and *.h) to filter out the source-files in the directories. If left 676 1.1 mrg # blank all files are included. 677 1.1 mrg 678 1.1 mrg EXAMPLE_PATTERNS = 679 1.1 mrg 680 1.1 mrg # If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be 681 1.1 mrg # searched for input files to be used with the \include or \dontinclude 682 1.1 mrg # commands irrespective of the value of the RECURSIVE tag. 683 1.1 mrg # Possible values are YES and NO. If left blank NO is used. 684 1.1 mrg 685 1.1 mrg EXAMPLE_RECURSIVE = NO 686 1.1 mrg 687 1.1 mrg # The IMAGE_PATH tag can be used to specify one or more files or 688 1.1 mrg # directories that contain image that are included in the documentation (see 689 1.1 mrg # the \image command). 690 1.1 mrg 691 1.1 mrg IMAGE_PATH = 692 1.1 mrg 693 1.1 mrg # The INPUT_FILTER tag can be used to specify a program that doxygen should 694 1.1 mrg # invoke to filter for each input file. Doxygen will invoke the filter program 695 1.1 mrg # by executing (via popen()) the command <filter> <input-file>, where <filter> 696 1.1 mrg # is the value of the INPUT_FILTER tag, and <input-file> is the name of an 697 1.1 mrg # input file. Doxygen will then use the output that the filter program writes 698 1.1 mrg # to standard output. 699 1.1 mrg # If FILTER_PATTERNS is specified, this tag will be 700 1.1 mrg # ignored. 701 1.1 mrg 702 1.1 mrg INPUT_FILTER = 703 1.1 mrg 704 1.1 mrg # The FILTER_PATTERNS tag can be used to specify filters on a per file pattern 705 1.1 mrg # basis. 706 1.1 mrg # Doxygen will compare the file name with each pattern and apply the 707 1.1 mrg # filter if there is a match. 708 1.1 mrg # The filters are a list of the form: 709 1.1 mrg # pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further 710 1.1 mrg # info on how filters are used. If FILTER_PATTERNS is empty or if 711 1.1 mrg # non of the patterns match the file name, INPUT_FILTER is applied. 712 1.1 mrg 713 1.1 mrg FILTER_PATTERNS = 714 1.1 mrg 715 1.1 mrg # If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using 716 1.1 mrg # INPUT_FILTER) will be used to filter the input files when producing source 717 1.1 mrg # files to browse (i.e. when SOURCE_BROWSER is set to YES). 718 1.1 mrg 719 1.1 mrg FILTER_SOURCE_FILES = NO 720 1.1 mrg 721 1.1 mrg # The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file 722 1.1 mrg # pattern. A pattern will override the setting for FILTER_PATTERN (if any) 723 1.1 mrg # and it is also possible to disable source filtering for a specific pattern 724 1.1 mrg # using *.ext= (so without naming a filter). This option only has effect when 725 1.1 mrg # FILTER_SOURCE_FILES is enabled. 726 1.1 mrg 727 1.1 mrg FILTER_SOURCE_PATTERNS = 728 1.1 mrg 729 1.1 mrg #--------------------------------------------------------------------------- 730 1.1 mrg # configuration options related to source browsing 731 1.1 mrg #--------------------------------------------------------------------------- 732 1.1 mrg 733 1.1 mrg # If the SOURCE_BROWSER tag is set to YES then a list of source files will 734 1.1 mrg # be generated. Documented entities will be cross-referenced with these sources. 735 1.1 mrg # Note: To get rid of all source code in the generated output, make sure also 736 1.1 mrg # VERBATIM_HEADERS is set to NO. 737 1.1 mrg 738 1.1 mrg SOURCE_BROWSER = NO 739 1.1 mrg 740 1.1 mrg # Setting the INLINE_SOURCES tag to YES will include the body 741 1.1 mrg # of functions and classes directly in the documentation. 742 1.1 mrg 743 1.1 mrg INLINE_SOURCES = NO 744 1.1 mrg 745 1.1 mrg # Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct 746 1.1 mrg # doxygen to hide any special comment blocks from generated source code 747 1.1 mrg # fragments. Normal C and C++ comments will always remain visible. 748 1.1 mrg 749 1.1 mrg STRIP_CODE_COMMENTS = YES 750 1.1 mrg 751 1.1 mrg # If the REFERENCED_BY_RELATION tag is set to YES 752 1.1 mrg # then for each documented function all documented 753 1.1 mrg # functions referencing it will be listed. 754 1.1 mrg 755 1.1 mrg REFERENCED_BY_RELATION = NO 756 1.1 mrg 757 1.1 mrg # If the REFERENCES_RELATION tag is set to YES 758 1.1 mrg # then for each documented function all documented entities 759 1.1 mrg # called/used by that function will be listed. 760 1.1 mrg 761 1.1 mrg REFERENCES_RELATION = NO 762 1.1 mrg 763 1.1 mrg # If the REFERENCES_LINK_SOURCE tag is set to YES (the default) 764 1.1 mrg # and SOURCE_BROWSER tag is set to YES, then the hyperlinks from 765 1.1 mrg # functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will 766 1.1 mrg # link to the source code. 767 1.1 mrg # Otherwise they will link to the documentation. 768 1.1 mrg 769 1.1 mrg REFERENCES_LINK_SOURCE = YES 770 1.1 mrg 771 1.1 mrg # If the USE_HTAGS tag is set to YES then the references to source code 772 1.1 mrg # will point to the HTML generated by the htags(1) tool instead of doxygen 773 1.1 mrg # built-in source browser. The htags tool is part of GNU's global source 774 1.1 mrg # tagging system (see http://www.gnu.org/software/global/global.html). You 775 1.1 mrg # will need version 4.8.6 or higher. 776 1.1 mrg 777 1.1 mrg USE_HTAGS = NO 778 1.1 mrg 779 1.1 mrg # If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen 780 1.1 mrg # will generate a verbatim copy of the header file for each class for 781 1.1 mrg # which an include is specified. Set to NO to disable this. 782 1.1 mrg 783 1.1 mrg VERBATIM_HEADERS = YES 784 1.1 mrg 785 1.1 mrg #--------------------------------------------------------------------------- 786 1.1 mrg # configuration options related to the alphabetical class index 787 1.1 mrg #--------------------------------------------------------------------------- 788 1.1 mrg 789 1.1 mrg # If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index 790 1.1 mrg # of all compounds will be generated. Enable this if the project 791 1.1 mrg # contains a lot of classes, structs, unions or interfaces. 792 1.1 mrg 793 1.1 mrg ALPHABETICAL_INDEX = YES 794 1.1 mrg 795 1.1 mrg # If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then 796 1.1 mrg # the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns 797 1.1 mrg # in which this list will be split (can be a number in the range [1..20]) 798 1.1 mrg 799 1.1 mrg COLS_IN_ALPHA_INDEX = 5 800 1.1 mrg 801 1.1 mrg # In case all classes in a project start with a common prefix, all 802 1.1 mrg # classes will be put under the same header in the alphabetical index. 803 1.1 mrg # The IGNORE_PREFIX tag can be used to specify one or more prefixes that 804 1.1 mrg # should be ignored while generating the index headers. 805 1.1 mrg 806 1.1 mrg IGNORE_PREFIX = 807 1.1 mrg 808 1.1 mrg #--------------------------------------------------------------------------- 809 1.1 mrg # configuration options related to the HTML output 810 1.1 mrg #--------------------------------------------------------------------------- 811 1.1 mrg 812 1.1 mrg # If the GENERATE_HTML tag is set to YES (the default) Doxygen will 813 1.1 mrg # generate HTML output. 814 1.1 mrg 815 1.1 mrg GENERATE_HTML = YES 816 1.1 mrg 817 1.1 mrg # The HTML_OUTPUT tag is used to specify where the HTML docs will be put. 818 1.1 mrg # If a relative path is entered the value of OUTPUT_DIRECTORY will be 819 1.1 mrg # put in front of it. If left blank `html' will be used as the default path. 820 1.1 mrg 821 1.1 mrg HTML_OUTPUT = html 822 1.1 mrg 823 1.1 mrg # The HTML_FILE_EXTENSION tag can be used to specify the file extension for 824 1.1 mrg # each generated HTML page (for example: .htm,.php,.asp). If it is left blank 825 1.1 mrg # doxygen will generate files with .html extension. 826 1.1 mrg 827 1.1 mrg HTML_FILE_EXTENSION = .html 828 1.1 mrg 829 1.1 mrg # The HTML_HEADER tag can be used to specify a personal HTML header for 830 1.1 mrg # each generated HTML page. If it is left blank doxygen will generate a 831 1.1 mrg # standard header. Note that when using a custom header you are responsible 832 1.1 mrg # for the proper inclusion of any scripts and style sheets that doxygen 833 1.1 mrg # needs, which is dependent on the configuration options used. 834 1.1 mrg # It is adviced to generate a default header using "doxygen -w html 835 1.1 mrg # header.html footer.html stylesheet.css YourConfigFile" and then modify 836 1.1 mrg # that header. Note that the header is subject to change so you typically 837 1.1 mrg # have to redo this when upgrading to a newer version of doxygen or when changing the value of configuration settings such as GENERATE_TREEVIEW! 838 1.1 mrg 839 1.1 mrg HTML_HEADER = 840 1.1 mrg 841 1.1 mrg # The HTML_FOOTER tag can be used to specify a personal HTML footer for 842 1.1 mrg # each generated HTML page. If it is left blank doxygen will generate a 843 1.1 mrg # standard footer. 844 1.1 mrg 845 1.1 mrg HTML_FOOTER = 846 1.1 mrg 847 1.1 mrg # The HTML_STYLESHEET tag can be used to specify a user-defined cascading 848 1.1 mrg # style sheet that is used by each HTML page. It can be used to 849 1.1 mrg # fine-tune the look of the HTML output. If the tag is left blank doxygen 850 1.1 mrg # will generate a default style sheet. Note that doxygen will try to copy 851 1.1 mrg # the style sheet file to the HTML output directory, so don't put your own 852 1.1 mrg # stylesheet in the HTML output directory as well, or it will be erased! 853 1.1 mrg 854 1.1 mrg HTML_STYLESHEET = 855 1.1 mrg 856 1.1 mrg # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or 857 1.1 mrg # other source files which should be copied to the HTML output directory. Note 858 1.1 mrg # that these files will be copied to the base HTML output directory. Use the 859 1.1 mrg # $relpath$ marker in the HTML_HEADER and/or HTML_FOOTER files to load these 860 1.1 mrg # files. In the HTML_STYLESHEET file, use the file name only. Also note that 861 1.1 mrg # the files will be copied as-is; there are no commands or markers available. 862 1.1 mrg 863 1.1 mrg HTML_EXTRA_FILES = 864 1.1 mrg 865 1.1 mrg # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. 866 1.1 mrg # Doxygen will adjust the colors in the stylesheet and background images 867 1.1 mrg # according to this color. Hue is specified as an angle on a colorwheel, 868 1.1 mrg # see http://en.wikipedia.org/wiki/Hue for more information. 869 1.1 mrg # For instance the value 0 represents red, 60 is yellow, 120 is green, 870 1.1 mrg # 180 is cyan, 240 is blue, 300 purple, and 360 is red again. 871 1.1 mrg # The allowed range is 0 to 359. 872 1.1 mrg 873 1.1 mrg HTML_COLORSTYLE_HUE = 220 874 1.1 mrg 875 1.1 mrg # The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of 876 1.1 mrg # the colors in the HTML output. For a value of 0 the output will use 877 1.1 mrg # grayscales only. A value of 255 will produce the most vivid colors. 878 1.1 mrg 879 1.1 mrg HTML_COLORSTYLE_SAT = 100 880 1.1 mrg 881 1.1 mrg # The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to 882 1.1 mrg # the luminance component of the colors in the HTML output. Values below 883 1.1 mrg # 100 gradually make the output lighter, whereas values above 100 make 884 1.1 mrg # the output darker. The value divided by 100 is the actual gamma applied, 885 1.1 mrg # so 80 represents a gamma of 0.8, The value 220 represents a gamma of 2.2, 886 1.1 mrg # and 100 does not change the gamma. 887 1.1 mrg 888 1.1 mrg HTML_COLORSTYLE_GAMMA = 80 889 1.1 mrg 890 1.1 mrg # If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML 891 1.1 mrg # page will contain the date and time when the page was generated. Setting 892 1.1 mrg # this to NO can help when comparing the output of multiple runs. 893 1.1 mrg 894 1.1 mrg HTML_TIMESTAMP = YES 895 1.1 mrg 896 1.1 mrg # If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, 897 1.1 mrg # files or namespaces will be aligned in HTML using tables. If set to 898 1.1 mrg # NO a bullet list will be used. 899 1.1 mrg 900 1.1 mrg HTML_ALIGN_MEMBERS = YES 901 1.1 mrg 902 1.1 mrg # If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML 903 1.1 mrg # documentation will contain sections that can be hidden and shown after the 904 1.1 mrg # page has loaded. For this to work a browser that supports 905 1.1 mrg # JavaScript and DHTML is required (for instance Mozilla 1.0+, Firefox 906 1.1 mrg # Netscape 6.0+, Internet explorer 5.0+, Konqueror, or Safari). 907 1.1 mrg 908 1.1 mrg HTML_DYNAMIC_SECTIONS = NO 909 1.1 mrg 910 1.1 mrg # If the GENERATE_DOCSET tag is set to YES, additional index files 911 1.1 mrg # will be generated that can be used as input for Apple's Xcode 3 912 1.1 mrg # integrated development environment, introduced with OSX 10.5 (Leopard). 913 1.1 mrg # To create a documentation set, doxygen will generate a Makefile in the 914 1.1 mrg # HTML output directory. Running make will produce the docset in that 915 1.1 mrg # directory and running "make install" will install the docset in 916 1.1 mrg # ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find 917 1.1 mrg # it at startup. 918 1.1 mrg # See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html 919 1.1 mrg # for more information. 920 1.1 mrg 921 1.1 mrg GENERATE_DOCSET = NO 922 1.1 mrg 923 1.1 mrg # When GENERATE_DOCSET tag is set to YES, this tag determines the name of the 924 1.1 mrg # feed. A documentation feed provides an umbrella under which multiple 925 1.1 mrg # documentation sets from a single provider (such as a company or product suite) 926 1.1 mrg # can be grouped. 927 1.1 mrg 928 1.1 mrg DOCSET_FEEDNAME = "Doxygen generated docs" 929 1.1 mrg 930 1.1 mrg # When GENERATE_DOCSET tag is set to YES, this tag specifies a string that 931 1.1 mrg # should uniquely identify the documentation set bundle. This should be a 932 1.1 mrg # reverse domain-name style string, e.g. com.mycompany.MyDocSet. Doxygen 933 1.1 mrg # will append .docset to the name. 934 1.1 mrg 935 1.1 mrg DOCSET_BUNDLE_ID = org.doxygen.Project 936 1.1 mrg 937 1.1 mrg # When GENERATE_PUBLISHER_ID tag specifies a string that should uniquely identify 938 1.1 mrg # the documentation publisher. This should be a reverse domain-name style 939 1.1 mrg # string, e.g. com.mycompany.MyDocSet.documentation. 940 1.1 mrg 941 1.1 mrg DOCSET_PUBLISHER_ID = org.doxygen.Publisher 942 1.1 mrg 943 1.1 mrg # The GENERATE_PUBLISHER_NAME tag identifies the documentation publisher. 944 1.1 mrg 945 1.1 mrg DOCSET_PUBLISHER_NAME = Publisher 946 1.1 mrg 947 1.1 mrg # If the GENERATE_HTMLHELP tag is set to YES, additional index files 948 1.1 mrg # will be generated that can be used as input for tools like the 949 1.1 mrg # Microsoft HTML help workshop to generate a compiled HTML help file (.chm) 950 1.1 mrg # of the generated HTML documentation. 951 1.1 mrg 952 1.1 mrg GENERATE_HTMLHELP = NO 953 1.1 mrg 954 1.1 mrg # If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can 955 1.1 mrg # be used to specify the file name of the resulting .chm file. You 956 1.1 mrg # can add a path in front of the file if the result should not be 957 1.1 mrg # written to the html output directory. 958 1.1 mrg 959 1.1 mrg CHM_FILE = 960 1.1 mrg 961 1.1 mrg # If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can 962 1.1 mrg # be used to specify the location (absolute path including file name) of 963 1.1 mrg # the HTML help compiler (hhc.exe). If non-empty doxygen will try to run 964 1.1 mrg # the HTML help compiler on the generated index.hhp. 965 1.1 mrg 966 1.1 mrg HHC_LOCATION = 967 1.1 mrg 968 1.1 mrg # If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag 969 1.1 mrg # controls if a separate .chi index file is generated (YES) or that 970 1.1 mrg # it should be included in the master .chm file (NO). 971 1.1 mrg 972 1.1 mrg GENERATE_CHI = NO 973 1.1 mrg 974 1.1 mrg # If the GENERATE_HTMLHELP tag is set to YES, the CHM_INDEX_ENCODING 975 1.1 mrg # is used to encode HtmlHelp index (hhk), content (hhc) and project file 976 1.1 mrg # content. 977 1.1 mrg 978 1.1 mrg CHM_INDEX_ENCODING = 979 1.1 mrg 980 1.1 mrg # If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag 981 1.1 mrg # controls whether a binary table of contents is generated (YES) or a 982 1.1 mrg # normal table of contents (NO) in the .chm file. 983 1.1 mrg 984 1.1 mrg BINARY_TOC = NO 985 1.1 mrg 986 1.1 mrg # The TOC_EXPAND flag can be set to YES to add extra items for group members 987 1.1 mrg # to the contents of the HTML help documentation and to the tree view. 988 1.1 mrg 989 1.1 mrg TOC_EXPAND = NO 990 1.1 mrg 991 1.1 mrg # If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and 992 1.1 mrg # QHP_VIRTUAL_FOLDER are set, an additional index file will be generated 993 1.1 mrg # that can be used as input for Qt's qhelpgenerator to generate a 994 1.1 mrg # Qt Compressed Help (.qch) of the generated HTML documentation. 995 1.1 mrg 996 1.1 mrg GENERATE_QHP = NO 997 1.1 mrg 998 1.1 mrg # If the QHG_LOCATION tag is specified, the QCH_FILE tag can 999 1.1 mrg # be used to specify the file name of the resulting .qch file. 1000 1.1 mrg # The path specified is relative to the HTML output folder. 1001 1.1 mrg 1002 1.1 mrg QCH_FILE = 1003 1.1 mrg 1004 1.1 mrg # The QHP_NAMESPACE tag specifies the namespace to use when generating 1005 1.1 mrg # Qt Help Project output. For more information please see 1006 1.1 mrg # http://doc.trolltech.com/qthelpproject.html#namespace 1007 1.1 mrg 1008 1.1 mrg QHP_NAMESPACE = org.doxygen.Project 1009 1.1 mrg 1010 1.1 mrg # The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating 1011 1.1 mrg # Qt Help Project output. For more information please see 1012 1.1 mrg # http://doc.trolltech.com/qthelpproject.html#virtual-folders 1013 1.1 mrg 1014 1.1 mrg QHP_VIRTUAL_FOLDER = doc 1015 1.1 mrg 1016 1.1 mrg # If QHP_CUST_FILTER_NAME is set, it specifies the name of a custom filter to 1017 1.1 mrg # add. For more information please see 1018 1.1 mrg # http://doc.trolltech.com/qthelpproject.html#custom-filters 1019 1.1 mrg 1020 1.1 mrg QHP_CUST_FILTER_NAME = 1021 1.1 mrg 1022 1.1 mrg # The QHP_CUST_FILT_ATTRS tag specifies the list of the attributes of the 1023 1.1 mrg # custom filter to add. For more information please see 1024 1.1 mrg # <a href="http://doc.trolltech.com/qthelpproject.html#custom-filters"> 1025 1.1 mrg # Qt Help Project / Custom Filters</a>. 1026 1.1 mrg 1027 1.1 mrg QHP_CUST_FILTER_ATTRS = 1028 1.1 mrg 1029 1.1 mrg # The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this 1030 1.1 mrg # project's 1031 1.1 mrg # filter section matches. 1032 1.1 mrg # <a href="http://doc.trolltech.com/qthelpproject.html#filter-attributes"> 1033 1.1 mrg # Qt Help Project / Filter Attributes</a>. 1034 1.1 mrg 1035 1.1 mrg QHP_SECT_FILTER_ATTRS = 1036 1.1 mrg 1037 1.1 mrg # If the GENERATE_QHP tag is set to YES, the QHG_LOCATION tag can 1038 1.1 mrg # be used to specify the location of Qt's qhelpgenerator. 1039 1.1 mrg # If non-empty doxygen will try to run qhelpgenerator on the generated 1040 1.1 mrg # .qhp file. 1041 1.1 mrg 1042 1.1 mrg QHG_LOCATION = 1043 1.1 mrg 1044 1.1 mrg # If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files 1045 1.1 mrg # will be generated, which together with the HTML files, form an Eclipse help 1046 1.1 mrg # plugin. To install this plugin and make it available under the help contents 1047 1.1 mrg # menu in Eclipse, the contents of the directory containing the HTML and XML 1048 1.1 mrg # files needs to be copied into the plugins directory of eclipse. The name of 1049 1.1 mrg # the directory within the plugins directory should be the same as 1050 1.1 mrg # the ECLIPSE_DOC_ID value. After copying Eclipse needs to be restarted before 1051 1.1 mrg # the help appears. 1052 1.1 mrg 1053 1.1 mrg GENERATE_ECLIPSEHELP = NO 1054 1.1 mrg 1055 1.1 mrg # A unique identifier for the eclipse help plugin. When installing the plugin 1056 1.1 mrg # the directory name containing the HTML and XML files should also have 1057 1.1 mrg # this name. 1058 1.1 mrg 1059 1.1 mrg ECLIPSE_DOC_ID = org.doxygen.Project 1060 1.1 mrg 1061 1.1 mrg # The DISABLE_INDEX tag can be used to turn on/off the condensed index at 1062 1.1 mrg # top of each HTML page. The value NO (the default) enables the index and 1063 1.1 mrg # the value YES disables it. 1064 1.1 mrg 1065 1.1 mrg DISABLE_INDEX = NO 1066 1.1 mrg 1067 1.1 mrg # The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values 1068 1.1 mrg # (range [0,1..20]) that doxygen will group on one line in the generated HTML 1069 1.1 mrg # documentation. Note that a value of 0 will completely suppress the enum 1070 1.1 mrg # values from appearing in the overview section. 1071 1.1 mrg 1072 1.1 mrg ENUM_VALUES_PER_LINE = 4 1073 1.1 mrg 1074 1.1 mrg # The GENERATE_TREEVIEW tag is used to specify whether a tree-like index 1075 1.1 mrg # structure should be generated to display hierarchical information. 1076 1.1 mrg # If the tag value is set to YES, a side panel will be generated 1077 1.1 mrg # containing a tree-like index structure (just like the one that 1078 1.1 mrg # is generated for HTML Help). For this to work a browser that supports 1079 1.1 mrg # JavaScript, DHTML, CSS and frames is required (i.e. any modern browser). 1080 1.1 mrg # Windows users are probably better off using the HTML help feature. 1081 1.1 mrg 1082 1.1 mrg GENERATE_TREEVIEW = NO 1083 1.1 mrg 1084 1.1 mrg # By enabling USE_INLINE_TREES, doxygen will generate the Groups, Directories, 1085 1.1 mrg # and Class Hierarchy pages using a tree view instead of an ordered list. 1086 1.1 mrg 1087 1.1 mrg USE_INLINE_TREES = NO 1088 1.1 mrg 1089 1.1 mrg # If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 1090 1.1 mrg # used to set the initial width (in pixels) of the frame in which the tree 1091 1.1 mrg # is shown. 1092 1.1 mrg 1093 1.1 mrg TREEVIEW_WIDTH = 250 1094 1.1 mrg 1095 1.1 mrg # When the EXT_LINKS_IN_WINDOW option is set to YES doxygen will open 1096 1.1 mrg # links to external symbols imported via tag files in a separate window. 1097 1.1 mrg 1098 1.1 mrg EXT_LINKS_IN_WINDOW = NO 1099 1.1 mrg 1100 1.1 mrg # Use this tag to change the font size of Latex formulas included 1101 1.1 mrg # as images in the HTML documentation. The default is 10. Note that 1102 1.1 mrg # when you change the font size after a successful doxygen run you need 1103 1.1 mrg # to manually remove any form_*.png images from the HTML output directory 1104 1.1 mrg # to force them to be regenerated. 1105 1.1 mrg 1106 1.1 mrg FORMULA_FONTSIZE = 10 1107 1.1 mrg 1108 1.1 mrg # Use the FORMULA_TRANPARENT tag to determine whether or not the images 1109 1.1 mrg # generated for formulas are transparent PNGs. Transparent PNGs are 1110 1.1 mrg # not supported properly for IE 6.0, but are supported on all modern browsers. 1111 1.1 mrg # Note that when changing this option you need to delete any form_*.png files 1112 1.1 mrg # in the HTML output before the changes have effect. 1113 1.1 mrg 1114 1.1 mrg FORMULA_TRANSPARENT = YES 1115 1.1 mrg 1116 1.1 mrg # Enable the USE_MATHJAX option to render LaTeX formulas using MathJax 1117 1.1 mrg # (see http://www.mathjax.org) which uses client side Javascript for the 1118 1.1 mrg # rendering instead of using prerendered bitmaps. Use this if you do not 1119 1.1 mrg # have LaTeX installed or if you want to formulas look prettier in the HTML 1120 1.1 mrg # output. When enabled you also need to install MathJax separately and 1121 1.1 mrg # configure the path to it using the MATHJAX_RELPATH option. 1122 1.1 mrg 1123 1.1 mrg USE_MATHJAX = NO 1124 1.1 mrg 1125 1.1 mrg # When MathJax is enabled you need to specify the location relative to the 1126 1.1 mrg # HTML output directory using the MATHJAX_RELPATH option. The destination 1127 1.1 mrg # directory should contain the MathJax.js script. For instance, if the mathjax 1128 1.1 mrg # directory is located at the same level as the HTML output directory, then 1129 1.1 mrg # MATHJAX_RELPATH should be ../mathjax. The default value points to the 1130 1.1 mrg # mathjax.org site, so you can quickly see the result without installing 1131 1.1 mrg # MathJax, but it is strongly recommended to install a local copy of MathJax 1132 1.1 mrg # before deployment. 1133 1.1 mrg 1134 1.1 mrg MATHJAX_RELPATH = http://www.mathjax.org/mathjax 1135 1.1 mrg 1136 1.1 mrg # When the SEARCHENGINE tag is enabled doxygen will generate a search box 1137 1.1 mrg # for the HTML output. The underlying search engine uses javascript 1138 1.1 mrg # and DHTML and should work on any modern browser. Note that when using 1139 1.1 mrg # HTML help (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets 1140 1.1 mrg # (GENERATE_DOCSET) there is already a search function so this one should 1141 1.1 mrg # typically be disabled. For large projects the javascript based search engine 1142 1.1 mrg # can be slow, then enabling SERVER_BASED_SEARCH may provide a better solution. 1143 1.1 mrg 1144 1.1 mrg SEARCHENGINE = YES 1145 1.1 mrg 1146 1.1 mrg # When the SERVER_BASED_SEARCH tag is enabled the search engine will be 1147 1.1 mrg # implemented using a PHP enabled web server instead of at the web client 1148 1.1 mrg # using Javascript. Doxygen will generate the search PHP script and index 1149 1.1 mrg # file to put on the web server. The advantage of the server 1150 1.1 mrg # based approach is that it scales better to large projects and allows 1151 1.1 mrg # full text search. The disadvantages are that it is more difficult to setup 1152 1.1 mrg # and does not have live searching capabilities. 1153 1.1 mrg 1154 1.1 mrg SERVER_BASED_SEARCH = NO 1155 1.1 mrg 1156 1.1 mrg #--------------------------------------------------------------------------- 1157 1.1 mrg # configuration options related to the LaTeX output 1158 1.1 mrg #--------------------------------------------------------------------------- 1159 1.1 mrg 1160 1.1 mrg # If the GENERATE_LATEX tag is set to YES (the default) Doxygen will 1161 1.1 mrg # generate Latex output. 1162 1.1 mrg 1163 1.1 mrg GENERATE_LATEX = YES 1164 1.1 mrg 1165 1.1 mrg # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. 1166 1.1 mrg # If a relative path is entered the value of OUTPUT_DIRECTORY will be 1167 1.1 mrg # put in front of it. If left blank `latex' will be used as the default path. 1168 1.1 mrg 1169 1.1 mrg LATEX_OUTPUT = latex 1170 1.1 mrg 1171 1.1 mrg # The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be 1172 1.1 mrg # invoked. If left blank `latex' will be used as the default command name. 1173 1.1 mrg # Note that when enabling USE_PDFLATEX this option is only used for 1174 1.1 mrg # generating bitmaps for formulas in the HTML output, but not in the 1175 1.1 mrg # Makefile that is written to the output directory. 1176 1.1 mrg 1177 1.1 mrg LATEX_CMD_NAME = latex 1178 1.1 mrg 1179 1.1 mrg # The MAKEINDEX_CMD_NAME tag can be used to specify the command name to 1180 1.1 mrg # generate index for LaTeX. If left blank `makeindex' will be used as the 1181 1.1 mrg # default command name. 1182 1.1 mrg 1183 1.1 mrg MAKEINDEX_CMD_NAME = makeindex 1184 1.1 mrg 1185 1.1 mrg # If the COMPACT_LATEX tag is set to YES Doxygen generates more compact 1186 1.1 mrg # LaTeX documents. This may be useful for small projects and may help to 1187 1.1 mrg # save some trees in general. 1188 1.1 mrg 1189 1.1 mrg COMPACT_LATEX = NO 1190 1.1 mrg 1191 1.1 mrg # The PAPER_TYPE tag can be used to set the paper type that is used 1192 1.1 mrg # by the printer. Possible values are: a4, letter, legal and 1193 1.1 mrg # executive. If left blank a4wide will be used. 1194 1.1 mrg 1195 1.1 mrg PAPER_TYPE = a4 1196 1.1 mrg 1197 1.1 mrg # The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX 1198 1.1 mrg # packages that should be included in the LaTeX output. 1199 1.1 mrg 1200 1.1 mrg EXTRA_PACKAGES = 1201 1.1 mrg 1202 1.1 mrg # The LATEX_HEADER tag can be used to specify a personal LaTeX header for 1203 1.1 mrg # the generated latex document. The header should contain everything until 1204 1.1 mrg # the first chapter. If it is left blank doxygen will generate a 1205 1.1 mrg # standard header. Notice: only use this tag if you know what you are doing! 1206 1.1 mrg 1207 1.1 mrg LATEX_HEADER = 1208 1.1 mrg 1209 1.1 mrg # The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for 1210 1.1 mrg # the generated latex document. The footer should contain everything after 1211 1.1 mrg # the last chapter. If it is left blank doxygen will generate a 1212 1.1 mrg # standard footer. Notice: only use this tag if you know what you are doing! 1213 1.1 mrg 1214 1.1 mrg LATEX_FOOTER = 1215 1.1 mrg 1216 1.1 mrg # If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated 1217 1.1 mrg # is prepared for conversion to pdf (using ps2pdf). The pdf file will 1218 1.1 mrg # contain links (just like the HTML output) instead of page references 1219 1.1 mrg # This makes the output suitable for online browsing using a pdf viewer. 1220 1.1 mrg 1221 1.1 mrg PDF_HYPERLINKS = YES 1222 1.1 mrg 1223 1.1 mrg # If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of 1224 1.1 mrg # plain latex in the generated Makefile. Set this option to YES to get a 1225 1.1 mrg # higher quality PDF documentation. 1226 1.1 mrg 1227 1.1 mrg USE_PDFLATEX = YES 1228 1.1 mrg 1229 1.1 mrg # If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. 1230 1.1 mrg # command to the generated LaTeX files. This will instruct LaTeX to keep 1231 1.1 mrg # running if errors occur, instead of asking the user for help. 1232 1.1 mrg # This option is also used when generating formulas in HTML. 1233 1.1 mrg 1234 1.1 mrg LATEX_BATCHMODE = NO 1235 1.1 mrg 1236 1.1 mrg # If LATEX_HIDE_INDICES is set to YES then doxygen will not 1237 1.1 mrg # include the index chapters (such as File Index, Compound Index, etc.) 1238 1.1 mrg # in the output. 1239 1.1 mrg 1240 1.1 mrg LATEX_HIDE_INDICES = NO 1241 1.1 mrg 1242 1.1 mrg # If LATEX_SOURCE_CODE is set to YES then doxygen will include 1243 1.1 mrg # source code with syntax highlighting in the LaTeX output. 1244 1.1 mrg # Note that which sources are shown also depends on other settings 1245 1.1 mrg # such as SOURCE_BROWSER. 1246 1.1 mrg 1247 1.1 mrg LATEX_SOURCE_CODE = NO 1248 1.1 mrg 1249 1.1 mrg #--------------------------------------------------------------------------- 1250 1.1 mrg # configuration options related to the RTF output 1251 1.1 mrg #--------------------------------------------------------------------------- 1252 1.1 mrg 1253 1.1 mrg # If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output 1254 1.1 mrg # The RTF output is optimized for Word 97 and may not look very pretty with 1255 1.1 mrg # other RTF readers or editors. 1256 1.1 mrg 1257 1.1 mrg GENERATE_RTF = NO 1258 1.1 mrg 1259 1.1 mrg # The RTF_OUTPUT tag is used to specify where the RTF docs will be put. 1260 1.1 mrg # If a relative path is entered the value of OUTPUT_DIRECTORY will be 1261 1.1 mrg # put in front of it. If left blank `rtf' will be used as the default path. 1262 1.1 mrg 1263 1.1 mrg RTF_OUTPUT = rtf 1264 1.1 mrg 1265 1.1 mrg # If the COMPACT_RTF tag is set to YES Doxygen generates more compact 1266 1.1 mrg # RTF documents. This may be useful for small projects and may help to 1267 1.1 mrg # save some trees in general. 1268 1.1 mrg 1269 1.1 mrg COMPACT_RTF = NO 1270 1.1 mrg 1271 1.1 mrg # If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated 1272 1.1 mrg # will contain hyperlink fields. The RTF file will 1273 1.1 mrg # contain links (just like the HTML output) instead of page references. 1274 1.1 mrg # This makes the output suitable for online browsing using WORD or other 1275 1.1 mrg # programs which support those fields. 1276 1.1 mrg # Note: wordpad (write) and others do not support links. 1277 1.1 mrg 1278 1.1 mrg RTF_HYPERLINKS = NO 1279 1.1 mrg 1280 1.1 mrg # Load stylesheet definitions from file. Syntax is similar to doxygen's 1281 1.1 mrg # config file, i.e. a series of assignments. You only have to provide 1282 1.1 mrg # replacements, missing definitions are set to their default value. 1283 1.1 mrg 1284 1.1 mrg RTF_STYLESHEET_FILE = 1285 1.1 mrg 1286 1.1 mrg # Set optional variables used in the generation of an rtf document. 1287 1.1 mrg # Syntax is similar to doxygen's config file. 1288 1.1 mrg 1289 1.1 mrg RTF_EXTENSIONS_FILE = 1290 1.1 mrg 1291 1.1 mrg #--------------------------------------------------------------------------- 1292 1.1 mrg # configuration options related to the man page output 1293 1.1 mrg #--------------------------------------------------------------------------- 1294 1.1 mrg 1295 1.1 mrg # If the GENERATE_MAN tag is set to YES (the default) Doxygen will 1296 1.1 mrg # generate man pages 1297 1.1 mrg 1298 1.1 mrg GENERATE_MAN = NO 1299 1.1 mrg 1300 1.1 mrg # The MAN_OUTPUT tag is used to specify where the man pages will be put. 1301 1.1 mrg # If a relative path is entered the value of OUTPUT_DIRECTORY will be 1302 1.1 mrg # put in front of it. If left blank `man' will be used as the default path. 1303 1.1 mrg 1304 1.1 mrg MAN_OUTPUT = man 1305 1.1 mrg 1306 1.1 mrg # The MAN_EXTENSION tag determines the extension that is added to 1307 1.1 mrg # the generated man pages (default is the subroutine's section .3) 1308 1.1 mrg 1309 1.1 mrg MAN_EXTENSION = .3 1310 1.1 mrg 1311 1.1 mrg # If the MAN_LINKS tag is set to YES and Doxygen generates man output, 1312 1.1 mrg # then it will generate one additional man file for each entity 1313 1.1 mrg # documented in the real man page(s). These additional files 1314 1.1 mrg # only source the real man page, but without them the man command 1315 1.1 mrg # would be unable to find the correct page. The default is NO. 1316 1.1 mrg 1317 1.1 mrg MAN_LINKS = NO 1318 1.1 mrg 1319 1.1 mrg #--------------------------------------------------------------------------- 1320 1.1 mrg # configuration options related to the XML output 1321 1.1 mrg #--------------------------------------------------------------------------- 1322 1.1 mrg 1323 1.1 mrg # If the GENERATE_XML tag is set to YES Doxygen will 1324 1.1 mrg # generate an XML file that captures the structure of 1325 1.1 mrg # the code including all documentation. 1326 1.1 mrg 1327 1.1 mrg GENERATE_XML = NO 1328 1.1 mrg 1329 1.1 mrg # The XML_OUTPUT tag is used to specify where the XML pages will be put. 1330 1.1 mrg # If a relative path is entered the value of OUTPUT_DIRECTORY will be 1331 1.1 mrg # put in front of it. If left blank `xml' will be used as the default path. 1332 1.1 mrg 1333 1.1 mrg XML_OUTPUT = xml 1334 1.1 mrg 1335 1.1 mrg # The XML_SCHEMA tag can be used to specify an XML schema, 1336 1.1 mrg # which can be used by a validating XML parser to check the 1337 1.1 mrg # syntax of the XML files. 1338 1.1 mrg 1339 1.1 mrg XML_SCHEMA = 1340 1.1 mrg 1341 1.1 mrg # The XML_DTD tag can be used to specify an XML DTD, 1342 1.1 mrg # which can be used by a validating XML parser to check the 1343 1.1 mrg # syntax of the XML files. 1344 1.1 mrg 1345 1.1 mrg XML_DTD = 1346 1.1 mrg 1347 1.1 mrg # If the XML_PROGRAMLISTING tag is set to YES Doxygen will 1348 1.1 mrg # dump the program listings (including syntax highlighting 1349 1.1 mrg # and cross-referencing information) to the XML output. Note that 1350 1.1 mrg # enabling this will significantly increase the size of the XML output. 1351 1.1 mrg 1352 1.1 mrg XML_PROGRAMLISTING = YES 1353 1.1 mrg 1354 1.1 mrg #--------------------------------------------------------------------------- 1355 1.1 mrg # configuration options for the AutoGen Definitions output 1356 1.1 mrg #--------------------------------------------------------------------------- 1357 1.1 mrg 1358 1.1 mrg # If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will 1359 1.1 mrg # generate an AutoGen Definitions (see autogen.sf.net) file 1360 1.1 mrg # that captures the structure of the code including all 1361 1.1 mrg # documentation. Note that this feature is still experimental 1362 1.1 mrg # and incomplete at the moment. 1363 1.1 mrg 1364 1.1 mrg GENERATE_AUTOGEN_DEF = NO 1365 1.1 mrg 1366 1.1 mrg #--------------------------------------------------------------------------- 1367 1.1 mrg # configuration options related to the Perl module output 1368 1.1 mrg #--------------------------------------------------------------------------- 1369 1.1 mrg 1370 1.1 mrg # If the GENERATE_PERLMOD tag is set to YES Doxygen will 1371 1.1 mrg # generate a Perl module file that captures the structure of 1372 1.1 mrg # the code including all documentation. Note that this 1373 1.1 mrg # feature is still experimental and incomplete at the 1374 1.1 mrg # moment. 1375 1.1 mrg 1376 1.1 mrg GENERATE_PERLMOD = NO 1377 1.1 mrg 1378 1.1 mrg # If the PERLMOD_LATEX tag is set to YES Doxygen will generate 1379 1.1 mrg # the necessary Makefile rules, Perl scripts and LaTeX code to be able 1380 1.1 mrg # to generate PDF and DVI output from the Perl module output. 1381 1.1 mrg 1382 1.1 mrg PERLMOD_LATEX = NO 1383 1.1 mrg 1384 1.1 mrg # If the PERLMOD_PRETTY tag is set to YES the Perl module output will be 1385 1.1 mrg # nicely formatted so it can be parsed by a human reader. 1386 1.1 mrg # This is useful 1387 1.1 mrg # if you want to understand what is going on. 1388 1.1 mrg # On the other hand, if this 1389 1.1 mrg # tag is set to NO the size of the Perl module output will be much smaller 1390 1.1 mrg # and Perl will parse it just the same. 1391 1.1 mrg 1392 1.1 mrg PERLMOD_PRETTY = YES 1393 1.1 mrg 1394 1.1 mrg # The names of the make variables in the generated doxyrules.make file 1395 1.1 mrg # are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. 1396 1.1 mrg # This is useful so different doxyrules.make files included by the same 1397 1.1 mrg # Makefile don't overwrite each other's variables. 1398 1.1 mrg 1399 1.1 mrg PERLMOD_MAKEVAR_PREFIX = 1400 1.1 mrg 1401 1.1 mrg #--------------------------------------------------------------------------- 1402 1.1 mrg # Configuration options related to the preprocessor 1403 1.1 mrg #--------------------------------------------------------------------------- 1404 1.1 mrg 1405 1.1 mrg # If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will 1406 1.1 mrg # evaluate all C-preprocessor directives found in the sources and include 1407 1.1 mrg # files. 1408 1.1 mrg 1409 1.1 mrg ENABLE_PREPROCESSING = YES 1410 1.1 mrg 1411 1.1 mrg # If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro 1412 1.1 mrg # names in the source code. If set to NO (the default) only conditional 1413 1.1 mrg # compilation will be performed. Macro expansion can be done in a controlled 1414 1.1 mrg # way by setting EXPAND_ONLY_PREDEF to YES. 1415 1.1 mrg 1416 1.1 mrg MACRO_EXPANSION = NO 1417 1.1 mrg 1418 1.1 mrg # If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES 1419 1.1 mrg # then the macro expansion is limited to the macros specified with the 1420 1.1 mrg # PREDEFINED and EXPAND_AS_DEFINED tags. 1421 1.1 mrg 1422 1.1 mrg EXPAND_ONLY_PREDEF = NO 1423 1.1 mrg 1424 1.1 mrg # If the SEARCH_INCLUDES tag is set to YES (the default) the includes files 1425 1.1 mrg # pointed to by INCLUDE_PATH will be searched when a #include is found. 1426 1.1 mrg 1427 1.1 mrg SEARCH_INCLUDES = YES 1428 1.1 mrg 1429 1.1 mrg # The INCLUDE_PATH tag can be used to specify one or more directories that 1430 1.1 mrg # contain include files that are not input files but should be processed by 1431 1.1 mrg # the preprocessor. 1432 1.1 mrg 1433 1.1 mrg INCLUDE_PATH = 1434 1.1 mrg 1435 1.1 mrg # You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard 1436 1.1 mrg # patterns (like *.h and *.hpp) to filter out the header-files in the 1437 1.1 mrg # directories. If left blank, the patterns specified with FILE_PATTERNS will 1438 1.1 mrg # be used. 1439 1.1 mrg 1440 1.1 mrg INCLUDE_FILE_PATTERNS = 1441 1.1 mrg 1442 1.1 mrg # The PREDEFINED tag can be used to specify one or more macro names that 1443 1.1 mrg # are defined before the preprocessor is started (similar to the -D option of 1444 1.1 mrg # gcc). The argument of the tag is a list of macros of the form: name 1445 1.1 mrg # or name=definition (no spaces). If the definition and the = are 1446 1.1 mrg # omitted =1 is assumed. To prevent a macro definition from being 1447 1.1 mrg # undefined via #undef or recursively expanded use the := operator 1448 1.1 mrg # instead of the = operator. 1449 1.1 mrg 1450 1.1 mrg PREDEFINED = 1451 1.1 mrg 1452 1.1 mrg # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then 1453 1.1 mrg # this tag can be used to specify a list of macro names that should be expanded. 1454 1.1 mrg # The macro definition that is found in the sources will be used. 1455 1.1 mrg # Use the PREDEFINED tag if you want to use a different macro definition that 1456 1.1 mrg # overrules the definition found in the source code. 1457 1.1 mrg 1458 1.1 mrg EXPAND_AS_DEFINED = 1459 1.1 mrg 1460 1.1 mrg # If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then 1461 1.1 mrg # doxygen's preprocessor will remove all references to function-like macros 1462 1.1 mrg # that are alone on a line, have an all uppercase name, and do not end with a 1463 1.1 mrg # semicolon, because these will confuse the parser if not removed. 1464 1.1 mrg 1465 1.1 mrg SKIP_FUNCTION_MACROS = YES 1466 1.1 mrg 1467 1.1 mrg #--------------------------------------------------------------------------- 1468 1.1 mrg # Configuration::additions related to external references 1469 1.1 mrg #--------------------------------------------------------------------------- 1470 1.1 mrg 1471 1.1 mrg # The TAGFILES option can be used to specify one or more tagfiles. 1472 1.1 mrg # Optionally an initial location of the external documentation 1473 1.1 mrg # can be added for each tagfile. The format of a tag file without 1474 1.1 mrg # this location is as follows: 1475 1.1 mrg # 1476 1.1 mrg # TAGFILES = file1 file2 ... 1477 1.1 mrg # Adding location for the tag files is done as follows: 1478 1.1 mrg # 1479 1.1 mrg # TAGFILES = file1=loc1 "file2 = loc2" ... 1480 1.1 mrg # where "loc1" and "loc2" can be relative or absolute paths or 1481 1.1 mrg # URLs. If a location is present for each tag, the installdox tool 1482 1.1 mrg # does not have to be run to correct the links. 1483 1.1 mrg # Note that each tag file must have a unique name 1484 1.1 mrg # (where the name does NOT include the path) 1485 1.1 mrg # If a tag file is not located in the directory in which doxygen 1486 1.1 mrg # is run, you must also specify the path to the tagfile here. 1487 1.1 mrg 1488 1.1 mrg TAGFILES = 1489 1.1 mrg 1490 1.1 mrg # When a file name is specified after GENERATE_TAGFILE, doxygen will create 1491 1.1 mrg # a tag file that is based on the input files it reads. 1492 1.1 mrg 1493 1.1 mrg GENERATE_TAGFILE = 1494 1.1 mrg 1495 1.1 mrg # If the ALLEXTERNALS tag is set to YES all external classes will be listed 1496 1.1 mrg # in the class index. If set to NO only the inherited external classes 1497 1.1 mrg # will be listed. 1498 1.1 mrg 1499 1.1 mrg ALLEXTERNALS = NO 1500 1.1 mrg 1501 1.1 mrg # If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed 1502 1.1 mrg # in the modules index. If set to NO, only the current project's groups will 1503 1.1 mrg # be listed. 1504 1.1 mrg 1505 1.1 mrg EXTERNAL_GROUPS = YES 1506 1.1 mrg 1507 1.1 mrg # The PERL_PATH should be the absolute path and name of the perl script 1508 1.1 mrg # interpreter (i.e. the result of `which perl'). 1509 1.1 mrg 1510 1.1 mrg PERL_PATH = /usr/bin/perl 1511 1.1 mrg 1512 1.1 mrg #--------------------------------------------------------------------------- 1513 1.1 mrg # Configuration options related to the dot tool 1514 1.1 mrg #--------------------------------------------------------------------------- 1515 1.1 mrg 1516 1.1 mrg # If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will 1517 1.1 mrg # generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base 1518 1.1 mrg # or super classes. Setting the tag to NO turns the diagrams off. Note that 1519 1.1 mrg # this option also works with HAVE_DOT disabled, but it is recommended to 1520 1.1 mrg # install and use dot, since it yields more powerful graphs. 1521 1.1 mrg 1522 1.1 mrg CLASS_DIAGRAMS = YES 1523 1.1 mrg 1524 1.1 mrg # You can define message sequence charts within doxygen comments using the \msc 1525 1.1 mrg # command. Doxygen will then run the mscgen tool (see 1526 1.1 mrg # http://www.mcternan.me.uk/mscgen/) to produce the chart and insert it in the 1527 1.1 mrg # documentation. The MSCGEN_PATH tag allows you to specify the directory where 1528 1.1 mrg # the mscgen tool resides. If left empty the tool is assumed to be found in the 1529 1.1 mrg # default search path. 1530 1.1 mrg 1531 1.1 mrg MSCGEN_PATH = 1532 1.1 mrg 1533 1.1 mrg # If set to YES, the inheritance and collaboration graphs will hide 1534 1.1 mrg # inheritance and usage relations if the target is undocumented 1535 1.1 mrg # or is not a class. 1536 1.1 mrg 1537 1.1 mrg HIDE_UNDOC_RELATIONS = YES 1538 1.1 mrg 1539 1.1 mrg # If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is 1540 1.1 mrg # available from the path. This tool is part of Graphviz, a graph visualization 1541 1.1 mrg # toolkit from AT&T and Lucent Bell Labs. The other options in this section 1542 1.1 mrg # have no effect if this option is set to NO (the default) 1543 1.1 mrg 1544 1.1 mrg HAVE_DOT = NO 1545 1.1 mrg 1546 1.1 mrg # The DOT_NUM_THREADS specifies the number of dot invocations doxygen is 1547 1.1 mrg # allowed to run in parallel. When set to 0 (the default) doxygen will 1548 1.1 mrg # base this on the number of processors available in the system. You can set it 1549 1.1 mrg # explicitly to a value larger than 0 to get control over the balance 1550 1.1 mrg # between CPU load and processing speed. 1551 1.1 mrg 1552 1.1 mrg DOT_NUM_THREADS = 0 1553 1.1 mrg 1554 1.1 mrg # By default doxygen will write a font called Helvetica to the output 1555 1.1 mrg # directory and reference it in all dot files that doxygen generates. 1556 1.1 mrg # When you want a differently looking font you can specify the font name 1557 1.1 mrg # using DOT_FONTNAME. You need to make sure dot is able to find the font, 1558 1.1 mrg # which can be done by putting it in a standard location or by setting the 1559 1.1 mrg # DOTFONTPATH environment variable or by setting DOT_FONTPATH to the directory 1560 1.1 mrg # containing the font. 1561 1.1 mrg 1562 1.1 mrg DOT_FONTNAME = Helvetica 1563 1.1 mrg 1564 1.1 mrg # The DOT_FONTSIZE tag can be used to set the size of the font of dot graphs. 1565 1.1 mrg # The default size is 10pt. 1566 1.1 mrg 1567 1.1 mrg DOT_FONTSIZE = 10 1568 1.1 mrg 1569 1.1 mrg # By default doxygen will tell dot to use the output directory to look for the 1570 1.1 mrg # FreeSans.ttf font (which doxygen will put there itself). If you specify a 1571 1.1 mrg # different font using DOT_FONTNAME you can set the path where dot 1572 1.1 mrg # can find it using this tag. 1573 1.1 mrg 1574 1.1 mrg DOT_FONTPATH = 1575 1.1 mrg 1576 1.1 mrg # If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen 1577 1.1 mrg # will generate a graph for each documented class showing the direct and 1578 1.1 mrg # indirect inheritance relations. Setting this tag to YES will force the 1579 1.1 mrg # the CLASS_DIAGRAMS tag to NO. 1580 1.1 mrg 1581 1.1 mrg CLASS_GRAPH = YES 1582 1.1 mrg 1583 1.1 mrg # If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen 1584 1.1 mrg # will generate a graph for each documented class showing the direct and 1585 1.1 mrg # indirect implementation dependencies (inheritance, containment, and 1586 1.1 mrg # class references variables) of the class with other documented classes. 1587 1.1 mrg 1588 1.1 mrg COLLABORATION_GRAPH = YES 1589 1.1 mrg 1590 1.1 mrg # If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen 1591 1.1 mrg # will generate a graph for groups, showing the direct groups dependencies 1592 1.1 mrg 1593 1.1 mrg GROUP_GRAPHS = YES 1594 1.1 mrg 1595 1.1 mrg # If the UML_LOOK tag is set to YES doxygen will generate inheritance and 1596 1.1 mrg # collaboration diagrams in a style similar to the OMG's Unified Modeling 1597 1.1 mrg # Language. 1598 1.1 mrg 1599 1.1 mrg UML_LOOK = NO 1600 1.1 mrg 1601 1.1 mrg # If set to YES, the inheritance and collaboration graphs will show the 1602 1.1 mrg # relations between templates and their instances. 1603 1.1 mrg 1604 1.1 mrg TEMPLATE_RELATIONS = NO 1605 1.1 mrg 1606 1.1 mrg # If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT 1607 1.1 mrg # tags are set to YES then doxygen will generate a graph for each documented 1608 1.1 mrg # file showing the direct and indirect include dependencies of the file with 1609 1.1 mrg # other documented files. 1610 1.1 mrg 1611 1.1 mrg INCLUDE_GRAPH = YES 1612 1.1 mrg 1613 1.1 mrg # If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and 1614 1.1 mrg # HAVE_DOT tags are set to YES then doxygen will generate a graph for each 1615 1.1 mrg # documented header file showing the documented files that directly or 1616 1.1 mrg # indirectly include this file. 1617 1.1 mrg 1618 1.1 mrg INCLUDED_BY_GRAPH = YES 1619 1.1 mrg 1620 1.1 mrg # If the CALL_GRAPH and HAVE_DOT options are set to YES then 1621 1.1 mrg # doxygen will generate a call dependency graph for every global function 1622 1.1 mrg # or class method. Note that enabling this option will significantly increase 1623 1.1 mrg # the time of a run. So in most cases it will be better to enable call graphs 1624 1.1 mrg # for selected functions only using the \callgraph command. 1625 1.1 mrg 1626 1.1 mrg CALL_GRAPH = NO 1627 1.1 mrg 1628 1.1 mrg # If the CALLER_GRAPH and HAVE_DOT tags are set to YES then 1629 1.1 mrg # doxygen will generate a caller dependency graph for every global function 1630 1.1 mrg # or class method. Note that enabling this option will significantly increase 1631 1.1 mrg # the time of a run. So in most cases it will be better to enable caller 1632 1.1 mrg # graphs for selected functions only using the \callergraph command. 1633 1.1 mrg 1634 1.1 mrg CALLER_GRAPH = NO 1635 1.1 mrg 1636 1.1 mrg # If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen 1637 1.1 mrg # will generate a graphical hierarchy of all classes instead of a textual one. 1638 1.1 mrg 1639 1.1 mrg GRAPHICAL_HIERARCHY = YES 1640 1.1 mrg 1641 1.1 mrg # If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES 1642 1.1 mrg # then doxygen will show the dependencies a directory has on other directories 1643 1.1 mrg # in a graphical way. The dependency relations are determined by the #include 1644 1.1 mrg # relations between the files in the directories. 1645 1.1 mrg 1646 1.1 mrg DIRECTORY_GRAPH = YES 1647 1.1 mrg 1648 1.1 mrg # The DOT_IMAGE_FORMAT tag can be used to set the image format of the images 1649 1.1 mrg # generated by dot. Possible values are svg, png, jpg, or gif. 1650 1.1 mrg # If left blank png will be used. 1651 1.1 mrg 1652 1.1 mrg DOT_IMAGE_FORMAT = png 1653 1.1 mrg 1654 1.1 mrg # The tag DOT_PATH can be used to specify the path where the dot tool can be 1655 1.1 mrg # found. If left blank, it is assumed the dot tool can be found in the path. 1656 1.1 mrg 1657 1.1 mrg DOT_PATH = 1658 1.1 mrg 1659 1.1 mrg # The DOTFILE_DIRS tag can be used to specify one or more directories that 1660 1.1 mrg # contain dot files that are included in the documentation (see the 1661 1.1 mrg # \dotfile command). 1662 1.1 mrg 1663 1.1 mrg DOTFILE_DIRS = 1664 1.1 mrg 1665 1.1 mrg # The MSCFILE_DIRS tag can be used to specify one or more directories that 1666 1.1 mrg # contain msc files that are included in the documentation (see the 1667 1.1 mrg # \mscfile command). 1668 1.1 mrg 1669 1.1 mrg MSCFILE_DIRS = 1670 1.1 mrg 1671 1.1 mrg # The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of 1672 1.1 mrg # nodes that will be shown in the graph. If the number of nodes in a graph 1673 1.1 mrg # becomes larger than this value, doxygen will truncate the graph, which is 1674 1.1 mrg # visualized by representing a node as a red box. Note that doxygen if the 1675 1.1 mrg # number of direct children of the root node in a graph is already larger than 1676 1.1 mrg # DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note 1677 1.1 mrg # that the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH. 1678 1.1 mrg 1679 1.1 mrg DOT_GRAPH_MAX_NODES = 50 1680 1.1 mrg 1681 1.1 mrg # The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the 1682 1.1 mrg # graphs generated by dot. A depth value of 3 means that only nodes reachable 1683 1.1 mrg # from the root by following a path via at most 3 edges will be shown. Nodes 1684 1.1 mrg # that lay further from the root node will be omitted. Note that setting this 1685 1.1 mrg # option to 1 or 2 may greatly reduce the computation time needed for large 1686 1.1 mrg # code bases. Also note that the size of a graph can be further restricted by 1687 1.1 mrg # DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction. 1688 1.1 mrg 1689 1.1 mrg MAX_DOT_GRAPH_DEPTH = 0 1690 1.1 mrg 1691 1.1 mrg # Set the DOT_TRANSPARENT tag to YES to generate images with a transparent 1692 1.1 mrg # background. This is disabled by default, because dot on Windows does not 1693 1.1 mrg # seem to support this out of the box. Warning: Depending on the platform used, 1694 1.1 mrg # enabling this option may lead to badly anti-aliased labels on the edges of 1695 1.1 mrg # a graph (i.e. they become hard to read). 1696 1.1 mrg 1697 1.1 mrg DOT_TRANSPARENT = NO 1698 1.1 mrg 1699 1.1 mrg # Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output 1700 1.1 mrg # files in one run (i.e. multiple -o and -T options on the command line). This 1701 1.1 mrg # makes dot run faster, but since only newer versions of dot (>1.8.10) 1702 1.1 mrg # support this, this feature is disabled by default. 1703 1.1 mrg 1704 1.1 mrg DOT_MULTI_TARGETS = NO 1705 1.1 mrg 1706 1.1 mrg # If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will 1707 1.1 mrg # generate a legend page explaining the meaning of the various boxes and 1708 1.1 mrg # arrows in the dot generated graphs. 1709 1.1 mrg 1710 1.1 mrg GENERATE_LEGEND = YES 1711 1.1 mrg 1712 1.1 mrg # If the DOT_CLEANUP tag is set to YES (the default) Doxygen will 1713 1.1 mrg # remove the intermediate dot files that are used to generate 1714 1.1 mrg # the various graphs. 1715 1.1 mrg 1716 1.1 mrg DOT_CLEANUP = YES 1717