annotate constant-q-cpp/Doxyfile @ 372:af71cbdab621 tip

Update bqvec code
author Chris Cannam
date Tue, 19 Nov 2019 10:13:32 +0000
parents 5d0a2ebb4d17
children
rev   line source
Chris@366 1 # Doxyfile 1.8.7
Chris@366 2
Chris@366 3 # This file describes the settings to be used by the documentation system
Chris@366 4 # doxygen (www.doxygen.org) for a project.
Chris@366 5 #
Chris@366 6 # All text after a double hash (##) is considered a comment and is placed in
Chris@366 7 # front of the TAG it is preceding.
Chris@366 8 #
Chris@366 9 # All text after a single hash (#) is considered a comment and will be ignored.
Chris@366 10 # The format is:
Chris@366 11 # TAG = value [value, ...]
Chris@366 12 # For lists, items can also be appended using:
Chris@366 13 # TAG += value [value, ...]
Chris@366 14 # Values that contain spaces should be placed between quotes (\" \").
Chris@366 15
Chris@366 16 #---------------------------------------------------------------------------
Chris@366 17 # Project related configuration options
Chris@366 18 #---------------------------------------------------------------------------
Chris@366 19
Chris@366 20 # This tag specifies the encoding used for all characters in the config file
Chris@366 21 # that follow. The default is UTF-8 which is also the encoding used for all text
Chris@366 22 # before the first occurrence of this tag. Doxygen uses libiconv (or the iconv
Chris@366 23 # built into libc) for the transcoding. See http://www.gnu.org/software/libiconv
Chris@366 24 # for the list of possible encodings.
Chris@366 25 # The default value is: UTF-8.
Chris@366 26
Chris@366 27 DOXYFILE_ENCODING = UTF-8
Chris@366 28
Chris@366 29 # The PROJECT_NAME tag is a single word (or a sequence of words surrounded by
Chris@366 30 # double-quotes, unless you are using Doxywizard) that should identify the
Chris@366 31 # project for which the documentation is generated. This name is used in the
Chris@366 32 # title of most generated pages and in a few other places.
Chris@366 33 # The default value is: My Project.
Chris@366 34
Chris@366 35 PROJECT_NAME = "Constant-Q Library"
Chris@366 36
Chris@366 37 # The PROJECT_NUMBER tag can be used to enter a project or revision number. This
Chris@366 38 # could be handy for archiving the generated documentation or if some version
Chris@366 39 # control system is used.
Chris@366 40
Chris@366 41 PROJECT_NUMBER =
Chris@366 42
Chris@366 43 # Using the PROJECT_BRIEF tag one can provide an optional one line description
Chris@366 44 # for a project that appears at the top of each page and should give viewer a
Chris@366 45 # quick idea about the purpose of the project. Keep the description short.
Chris@366 46
Chris@366 47 PROJECT_BRIEF =
Chris@366 48
Chris@366 49 # With the PROJECT_LOGO tag one can specify an logo or icon that is included in
Chris@366 50 # the documentation. The maximum height of the logo should not exceed 55 pixels
Chris@366 51 # and the maximum width should not exceed 200 pixels. Doxygen will copy the logo
Chris@366 52 # to the output directory.
Chris@366 53
Chris@366 54 PROJECT_LOGO =
Chris@366 55
Chris@366 56 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
Chris@366 57 # into which the generated documentation will be written. If a relative path is
Chris@366 58 # entered, it will be relative to the location where doxygen was started. If
Chris@366 59 # left blank the current directory will be used.
Chris@366 60
Chris@366 61 OUTPUT_DIRECTORY = doc
Chris@366 62
Chris@366 63 # If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 4096 sub-
Chris@366 64 # directories (in 2 levels) under the output directory of each output format and
Chris@366 65 # will distribute the generated files over these directories. Enabling this
Chris@366 66 # option can be useful when feeding doxygen a huge amount of source files, where
Chris@366 67 # putting all generated files in the same directory would otherwise causes
Chris@366 68 # performance problems for the file system.
Chris@366 69 # The default value is: NO.
Chris@366 70
Chris@366 71 CREATE_SUBDIRS = NO
Chris@366 72
Chris@366 73 # If the ALLOW_UNICODE_NAMES tag is set to YES, doxygen will allow non-ASCII
Chris@366 74 # characters to appear in the names of generated files. If set to NO, non-ASCII
Chris@366 75 # characters will be escaped, for example _xE3_x81_x84 will be used for Unicode
Chris@366 76 # U+3044.
Chris@366 77 # The default value is: NO.
Chris@366 78
Chris@366 79 ALLOW_UNICODE_NAMES = NO
Chris@366 80
Chris@366 81 # The OUTPUT_LANGUAGE tag is used to specify the language in which all
Chris@366 82 # documentation generated by doxygen is written. Doxygen will use this
Chris@366 83 # information to generate all constant output in the proper language.
Chris@366 84 # Possible values are: Afrikaans, Arabic, Armenian, Brazilian, Catalan, Chinese,
Chris@366 85 # Chinese-Traditional, Croatian, Czech, Danish, Dutch, English (United States),
Chris@366 86 # Esperanto, Farsi (Persian), Finnish, French, German, Greek, Hungarian,
Chris@366 87 # Indonesian, Italian, Japanese, Japanese-en (Japanese with English messages),
Chris@366 88 # Korean, Korean-en (Korean with English messages), Latvian, Lithuanian,
Chris@366 89 # Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese, Romanian, Russian,
Chris@366 90 # Serbian, Serbian-Cyrillic, Slovak, Slovene, Spanish, Swedish, Turkish,
Chris@366 91 # Ukrainian and Vietnamese.
Chris@366 92 # The default value is: English.
Chris@366 93
Chris@366 94 OUTPUT_LANGUAGE = English
Chris@366 95
Chris@366 96 # If the BRIEF_MEMBER_DESC tag is set to YES doxygen will include brief member
Chris@366 97 # descriptions after the members that are listed in the file and class
Chris@366 98 # documentation (similar to Javadoc). Set to NO to disable this.
Chris@366 99 # The default value is: YES.
Chris@366 100
Chris@366 101 BRIEF_MEMBER_DESC = YES
Chris@366 102
Chris@366 103 # If the REPEAT_BRIEF tag is set to YES doxygen will prepend the brief
Chris@366 104 # description of a member or function before the detailed description
Chris@366 105 #
Chris@366 106 # Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
Chris@366 107 # brief descriptions will be completely suppressed.
Chris@366 108 # The default value is: YES.
Chris@366 109
Chris@366 110 REPEAT_BRIEF = YES
Chris@366 111
Chris@366 112 # This tag implements a quasi-intelligent brief description abbreviator that is
Chris@366 113 # used to form the text in various listings. Each string in this list, if found
Chris@366 114 # as the leading text of the brief description, will be stripped from the text
Chris@366 115 # and the result, after processing the whole list, is used as the annotated
Chris@366 116 # text. Otherwise, the brief description is used as-is. If left blank, the
Chris@366 117 # following values are used ($name is automatically replaced with the name of
Chris@366 118 # the entity):The $name class, The $name widget, The $name file, is, provides,
Chris@366 119 # specifies, contains, represents, a, an and the.
Chris@366 120
Chris@366 121 ABBREVIATE_BRIEF =
Chris@366 122
Chris@366 123 # If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
Chris@366 124 # doxygen will generate a detailed section even if there is only a brief
Chris@366 125 # description.
Chris@366 126 # The default value is: NO.
Chris@366 127
Chris@366 128 ALWAYS_DETAILED_SEC = NO
Chris@366 129
Chris@366 130 # If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
Chris@366 131 # inherited members of a class in the documentation of that class as if those
Chris@366 132 # members were ordinary class members. Constructors, destructors and assignment
Chris@366 133 # operators of the base classes will not be shown.
Chris@366 134 # The default value is: NO.
Chris@366 135
Chris@366 136 INLINE_INHERITED_MEMB = NO
Chris@366 137
Chris@366 138 # If the FULL_PATH_NAMES tag is set to YES doxygen will prepend the full path
Chris@366 139 # before files name in the file list and in the header files. If set to NO the
Chris@366 140 # shortest path that makes the file name unique will be used
Chris@366 141 # The default value is: YES.
Chris@366 142
Chris@366 143 FULL_PATH_NAMES = YES
Chris@366 144
Chris@366 145 # The STRIP_FROM_PATH tag can be used to strip a user-defined part of the path.
Chris@366 146 # Stripping is only done if one of the specified strings matches the left-hand
Chris@366 147 # part of the path. The tag can be used to show relative paths in the file list.
Chris@366 148 # If left blank the directory from which doxygen is run is used as the path to
Chris@366 149 # strip.
Chris@366 150 #
Chris@366 151 # Note that you can specify absolute paths here, but also relative paths, which
Chris@366 152 # will be relative from the directory where doxygen is started.
Chris@366 153 # This tag requires that the tag FULL_PATH_NAMES is set to YES.
Chris@366 154
Chris@366 155 STRIP_FROM_PATH =
Chris@366 156
Chris@366 157 # The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of the
Chris@366 158 # path mentioned in the documentation of a class, which tells the reader which
Chris@366 159 # header file to include in order to use a class. If left blank only the name of
Chris@366 160 # the header file containing the class definition is used. Otherwise one should
Chris@366 161 # specify the list of include paths that are normally passed to the compiler
Chris@366 162 # using the -I flag.
Chris@366 163
Chris@366 164 STRIP_FROM_INC_PATH =
Chris@366 165
Chris@366 166 # If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but
Chris@366 167 # less readable) file names. This can be useful is your file systems doesn't
Chris@366 168 # support long names like on DOS, Mac, or CD-ROM.
Chris@366 169 # The default value is: NO.
Chris@366 170
Chris@366 171 SHORT_NAMES = NO
Chris@366 172
Chris@366 173 # If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the
Chris@366 174 # first line (until the first dot) of a Javadoc-style comment as the brief
Chris@366 175 # description. If set to NO, the Javadoc-style will behave just like regular Qt-
Chris@366 176 # style comments (thus requiring an explicit @brief command for a brief
Chris@366 177 # description.)
Chris@366 178 # The default value is: NO.
Chris@366 179
Chris@366 180 JAVADOC_AUTOBRIEF = NO
Chris@366 181
Chris@366 182 # If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
Chris@366 183 # line (until the first dot) of a Qt-style comment as the brief description. If
Chris@366 184 # set to NO, the Qt-style will behave just like regular Qt-style comments (thus
Chris@366 185 # requiring an explicit \brief command for a brief description.)
Chris@366 186 # The default value is: NO.
Chris@366 187
Chris@366 188 QT_AUTOBRIEF = NO
Chris@366 189
Chris@366 190 # The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a
Chris@366 191 # multi-line C++ special comment block (i.e. a block of //! or /// comments) as
Chris@366 192 # a brief description. This used to be the default behavior. The new default is
Chris@366 193 # to treat a multi-line C++ comment block as a detailed description. Set this
Chris@366 194 # tag to YES if you prefer the old behavior instead.
Chris@366 195 #
Chris@366 196 # Note that setting this tag to YES also means that rational rose comments are
Chris@366 197 # not recognized any more.
Chris@366 198 # The default value is: NO.
Chris@366 199
Chris@366 200 MULTILINE_CPP_IS_BRIEF = NO
Chris@366 201
Chris@366 202 # If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the
Chris@366 203 # documentation from any documented member that it re-implements.
Chris@366 204 # The default value is: YES.
Chris@366 205
Chris@366 206 INHERIT_DOCS = YES
Chris@366 207
Chris@366 208 # If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce a
Chris@366 209 # new page for each member. If set to NO, the documentation of a member will be
Chris@366 210 # part of the file/class/namespace that contains it.
Chris@366 211 # The default value is: NO.
Chris@366 212
Chris@366 213 SEPARATE_MEMBER_PAGES = NO
Chris@366 214
Chris@366 215 # The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen
Chris@366 216 # uses this value to replace tabs by spaces in code fragments.
Chris@366 217 # Minimum value: 1, maximum value: 16, default value: 4.
Chris@366 218
Chris@366 219 TAB_SIZE = 4
Chris@366 220
Chris@366 221 # This tag can be used to specify a number of aliases that act as commands in
Chris@366 222 # the documentation. An alias has the form:
Chris@366 223 # name=value
Chris@366 224 # For example adding
Chris@366 225 # "sideeffect=@par Side Effects:\n"
Chris@366 226 # will allow you to put the command \sideeffect (or @sideeffect) in the
Chris@366 227 # documentation, which will result in a user-defined paragraph with heading
Chris@366 228 # "Side Effects:". You can put \n's in the value part of an alias to insert
Chris@366 229 # newlines.
Chris@366 230
Chris@366 231 ALIASES =
Chris@366 232
Chris@366 233 # This tag can be used to specify a number of word-keyword mappings (TCL only).
Chris@366 234 # A mapping has the form "name=value". For example adding "class=itcl::class"
Chris@366 235 # will allow you to use the command class in the itcl::class meaning.
Chris@366 236
Chris@366 237 TCL_SUBST =
Chris@366 238
Chris@366 239 # Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources
Chris@366 240 # only. Doxygen will then generate output that is more tailored for C. For
Chris@366 241 # instance, some of the names that are used will be different. The list of all
Chris@366 242 # members will be omitted, etc.
Chris@366 243 # The default value is: NO.
Chris@366 244
Chris@366 245 OPTIMIZE_OUTPUT_FOR_C = NO
Chris@366 246
Chris@366 247 # Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java or
Chris@366 248 # Python sources only. Doxygen will then generate output that is more tailored
Chris@366 249 # for that language. For instance, namespaces will be presented as packages,
Chris@366 250 # qualified scopes will look different, etc.
Chris@366 251 # The default value is: NO.
Chris@366 252
Chris@366 253 OPTIMIZE_OUTPUT_JAVA = NO
Chris@366 254
Chris@366 255 # Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
Chris@366 256 # sources. Doxygen will then generate output that is tailored for Fortran.
Chris@366 257 # The default value is: NO.
Chris@366 258
Chris@366 259 OPTIMIZE_FOR_FORTRAN = NO
Chris@366 260
Chris@366 261 # Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
Chris@366 262 # sources. Doxygen will then generate output that is tailored for VHDL.
Chris@366 263 # The default value is: NO.
Chris@366 264
Chris@366 265 OPTIMIZE_OUTPUT_VHDL = NO
Chris@366 266
Chris@366 267 # Doxygen selects the parser to use depending on the extension of the files it
Chris@366 268 # parses. With this tag you can assign which parser to use for a given
Chris@366 269 # extension. Doxygen has a built-in mapping, but you can override or extend it
Chris@366 270 # using this tag. The format is ext=language, where ext is a file extension, and
Chris@366 271 # language is one of the parsers supported by doxygen: IDL, Java, Javascript,
Chris@366 272 # C#, C, C++, D, PHP, Objective-C, Python, Fortran (fixed format Fortran:
Chris@366 273 # FortranFixed, free formatted Fortran: FortranFree, unknown formatted Fortran:
Chris@366 274 # Fortran. In the later case the parser tries to guess whether the code is fixed
Chris@366 275 # or free formatted code, this is the default for Fortran type files), VHDL. For
Chris@366 276 # instance to make doxygen treat .inc files as Fortran files (default is PHP),
Chris@366 277 # and .f files as C (default is Fortran), use: inc=Fortran f=C.
Chris@366 278 #
Chris@366 279 # Note For files without extension you can use no_extension as a placeholder.
Chris@366 280 #
Chris@366 281 # Note that for custom extensions you also need to set FILE_PATTERNS otherwise
Chris@366 282 # the files are not read by doxygen.
Chris@366 283
Chris@366 284 EXTENSION_MAPPING =
Chris@366 285
Chris@366 286 # If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments
Chris@366 287 # according to the Markdown format, which allows for more readable
Chris@366 288 # documentation. See http://daringfireball.net/projects/markdown/ for details.
Chris@366 289 # The output of markdown processing is further processed by doxygen, so you can
Chris@366 290 # mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in
Chris@366 291 # case of backward compatibilities issues.
Chris@366 292 # The default value is: YES.
Chris@366 293
Chris@366 294 MARKDOWN_SUPPORT = YES
Chris@366 295
Chris@366 296 # When enabled doxygen tries to link words that correspond to documented
Chris@366 297 # classes, or namespaces to their corresponding documentation. Such a link can
Chris@366 298 # be prevented in individual cases by by putting a % sign in front of the word
Chris@366 299 # or globally by setting AUTOLINK_SUPPORT to NO.
Chris@366 300 # The default value is: YES.
Chris@366 301
Chris@366 302 AUTOLINK_SUPPORT = YES
Chris@366 303
Chris@366 304 # If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
Chris@366 305 # to include (a tag file for) the STL sources as input, then you should set this
Chris@366 306 # tag to YES in order to let doxygen match functions declarations and
Chris@366 307 # definitions whose arguments contain STL classes (e.g. func(std::string);
Chris@366 308 # versus func(std::string) {}). This also make the inheritance and collaboration
Chris@366 309 # diagrams that involve STL classes more complete and accurate.
Chris@366 310 # The default value is: NO.
Chris@366 311
Chris@366 312 BUILTIN_STL_SUPPORT = NO
Chris@366 313
Chris@366 314 # If you use Microsoft's C++/CLI language, you should set this option to YES to
Chris@366 315 # enable parsing support.
Chris@366 316 # The default value is: NO.
Chris@366 317
Chris@366 318 CPP_CLI_SUPPORT = NO
Chris@366 319
Chris@366 320 # Set the SIP_SUPPORT tag to YES if your project consists of sip (see:
Chris@366 321 # http://www.riverbankcomputing.co.uk/software/sip/intro) sources only. Doxygen
Chris@366 322 # will parse them like normal C++ but will assume all classes use public instead
Chris@366 323 # of private inheritance when no explicit protection keyword is present.
Chris@366 324 # The default value is: NO.
Chris@366 325
Chris@366 326 SIP_SUPPORT = NO
Chris@366 327
Chris@366 328 # For Microsoft's IDL there are propget and propput attributes to indicate
Chris@366 329 # getter and setter methods for a property. Setting this option to YES will make
Chris@366 330 # doxygen to replace the get and set methods by a property in the documentation.
Chris@366 331 # This will only work if the methods are indeed getting or setting a simple
Chris@366 332 # type. If this is not the case, or you want to show the methods anyway, you
Chris@366 333 # should set this option to NO.
Chris@366 334 # The default value is: YES.
Chris@366 335
Chris@366 336 IDL_PROPERTY_SUPPORT = YES
Chris@366 337
Chris@366 338 # If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
Chris@366 339 # tag is set to YES, then doxygen will reuse the documentation of the first
Chris@366 340 # member in the group (if any) for the other members of the group. By default
Chris@366 341 # all members of a group must be documented explicitly.
Chris@366 342 # The default value is: NO.
Chris@366 343
Chris@366 344 DISTRIBUTE_GROUP_DOC = NO
Chris@366 345
Chris@366 346 # Set the SUBGROUPING tag to YES to allow class member groups of the same type
Chris@366 347 # (for instance a group of public functions) to be put as a subgroup of that
Chris@366 348 # type (e.g. under the Public Functions section). Set it to NO to prevent
Chris@366 349 # subgrouping. Alternatively, this can be done per class using the
Chris@366 350 # \nosubgrouping command.
Chris@366 351 # The default value is: YES.
Chris@366 352
Chris@366 353 SUBGROUPING = YES
Chris@366 354
Chris@366 355 # When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and unions
Chris@366 356 # are shown inside the group in which they are included (e.g. using \ingroup)
Chris@366 357 # instead of on a separate page (for HTML and Man pages) or section (for LaTeX
Chris@366 358 # and RTF).
Chris@366 359 #
Chris@366 360 # Note that this feature does not work in combination with
Chris@366 361 # SEPARATE_MEMBER_PAGES.
Chris@366 362 # The default value is: NO.
Chris@366 363
Chris@366 364 INLINE_GROUPED_CLASSES = NO
Chris@366 365
Chris@366 366 # When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions
Chris@366 367 # with only public data fields or simple typedef fields will be shown inline in
Chris@366 368 # the documentation of the scope in which they are defined (i.e. file,
Chris@366 369 # namespace, or group documentation), provided this scope is documented. If set
Chris@366 370 # to NO, structs, classes, and unions are shown on a separate page (for HTML and
Chris@366 371 # Man pages) or section (for LaTeX and RTF).
Chris@366 372 # The default value is: NO.
Chris@366 373
Chris@366 374 INLINE_SIMPLE_STRUCTS = NO
Chris@366 375
Chris@366 376 # When TYPEDEF_HIDES_STRUCT tag is enabled, a typedef of a struct, union, or
Chris@366 377 # enum is documented as struct, union, or enum with the name of the typedef. So
Chris@366 378 # typedef struct TypeS {} TypeT, will appear in the documentation as a struct
Chris@366 379 # with name TypeT. When disabled the typedef will appear as a member of a file,
Chris@366 380 # namespace, or class. And the struct will be named TypeS. This can typically be
Chris@366 381 # useful for C code in case the coding convention dictates that all compound
Chris@366 382 # types are typedef'ed and only the typedef is referenced, never the tag name.
Chris@366 383 # The default value is: NO.
Chris@366 384
Chris@366 385 TYPEDEF_HIDES_STRUCT = NO
Chris@366 386
Chris@366 387 # The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This
Chris@366 388 # cache is used to resolve symbols given their name and scope. Since this can be
Chris@366 389 # an expensive process and often the same symbol appears multiple times in the
Chris@366 390 # code, doxygen keeps a cache of pre-resolved symbols. If the cache is too small
Chris@366 391 # doxygen will become slower. If the cache is too large, memory is wasted. The
Chris@366 392 # cache size is given by this formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range
Chris@366 393 # is 0..9, the default is 0, corresponding to a cache size of 2^16=65536
Chris@366 394 # symbols. At the end of a run doxygen will report the cache usage and suggest
Chris@366 395 # the optimal cache size from a speed point of view.
Chris@366 396 # Minimum value: 0, maximum value: 9, default value: 0.
Chris@366 397
Chris@366 398 LOOKUP_CACHE_SIZE = 0
Chris@366 399
Chris@366 400 #---------------------------------------------------------------------------
Chris@366 401 # Build related configuration options
Chris@366 402 #---------------------------------------------------------------------------
Chris@366 403
Chris@366 404 # If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
Chris@366 405 # documentation are documented, even if no documentation was available. Private
Chris@366 406 # class members and static file members will be hidden unless the
Chris@366 407 # EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES.
Chris@366 408 # Note: This will also disable the warnings about undocumented members that are
Chris@366 409 # normally produced when WARNINGS is set to YES.
Chris@366 410 # The default value is: NO.
Chris@366 411
Chris@366 412 EXTRACT_ALL = YES
Chris@366 413
Chris@366 414 # If the EXTRACT_PRIVATE tag is set to YES all private members of a class will
Chris@366 415 # be included in the documentation.
Chris@366 416 # The default value is: NO.
Chris@366 417
Chris@366 418 EXTRACT_PRIVATE = NO
Chris@366 419
Chris@366 420 # If the EXTRACT_PACKAGE tag is set to YES all members with package or internal
Chris@366 421 # scope will be included in the documentation.
Chris@366 422 # The default value is: NO.
Chris@366 423
Chris@366 424 EXTRACT_PACKAGE = NO
Chris@366 425
Chris@366 426 # If the EXTRACT_STATIC tag is set to YES all static members of a file will be
Chris@366 427 # included in the documentation.
Chris@366 428 # The default value is: NO.
Chris@366 429
Chris@366 430 EXTRACT_STATIC = NO
Chris@366 431
Chris@366 432 # If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) defined
Chris@366 433 # locally in source files will be included in the documentation. If set to NO
Chris@366 434 # only classes defined in header files are included. Does not have any effect
Chris@366 435 # for Java sources.
Chris@366 436 # The default value is: YES.
Chris@366 437
Chris@366 438 EXTRACT_LOCAL_CLASSES = YES
Chris@366 439
Chris@366 440 # This flag is only useful for Objective-C code. When set to YES local methods,
Chris@366 441 # which are defined in the implementation section but not in the interface are
Chris@366 442 # included in the documentation. If set to NO only methods in the interface are
Chris@366 443 # included.
Chris@366 444 # The default value is: NO.
Chris@366 445
Chris@366 446 EXTRACT_LOCAL_METHODS = NO
Chris@366 447
Chris@366 448 # If this flag is set to YES, the members of anonymous namespaces will be
Chris@366 449 # extracted and appear in the documentation as a namespace called
Chris@366 450 # 'anonymous_namespace{file}', where file will be replaced with the base name of
Chris@366 451 # the file that contains the anonymous namespace. By default anonymous namespace
Chris@366 452 # are hidden.
Chris@366 453 # The default value is: NO.
Chris@366 454
Chris@366 455 EXTRACT_ANON_NSPACES = NO
Chris@366 456
Chris@366 457 # If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all
Chris@366 458 # undocumented members inside documented classes or files. If set to NO these
Chris@366 459 # members will be included in the various overviews, but no documentation
Chris@366 460 # section is generated. This option has no effect if EXTRACT_ALL is enabled.
Chris@366 461 # The default value is: NO.
Chris@366 462
Chris@366 463 HIDE_UNDOC_MEMBERS = NO
Chris@366 464
Chris@366 465 # If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all
Chris@366 466 # undocumented classes that are normally visible in the class hierarchy. If set
Chris@366 467 # to NO these classes will be included in the various overviews. This option has
Chris@366 468 # no effect if EXTRACT_ALL is enabled.
Chris@366 469 # The default value is: NO.
Chris@366 470
Chris@366 471 HIDE_UNDOC_CLASSES = NO
Chris@366 472
Chris@366 473 # If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend
Chris@366 474 # (class|struct|union) declarations. If set to NO these declarations will be
Chris@366 475 # included in the documentation.
Chris@366 476 # The default value is: NO.
Chris@366 477
Chris@366 478 HIDE_FRIEND_COMPOUNDS = NO
Chris@366 479
Chris@366 480 # If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any
Chris@366 481 # documentation blocks found inside the body of a function. If set to NO these
Chris@366 482 # blocks will be appended to the function's detailed documentation block.
Chris@366 483 # The default value is: NO.
Chris@366 484
Chris@366 485 HIDE_IN_BODY_DOCS = NO
Chris@366 486
Chris@366 487 # The INTERNAL_DOCS tag determines if documentation that is typed after a
Chris@366 488 # \internal command is included. If the tag is set to NO then the documentation
Chris@366 489 # will be excluded. Set it to YES to include the internal documentation.
Chris@366 490 # The default value is: NO.
Chris@366 491
Chris@366 492 INTERNAL_DOCS = NO
Chris@366 493
Chris@366 494 # If the CASE_SENSE_NAMES tag is set to NO then doxygen will only generate file
Chris@366 495 # names in lower-case letters. If set to YES upper-case letters are also
Chris@366 496 # allowed. This is useful if you have classes or files whose names only differ
Chris@366 497 # in case and if your file system supports case sensitive file names. Windows
Chris@366 498 # and Mac users are advised to set this option to NO.
Chris@366 499 # The default value is: system dependent.
Chris@366 500
Chris@366 501 CASE_SENSE_NAMES = YES
Chris@366 502
Chris@366 503 # If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with
Chris@366 504 # their full class and namespace scopes in the documentation. If set to YES the
Chris@366 505 # scope will be hidden.
Chris@366 506 # The default value is: NO.
Chris@366 507
Chris@366 508 HIDE_SCOPE_NAMES = NO
Chris@366 509
Chris@366 510 # If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of
Chris@366 511 # the files that are included by a file in the documentation of that file.
Chris@366 512 # The default value is: YES.
Chris@366 513
Chris@366 514 SHOW_INCLUDE_FILES = YES
Chris@366 515
Chris@366 516 # If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each
Chris@366 517 # grouped member an include statement to the documentation, telling the reader
Chris@366 518 # which file to include in order to use the member.
Chris@366 519 # The default value is: NO.
Chris@366 520
Chris@366 521 SHOW_GROUPED_MEMB_INC = NO
Chris@366 522
Chris@366 523 # If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include
Chris@366 524 # files with double quotes in the documentation rather than with sharp brackets.
Chris@366 525 # The default value is: NO.
Chris@366 526
Chris@366 527 FORCE_LOCAL_INCLUDES = NO
Chris@366 528
Chris@366 529 # If the INLINE_INFO tag is set to YES then a tag [inline] is inserted in the
Chris@366 530 # documentation for inline members.
Chris@366 531 # The default value is: YES.
Chris@366 532
Chris@366 533 INLINE_INFO = YES
Chris@366 534
Chris@366 535 # If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the
Chris@366 536 # (detailed) documentation of file and class members alphabetically by member
Chris@366 537 # name. If set to NO the members will appear in declaration order.
Chris@366 538 # The default value is: YES.
Chris@366 539
Chris@366 540 SORT_MEMBER_DOCS = YES
Chris@366 541
Chris@366 542 # If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief
Chris@366 543 # descriptions of file, namespace and class members alphabetically by member
Chris@366 544 # name. If set to NO the members will appear in declaration order. Note that
Chris@366 545 # this will also influence the order of the classes in the class list.
Chris@366 546 # The default value is: NO.
Chris@366 547
Chris@366 548 SORT_BRIEF_DOCS = NO
Chris@366 549
Chris@366 550 # If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the
Chris@366 551 # (brief and detailed) documentation of class members so that constructors and
Chris@366 552 # destructors are listed first. If set to NO the constructors will appear in the
Chris@366 553 # respective orders defined by SORT_BRIEF_DOCS and SORT_MEMBER_DOCS.
Chris@366 554 # Note: If SORT_BRIEF_DOCS is set to NO this option is ignored for sorting brief
Chris@366 555 # member documentation.
Chris@366 556 # Note: If SORT_MEMBER_DOCS is set to NO this option is ignored for sorting
Chris@366 557 # detailed member documentation.
Chris@366 558 # The default value is: NO.
Chris@366 559
Chris@366 560 SORT_MEMBERS_CTORS_1ST = NO
Chris@366 561
Chris@366 562 # If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy
Chris@366 563 # of group names into alphabetical order. If set to NO the group names will
Chris@366 564 # appear in their defined order.
Chris@366 565 # The default value is: NO.
Chris@366 566
Chris@366 567 SORT_GROUP_NAMES = NO
Chris@366 568
Chris@366 569 # If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by
Chris@366 570 # fully-qualified names, including namespaces. If set to NO, the class list will
Chris@366 571 # be sorted only by class name, not including the namespace part.
Chris@366 572 # Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
Chris@366 573 # Note: This option applies only to the class list, not to the alphabetical
Chris@366 574 # list.
Chris@366 575 # The default value is: NO.
Chris@366 576
Chris@366 577 SORT_BY_SCOPE_NAME = NO
Chris@366 578
Chris@366 579 # If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper
Chris@366 580 # type resolution of all parameters of a function it will reject a match between
Chris@366 581 # the prototype and the implementation of a member function even if there is
Chris@366 582 # only one candidate or it is obvious which candidate to choose by doing a
Chris@366 583 # simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still
Chris@366 584 # accept a match between prototype and implementation in such cases.
Chris@366 585 # The default value is: NO.
Chris@366 586
Chris@366 587 STRICT_PROTO_MATCHING = NO
Chris@366 588
Chris@366 589 # The GENERATE_TODOLIST tag can be used to enable ( YES) or disable ( NO) the
Chris@366 590 # todo list. This list is created by putting \todo commands in the
Chris@366 591 # documentation.
Chris@366 592 # The default value is: YES.
Chris@366 593
Chris@366 594 GENERATE_TODOLIST = YES
Chris@366 595
Chris@366 596 # The GENERATE_TESTLIST tag can be used to enable ( YES) or disable ( NO) the
Chris@366 597 # test list. This list is created by putting \test commands in the
Chris@366 598 # documentation.
Chris@366 599 # The default value is: YES.
Chris@366 600
Chris@366 601 GENERATE_TESTLIST = YES
Chris@366 602
Chris@366 603 # The GENERATE_BUGLIST tag can be used to enable ( YES) or disable ( NO) the bug
Chris@366 604 # list. This list is created by putting \bug commands in the documentation.
Chris@366 605 # The default value is: YES.
Chris@366 606
Chris@366 607 GENERATE_BUGLIST = YES
Chris@366 608
Chris@366 609 # The GENERATE_DEPRECATEDLIST tag can be used to enable ( YES) or disable ( NO)
Chris@366 610 # the deprecated list. This list is created by putting \deprecated commands in
Chris@366 611 # the documentation.
Chris@366 612 # The default value is: YES.
Chris@366 613
Chris@366 614 GENERATE_DEPRECATEDLIST= YES
Chris@366 615
Chris@366 616 # The ENABLED_SECTIONS tag can be used to enable conditional documentation
Chris@366 617 # sections, marked by \if <section_label> ... \endif and \cond <section_label>
Chris@366 618 # ... \endcond blocks.
Chris@366 619
Chris@366 620 ENABLED_SECTIONS =
Chris@366 621
Chris@366 622 # The MAX_INITIALIZER_LINES tag determines the maximum number of lines that the
Chris@366 623 # initial value of a variable or macro / define can have for it to appear in the
Chris@366 624 # documentation. If the initializer consists of more lines than specified here
Chris@366 625 # it will be hidden. Use a value of 0 to hide initializers completely. The
Chris@366 626 # appearance of the value of individual variables and macros / defines can be
Chris@366 627 # controlled using \showinitializer or \hideinitializer command in the
Chris@366 628 # documentation regardless of this setting.
Chris@366 629 # Minimum value: 0, maximum value: 10000, default value: 30.
Chris@366 630
Chris@366 631 MAX_INITIALIZER_LINES = 30
Chris@366 632
Chris@366 633 # Set the SHOW_USED_FILES tag to NO to disable the list of files generated at
Chris@366 634 # the bottom of the documentation of classes and structs. If set to YES the list
Chris@366 635 # will mention the files that were used to generate the documentation.
Chris@366 636 # The default value is: YES.
Chris@366 637
Chris@366 638 SHOW_USED_FILES = YES
Chris@366 639
Chris@366 640 # Set the SHOW_FILES tag to NO to disable the generation of the Files page. This
Chris@366 641 # will remove the Files entry from the Quick Index and from the Folder Tree View
Chris@366 642 # (if specified).
Chris@366 643 # The default value is: YES.
Chris@366 644
Chris@366 645 SHOW_FILES = YES
Chris@366 646
Chris@366 647 # Set the SHOW_NAMESPACES tag to NO to disable the generation of the Namespaces
Chris@366 648 # page. This will remove the Namespaces entry from the Quick Index and from the
Chris@366 649 # Folder Tree View (if specified).
Chris@366 650 # The default value is: YES.
Chris@366 651
Chris@366 652 SHOW_NAMESPACES = YES
Chris@366 653
Chris@366 654 # The FILE_VERSION_FILTER tag can be used to specify a program or script that
Chris@366 655 # doxygen should invoke to get the current version for each file (typically from
Chris@366 656 # the version control system). Doxygen will invoke the program by executing (via
Chris@366 657 # popen()) the command command input-file, where command is the value of the
Chris@366 658 # FILE_VERSION_FILTER tag, and input-file is the name of an input file provided
Chris@366 659 # by doxygen. Whatever the program writes to standard output is used as the file
Chris@366 660 # version. For an example see the documentation.
Chris@366 661
Chris@366 662 FILE_VERSION_FILTER =
Chris@366 663
Chris@366 664 # The LAYOUT_FILE tag can be used to specify a layout file which will be parsed
Chris@366 665 # by doxygen. The layout file controls the global structure of the generated
Chris@366 666 # output files in an output format independent way. To create the layout file
Chris@366 667 # that represents doxygen's defaults, run doxygen with the -l option. You can
Chris@366 668 # optionally specify a file name after the option, if omitted DoxygenLayout.xml
Chris@366 669 # will be used as the name of the layout file.
Chris@366 670 #
Chris@366 671 # Note that if you run doxygen from a directory containing a file called
Chris@366 672 # DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
Chris@366 673 # tag is left empty.
Chris@366 674
Chris@366 675 LAYOUT_FILE =
Chris@366 676
Chris@366 677 # The CITE_BIB_FILES tag can be used to specify one or more bib files containing
Chris@366 678 # the reference definitions. This must be a list of .bib files. The .bib
Chris@366 679 # extension is automatically appended if omitted. This requires the bibtex tool
Chris@366 680 # to be installed. See also http://en.wikipedia.org/wiki/BibTeX for more info.
Chris@366 681 # For LaTeX the style of the bibliography can be controlled using
Chris@366 682 # LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the
Chris@366 683 # search path. Do not use file names with spaces, bibtex cannot handle them. See
Chris@366 684 # also \cite for info how to create references.
Chris@366 685
Chris@366 686 CITE_BIB_FILES =
Chris@366 687
Chris@366 688 #---------------------------------------------------------------------------
Chris@366 689 # Configuration options related to warning and progress messages
Chris@366 690 #---------------------------------------------------------------------------
Chris@366 691
Chris@366 692 # The QUIET tag can be used to turn on/off the messages that are generated to
Chris@366 693 # standard output by doxygen. If QUIET is set to YES this implies that the
Chris@366 694 # messages are off.
Chris@366 695 # The default value is: NO.
Chris@366 696
Chris@366 697 QUIET = NO
Chris@366 698
Chris@366 699 # The WARNINGS tag can be used to turn on/off the warning messages that are
Chris@366 700 # generated to standard error ( stderr) by doxygen. If WARNINGS is set to YES
Chris@366 701 # this implies that the warnings are on.
Chris@366 702 #
Chris@366 703 # Tip: Turn warnings on while writing the documentation.
Chris@366 704 # The default value is: YES.
Chris@366 705
Chris@366 706 WARNINGS = YES
Chris@366 707
Chris@366 708 # If the WARN_IF_UNDOCUMENTED tag is set to YES, then doxygen will generate
Chris@366 709 # warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag
Chris@366 710 # will automatically be disabled.
Chris@366 711 # The default value is: YES.
Chris@366 712
Chris@366 713 WARN_IF_UNDOCUMENTED = YES
Chris@366 714
Chris@366 715 # If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for
Chris@366 716 # potential errors in the documentation, such as not documenting some parameters
Chris@366 717 # in a documented function, or documenting parameters that don't exist or using
Chris@366 718 # markup commands wrongly.
Chris@366 719 # The default value is: YES.
Chris@366 720
Chris@366 721 WARN_IF_DOC_ERROR = YES
Chris@366 722
Chris@366 723 # This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that
Chris@366 724 # are documented, but have no documentation for their parameters or return
Chris@366 725 # value. If set to NO doxygen will only warn about wrong or incomplete parameter
Chris@366 726 # documentation, but not about the absence of documentation.
Chris@366 727 # The default value is: NO.
Chris@366 728
Chris@366 729 WARN_NO_PARAMDOC = NO
Chris@366 730
Chris@366 731 # The WARN_FORMAT tag determines the format of the warning messages that doxygen
Chris@366 732 # can produce. The string should contain the $file, $line, and $text tags, which
Chris@366 733 # will be replaced by the file and line number from which the warning originated
Chris@366 734 # and the warning text. Optionally the format may contain $version, which will
Chris@366 735 # be replaced by the version of the file (if it could be obtained via
Chris@366 736 # FILE_VERSION_FILTER)
Chris@366 737 # The default value is: $file:$line: $text.
Chris@366 738
Chris@366 739 WARN_FORMAT = "$file:$line: $text"
Chris@366 740
Chris@366 741 # The WARN_LOGFILE tag can be used to specify a file to which warning and error
Chris@366 742 # messages should be written. If left blank the output is written to standard
Chris@366 743 # error (stderr).
Chris@366 744
Chris@366 745 WARN_LOGFILE =
Chris@366 746
Chris@366 747 #---------------------------------------------------------------------------
Chris@366 748 # Configuration options related to the input files
Chris@366 749 #---------------------------------------------------------------------------
Chris@366 750
Chris@366 751 # The INPUT tag is used to specify the files and/or directories that contain
Chris@366 752 # documented source files. You may enter file names like myfile.cpp or
Chris@366 753 # directories like /usr/src/myproject. Separate the files or directories with
Chris@366 754 # spaces.
Chris@366 755 # Note: If this tag is empty the current directory is searched.
Chris@366 756
Chris@366 757 INPUT = cq src vamp
Chris@366 758
Chris@366 759 # This tag can be used to specify the character encoding of the source files
Chris@366 760 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
Chris@366 761 # libiconv (or the iconv built into libc) for the transcoding. See the libiconv
Chris@366 762 # documentation (see: http://www.gnu.org/software/libiconv) for the list of
Chris@366 763 # possible encodings.
Chris@366 764 # The default value is: UTF-8.
Chris@366 765
Chris@366 766 INPUT_ENCODING = UTF-8
Chris@366 767
Chris@366 768 # If the value of the INPUT tag contains directories, you can use the
Chris@366 769 # FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
Chris@366 770 # *.h) to filter out the source-files in the directories. If left blank the
Chris@366 771 # following patterns are tested:*.c, *.cc, *.cxx, *.cpp, *.c++, *.java, *.ii,
Chris@366 772 # *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, *.hh, *.hxx, *.hpp,
Chris@366 773 # *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc, *.m, *.markdown,
Chris@366 774 # *.md, *.mm, *.dox, *.py, *.f90, *.f, *.for, *.tcl, *.vhd, *.vhdl, *.ucf,
Chris@366 775 # *.qsf, *.as and *.js.
Chris@366 776
Chris@366 777 FILE_PATTERNS =
Chris@366 778
Chris@366 779 # The RECURSIVE tag can be used to specify whether or not subdirectories should
Chris@366 780 # be searched for input files as well.
Chris@366 781 # The default value is: NO.
Chris@366 782
Chris@366 783 RECURSIVE = NO
Chris@366 784
Chris@366 785 # The EXCLUDE tag can be used to specify files and/or directories that should be
Chris@366 786 # excluded from the INPUT source files. This way you can easily exclude a
Chris@366 787 # subdirectory from a directory tree whose root is specified with the INPUT tag.
Chris@366 788 #
Chris@366 789 # Note that relative paths are relative to the directory from which doxygen is
Chris@366 790 # run.
Chris@366 791
Chris@366 792 EXCLUDE =
Chris@366 793
Chris@366 794 # The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
Chris@366 795 # directories that are symbolic links (a Unix file system feature) are excluded
Chris@366 796 # from the input.
Chris@366 797 # The default value is: NO.
Chris@366 798
Chris@366 799 EXCLUDE_SYMLINKS = NO
Chris@366 800
Chris@366 801 # If the value of the INPUT tag contains directories, you can use the
Chris@366 802 # EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
Chris@366 803 # certain files from those directories.
Chris@366 804 #
Chris@366 805 # Note that the wildcards are matched against the file with absolute path, so to
Chris@366 806 # exclude all test directories for example use the pattern */test/*
Chris@366 807
Chris@366 808 EXCLUDE_PATTERNS =
Chris@366 809
Chris@366 810 # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
Chris@366 811 # (namespaces, classes, functions, etc.) that should be excluded from the
Chris@366 812 # output. The symbol name can be a fully qualified name, a word, or if the
Chris@366 813 # wildcard * is used, a substring. Examples: ANamespace, AClass,
Chris@366 814 # AClass::ANamespace, ANamespace::*Test
Chris@366 815 #
Chris@366 816 # Note that the wildcards are matched against the file with absolute path, so to
Chris@366 817 # exclude all test directories use the pattern */test/*
Chris@366 818
Chris@366 819 EXCLUDE_SYMBOLS =
Chris@366 820
Chris@366 821 # The EXAMPLE_PATH tag can be used to specify one or more files or directories
Chris@366 822 # that contain example code fragments that are included (see the \include
Chris@366 823 # command).
Chris@366 824
Chris@366 825 EXAMPLE_PATH =
Chris@366 826
Chris@366 827 # If the value of the EXAMPLE_PATH tag contains directories, you can use the
Chris@366 828 # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
Chris@366 829 # *.h) to filter out the source-files in the directories. If left blank all
Chris@366 830 # files are included.
Chris@366 831
Chris@366 832 EXAMPLE_PATTERNS =
Chris@366 833
Chris@366 834 # If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
Chris@366 835 # searched for input files to be used with the \include or \dontinclude commands
Chris@366 836 # irrespective of the value of the RECURSIVE tag.
Chris@366 837 # The default value is: NO.
Chris@366 838
Chris@366 839 EXAMPLE_RECURSIVE = NO
Chris@366 840
Chris@366 841 # The IMAGE_PATH tag can be used to specify one or more files or directories
Chris@366 842 # that contain images that are to be included in the documentation (see the
Chris@366 843 # \image command).
Chris@366 844
Chris@366 845 IMAGE_PATH =
Chris@366 846
Chris@366 847 # The INPUT_FILTER tag can be used to specify a program that doxygen should
Chris@366 848 # invoke to filter for each input file. Doxygen will invoke the filter program
Chris@366 849 # by executing (via popen()) the command:
Chris@366 850 #
Chris@366 851 # <filter> <input-file>
Chris@366 852 #
Chris@366 853 # where <filter> is the value of the INPUT_FILTER tag, and <input-file> is the
Chris@366 854 # name of an input file. Doxygen will then use the output that the filter
Chris@366 855 # program writes to standard output. If FILTER_PATTERNS is specified, this tag
Chris@366 856 # will be ignored.
Chris@366 857 #
Chris@366 858 # Note that the filter must not add or remove lines; it is applied before the
Chris@366 859 # code is scanned, but not when the output code is generated. If lines are added
Chris@366 860 # or removed, the anchors will not be placed correctly.
Chris@366 861
Chris@366 862 INPUT_FILTER =
Chris@366 863
Chris@366 864 # The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
Chris@366 865 # basis. Doxygen will compare the file name with each pattern and apply the
Chris@366 866 # filter if there is a match. The filters are a list of the form: pattern=filter
Chris@366 867 # (like *.cpp=my_cpp_filter). See INPUT_FILTER for further information on how
Chris@366 868 # filters are used. If the FILTER_PATTERNS tag is empty or if none of the
Chris@366 869 # patterns match the file name, INPUT_FILTER is applied.
Chris@366 870
Chris@366 871 FILTER_PATTERNS =
Chris@366 872
Chris@366 873 # If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
Chris@366 874 # INPUT_FILTER ) will also be used to filter the input files that are used for
Chris@366 875 # producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES).
Chris@366 876 # The default value is: NO.
Chris@366 877
Chris@366 878 FILTER_SOURCE_FILES = NO
Chris@366 879
Chris@366 880 # The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file
Chris@366 881 # pattern. A pattern will override the setting for FILTER_PATTERN (if any) and
Chris@366 882 # it is also possible to disable source filtering for a specific pattern using
Chris@366 883 # *.ext= (so without naming a filter).
Chris@366 884 # This tag requires that the tag FILTER_SOURCE_FILES is set to YES.
Chris@366 885
Chris@366 886 FILTER_SOURCE_PATTERNS =
Chris@366 887
Chris@366 888 # If the USE_MDFILE_AS_MAINPAGE tag refers to the name of a markdown file that
Chris@366 889 # is part of the input, its contents will be placed on the main page
Chris@366 890 # (index.html). This can be useful if you have a project on for instance GitHub
Chris@366 891 # and want to reuse the introduction page also for the doxygen output.
Chris@366 892
Chris@366 893 USE_MDFILE_AS_MAINPAGE =
Chris@366 894
Chris@366 895 #---------------------------------------------------------------------------
Chris@366 896 # Configuration options related to source browsing
Chris@366 897 #---------------------------------------------------------------------------
Chris@366 898
Chris@366 899 # If the SOURCE_BROWSER tag is set to YES then a list of source files will be
Chris@366 900 # generated. Documented entities will be cross-referenced with these sources.
Chris@366 901 #
Chris@366 902 # Note: To get rid of all source code in the generated output, make sure that
Chris@366 903 # also VERBATIM_HEADERS is set to NO.
Chris@366 904 # The default value is: NO.
Chris@366 905
Chris@366 906 SOURCE_BROWSER = NO
Chris@366 907
Chris@366 908 # Setting the INLINE_SOURCES tag to YES will include the body of functions,
Chris@366 909 # classes and enums directly into the documentation.
Chris@366 910 # The default value is: NO.
Chris@366 911
Chris@366 912 INLINE_SOURCES = NO
Chris@366 913
Chris@366 914 # Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any
Chris@366 915 # special comment blocks from generated source code fragments. Normal C, C++ and
Chris@366 916 # Fortran comments will always remain visible.
Chris@366 917 # The default value is: YES.
Chris@366 918
Chris@366 919 STRIP_CODE_COMMENTS = YES
Chris@366 920
Chris@366 921 # If the REFERENCED_BY_RELATION tag is set to YES then for each documented
Chris@366 922 # function all documented functions referencing it will be listed.
Chris@366 923 # The default value is: NO.
Chris@366 924
Chris@366 925 REFERENCED_BY_RELATION = NO
Chris@366 926
Chris@366 927 # If the REFERENCES_RELATION tag is set to YES then for each documented function
Chris@366 928 # all documented entities called/used by that function will be listed.
Chris@366 929 # The default value is: NO.
Chris@366 930
Chris@366 931 REFERENCES_RELATION = NO
Chris@366 932
Chris@366 933 # If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set
Chris@366 934 # to YES, then the hyperlinks from functions in REFERENCES_RELATION and
Chris@366 935 # REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will
Chris@366 936 # link to the documentation.
Chris@366 937 # The default value is: YES.
Chris@366 938
Chris@366 939 REFERENCES_LINK_SOURCE = YES
Chris@366 940
Chris@366 941 # If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the
Chris@366 942 # source code will show a tooltip with additional information such as prototype,
Chris@366 943 # brief description and links to the definition and documentation. Since this
Chris@366 944 # will make the HTML file larger and loading of large files a bit slower, you
Chris@366 945 # can opt to disable this feature.
Chris@366 946 # The default value is: YES.
Chris@366 947 # This tag requires that the tag SOURCE_BROWSER is set to YES.
Chris@366 948
Chris@366 949 SOURCE_TOOLTIPS = YES
Chris@366 950
Chris@366 951 # If the USE_HTAGS tag is set to YES then the references to source code will
Chris@366 952 # point to the HTML generated by the htags(1) tool instead of doxygen built-in
Chris@366 953 # source browser. The htags tool is part of GNU's global source tagging system
Chris@366 954 # (see http://www.gnu.org/software/global/global.html). You will need version
Chris@366 955 # 4.8.6 or higher.
Chris@366 956 #
Chris@366 957 # To use it do the following:
Chris@366 958 # - Install the latest version of global
Chris@366 959 # - Enable SOURCE_BROWSER and USE_HTAGS in the config file
Chris@366 960 # - Make sure the INPUT points to the root of the source tree
Chris@366 961 # - Run doxygen as normal
Chris@366 962 #
Chris@366 963 # Doxygen will invoke htags (and that will in turn invoke gtags), so these
Chris@366 964 # tools must be available from the command line (i.e. in the search path).
Chris@366 965 #
Chris@366 966 # The result: instead of the source browser generated by doxygen, the links to
Chris@366 967 # source code will now point to the output of htags.
Chris@366 968 # The default value is: NO.
Chris@366 969 # This tag requires that the tag SOURCE_BROWSER is set to YES.
Chris@366 970
Chris@366 971 USE_HTAGS = NO
Chris@366 972
Chris@366 973 # If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a
Chris@366 974 # verbatim copy of the header file for each class for which an include is
Chris@366 975 # specified. Set to NO to disable this.
Chris@366 976 # See also: Section \class.
Chris@366 977 # The default value is: YES.
Chris@366 978
Chris@366 979 VERBATIM_HEADERS = YES
Chris@366 980
Chris@366 981 #---------------------------------------------------------------------------
Chris@366 982 # Configuration options related to the alphabetical class index
Chris@366 983 #---------------------------------------------------------------------------
Chris@366 984
Chris@366 985 # If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all
Chris@366 986 # compounds will be generated. Enable this if the project contains a lot of
Chris@366 987 # classes, structs, unions or interfaces.
Chris@366 988 # The default value is: YES.
Chris@366 989
Chris@366 990 ALPHABETICAL_INDEX = YES
Chris@366 991
Chris@366 992 # The COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns in
Chris@366 993 # which the alphabetical index list will be split.
Chris@366 994 # Minimum value: 1, maximum value: 20, default value: 5.
Chris@366 995 # This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
Chris@366 996
Chris@366 997 COLS_IN_ALPHA_INDEX = 5
Chris@366 998
Chris@366 999 # In case all classes in a project start with a common prefix, all classes will
Chris@366 1000 # be put under the same header in the alphabetical index. The IGNORE_PREFIX tag
Chris@366 1001 # can be used to specify a prefix (or a list of prefixes) that should be ignored
Chris@366 1002 # while generating the index headers.
Chris@366 1003 # This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
Chris@366 1004
Chris@366 1005 IGNORE_PREFIX =
Chris@366 1006
Chris@366 1007 #---------------------------------------------------------------------------
Chris@366 1008 # Configuration options related to the HTML output
Chris@366 1009 #---------------------------------------------------------------------------
Chris@366 1010
Chris@366 1011 # If the GENERATE_HTML tag is set to YES doxygen will generate HTML output
Chris@366 1012 # The default value is: YES.
Chris@366 1013
Chris@366 1014 GENERATE_HTML = YES
Chris@366 1015
Chris@366 1016 # The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a
Chris@366 1017 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
Chris@366 1018 # it.
Chris@366 1019 # The default directory is: html.
Chris@366 1020 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1021
Chris@366 1022 HTML_OUTPUT = html
Chris@366 1023
Chris@366 1024 # The HTML_FILE_EXTENSION tag can be used to specify the file extension for each
Chris@366 1025 # generated HTML page (for example: .htm, .php, .asp).
Chris@366 1026 # The default value is: .html.
Chris@366 1027 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1028
Chris@366 1029 HTML_FILE_EXTENSION = .html
Chris@366 1030
Chris@366 1031 # The HTML_HEADER tag can be used to specify a user-defined HTML header file for
Chris@366 1032 # each generated HTML page. If the tag is left blank doxygen will generate a
Chris@366 1033 # standard header.
Chris@366 1034 #
Chris@366 1035 # To get valid HTML the header file that includes any scripts and style sheets
Chris@366 1036 # that doxygen needs, which is dependent on the configuration options used (e.g.
Chris@366 1037 # the setting GENERATE_TREEVIEW). It is highly recommended to start with a
Chris@366 1038 # default header using
Chris@366 1039 # doxygen -w html new_header.html new_footer.html new_stylesheet.css
Chris@366 1040 # YourConfigFile
Chris@366 1041 # and then modify the file new_header.html. See also section "Doxygen usage"
Chris@366 1042 # for information on how to generate the default header that doxygen normally
Chris@366 1043 # uses.
Chris@366 1044 # Note: The header is subject to change so you typically have to regenerate the
Chris@366 1045 # default header when upgrading to a newer version of doxygen. For a description
Chris@366 1046 # of the possible markers and block names see the documentation.
Chris@366 1047 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1048
Chris@366 1049 HTML_HEADER =
Chris@366 1050
Chris@366 1051 # The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each
Chris@366 1052 # generated HTML page. If the tag is left blank doxygen will generate a standard
Chris@366 1053 # footer. See HTML_HEADER for more information on how to generate a default
Chris@366 1054 # footer and what special commands can be used inside the footer. See also
Chris@366 1055 # section "Doxygen usage" for information on how to generate the default footer
Chris@366 1056 # that doxygen normally uses.
Chris@366 1057 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1058
Chris@366 1059 HTML_FOOTER =
Chris@366 1060
Chris@366 1061 # The HTML_STYLESHEET tag can be used to specify a user-defined cascading style
Chris@366 1062 # sheet that is used by each HTML page. It can be used to fine-tune the look of
Chris@366 1063 # the HTML output. If left blank doxygen will generate a default style sheet.
Chris@366 1064 # See also section "Doxygen usage" for information on how to generate the style
Chris@366 1065 # sheet that doxygen normally uses.
Chris@366 1066 # Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as
Chris@366 1067 # it is more robust and this tag (HTML_STYLESHEET) will in the future become
Chris@366 1068 # obsolete.
Chris@366 1069 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1070
Chris@366 1071 HTML_STYLESHEET =
Chris@366 1072
Chris@366 1073 # The HTML_EXTRA_STYLESHEET tag can be used to specify an additional user-
Chris@366 1074 # defined cascading style sheet that is included after the standard style sheets
Chris@366 1075 # created by doxygen. Using this option one can overrule certain style aspects.
Chris@366 1076 # This is preferred over using HTML_STYLESHEET since it does not replace the
Chris@366 1077 # standard style sheet and is therefor more robust against future updates.
Chris@366 1078 # Doxygen will copy the style sheet file to the output directory. For an example
Chris@366 1079 # see the documentation.
Chris@366 1080 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1081
Chris@366 1082 HTML_EXTRA_STYLESHEET =
Chris@366 1083
Chris@366 1084 # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
Chris@366 1085 # other source files which should be copied to the HTML output directory. Note
Chris@366 1086 # that these files will be copied to the base HTML output directory. Use the
Chris@366 1087 # $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these
Chris@366 1088 # files. In the HTML_STYLESHEET file, use the file name only. Also note that the
Chris@366 1089 # files will be copied as-is; there are no commands or markers available.
Chris@366 1090 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1091
Chris@366 1092 HTML_EXTRA_FILES =
Chris@366 1093
Chris@366 1094 # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
Chris@366 1095 # will adjust the colors in the stylesheet and background images according to
Chris@366 1096 # this color. Hue is specified as an angle on a colorwheel, see
Chris@366 1097 # http://en.wikipedia.org/wiki/Hue for more information. For instance the value
Chris@366 1098 # 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300
Chris@366 1099 # purple, and 360 is red again.
Chris@366 1100 # Minimum value: 0, maximum value: 359, default value: 220.
Chris@366 1101 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1102
Chris@366 1103 HTML_COLORSTYLE_HUE = 220
Chris@366 1104
Chris@366 1105 # The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors
Chris@366 1106 # in the HTML output. For a value of 0 the output will use grayscales only. A
Chris@366 1107 # value of 255 will produce the most vivid colors.
Chris@366 1108 # Minimum value: 0, maximum value: 255, default value: 100.
Chris@366 1109 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1110
Chris@366 1111 HTML_COLORSTYLE_SAT = 100
Chris@366 1112
Chris@366 1113 # The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the
Chris@366 1114 # luminance component of the colors in the HTML output. Values below 100
Chris@366 1115 # gradually make the output lighter, whereas values above 100 make the output
Chris@366 1116 # darker. The value divided by 100 is the actual gamma applied, so 80 represents
Chris@366 1117 # a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not
Chris@366 1118 # change the gamma.
Chris@366 1119 # Minimum value: 40, maximum value: 240, default value: 80.
Chris@366 1120 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1121
Chris@366 1122 HTML_COLORSTYLE_GAMMA = 80
Chris@366 1123
Chris@366 1124 # If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
Chris@366 1125 # page will contain the date and time when the page was generated. Setting this
Chris@366 1126 # to NO can help when comparing the output of multiple runs.
Chris@366 1127 # The default value is: YES.
Chris@366 1128 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1129
Chris@366 1130 HTML_TIMESTAMP = YES
Chris@366 1131
Chris@366 1132 # If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
Chris@366 1133 # documentation will contain sections that can be hidden and shown after the
Chris@366 1134 # page has loaded.
Chris@366 1135 # The default value is: NO.
Chris@366 1136 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1137
Chris@366 1138 HTML_DYNAMIC_SECTIONS = NO
Chris@366 1139
Chris@366 1140 # With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries
Chris@366 1141 # shown in the various tree structured indices initially; the user can expand
Chris@366 1142 # and collapse entries dynamically later on. Doxygen will expand the tree to
Chris@366 1143 # such a level that at most the specified number of entries are visible (unless
Chris@366 1144 # a fully collapsed tree already exceeds this amount). So setting the number of
Chris@366 1145 # entries 1 will produce a full collapsed tree by default. 0 is a special value
Chris@366 1146 # representing an infinite number of entries and will result in a full expanded
Chris@366 1147 # tree by default.
Chris@366 1148 # Minimum value: 0, maximum value: 9999, default value: 100.
Chris@366 1149 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1150
Chris@366 1151 HTML_INDEX_NUM_ENTRIES = 100
Chris@366 1152
Chris@366 1153 # If the GENERATE_DOCSET tag is set to YES, additional index files will be
Chris@366 1154 # generated that can be used as input for Apple's Xcode 3 integrated development
Chris@366 1155 # environment (see: http://developer.apple.com/tools/xcode/), introduced with
Chris@366 1156 # OSX 10.5 (Leopard). To create a documentation set, doxygen will generate a
Chris@366 1157 # Makefile in the HTML output directory. Running make will produce the docset in
Chris@366 1158 # that directory and running make install will install the docset in
Chris@366 1159 # ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at
Chris@366 1160 # startup. See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html
Chris@366 1161 # for more information.
Chris@366 1162 # The default value is: NO.
Chris@366 1163 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1164
Chris@366 1165 GENERATE_DOCSET = NO
Chris@366 1166
Chris@366 1167 # This tag determines the name of the docset feed. A documentation feed provides
Chris@366 1168 # an umbrella under which multiple documentation sets from a single provider
Chris@366 1169 # (such as a company or product suite) can be grouped.
Chris@366 1170 # The default value is: Doxygen generated docs.
Chris@366 1171 # This tag requires that the tag GENERATE_DOCSET is set to YES.
Chris@366 1172
Chris@366 1173 DOCSET_FEEDNAME = "Doxygen generated docs"
Chris@366 1174
Chris@366 1175 # This tag specifies a string that should uniquely identify the documentation
Chris@366 1176 # set bundle. This should be a reverse domain-name style string, e.g.
Chris@366 1177 # com.mycompany.MyDocSet. Doxygen will append .docset to the name.
Chris@366 1178 # The default value is: org.doxygen.Project.
Chris@366 1179 # This tag requires that the tag GENERATE_DOCSET is set to YES.
Chris@366 1180
Chris@366 1181 DOCSET_BUNDLE_ID = org.doxygen.Project
Chris@366 1182
Chris@366 1183 # The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify
Chris@366 1184 # the documentation publisher. This should be a reverse domain-name style
Chris@366 1185 # string, e.g. com.mycompany.MyDocSet.documentation.
Chris@366 1186 # The default value is: org.doxygen.Publisher.
Chris@366 1187 # This tag requires that the tag GENERATE_DOCSET is set to YES.
Chris@366 1188
Chris@366 1189 DOCSET_PUBLISHER_ID = org.doxygen.Publisher
Chris@366 1190
Chris@366 1191 # The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher.
Chris@366 1192 # The default value is: Publisher.
Chris@366 1193 # This tag requires that the tag GENERATE_DOCSET is set to YES.
Chris@366 1194
Chris@366 1195 DOCSET_PUBLISHER_NAME = Publisher
Chris@366 1196
Chris@366 1197 # If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three
Chris@366 1198 # additional HTML index files: index.hhp, index.hhc, and index.hhk. The
Chris@366 1199 # index.hhp is a project file that can be read by Microsoft's HTML Help Workshop
Chris@366 1200 # (see: http://www.microsoft.com/en-us/download/details.aspx?id=21138) on
Chris@366 1201 # Windows.
Chris@366 1202 #
Chris@366 1203 # The HTML Help Workshop contains a compiler that can convert all HTML output
Chris@366 1204 # generated by doxygen into a single compiled HTML file (.chm). Compiled HTML
Chris@366 1205 # files are now used as the Windows 98 help format, and will replace the old
Chris@366 1206 # Windows help format (.hlp) on all Windows platforms in the future. Compressed
Chris@366 1207 # HTML files also contain an index, a table of contents, and you can search for
Chris@366 1208 # words in the documentation. The HTML workshop also contains a viewer for
Chris@366 1209 # compressed HTML files.
Chris@366 1210 # The default value is: NO.
Chris@366 1211 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1212
Chris@366 1213 GENERATE_HTMLHELP = NO
Chris@366 1214
Chris@366 1215 # The CHM_FILE tag can be used to specify the file name of the resulting .chm
Chris@366 1216 # file. You can add a path in front of the file if the result should not be
Chris@366 1217 # written to the html output directory.
Chris@366 1218 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
Chris@366 1219
Chris@366 1220 CHM_FILE =
Chris@366 1221
Chris@366 1222 # The HHC_LOCATION tag can be used to specify the location (absolute path
Chris@366 1223 # including file name) of the HTML help compiler ( hhc.exe). If non-empty
Chris@366 1224 # doxygen will try to run the HTML help compiler on the generated index.hhp.
Chris@366 1225 # The file has to be specified with full path.
Chris@366 1226 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
Chris@366 1227
Chris@366 1228 HHC_LOCATION =
Chris@366 1229
Chris@366 1230 # The GENERATE_CHI flag controls if a separate .chi index file is generated (
Chris@366 1231 # YES) or that it should be included in the master .chm file ( NO).
Chris@366 1232 # The default value is: NO.
Chris@366 1233 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
Chris@366 1234
Chris@366 1235 GENERATE_CHI = NO
Chris@366 1236
Chris@366 1237 # The CHM_INDEX_ENCODING is used to encode HtmlHelp index ( hhk), content ( hhc)
Chris@366 1238 # and project file content.
Chris@366 1239 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
Chris@366 1240
Chris@366 1241 CHM_INDEX_ENCODING =
Chris@366 1242
Chris@366 1243 # The BINARY_TOC flag controls whether a binary table of contents is generated (
Chris@366 1244 # YES) or a normal table of contents ( NO) in the .chm file. Furthermore it
Chris@366 1245 # enables the Previous and Next buttons.
Chris@366 1246 # The default value is: NO.
Chris@366 1247 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
Chris@366 1248
Chris@366 1249 BINARY_TOC = NO
Chris@366 1250
Chris@366 1251 # The TOC_EXPAND flag can be set to YES to add extra items for group members to
Chris@366 1252 # the table of contents of the HTML help documentation and to the tree view.
Chris@366 1253 # The default value is: NO.
Chris@366 1254 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
Chris@366 1255
Chris@366 1256 TOC_EXPAND = NO
Chris@366 1257
Chris@366 1258 # If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and
Chris@366 1259 # QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that
Chris@366 1260 # can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help
Chris@366 1261 # (.qch) of the generated HTML documentation.
Chris@366 1262 # The default value is: NO.
Chris@366 1263 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1264
Chris@366 1265 GENERATE_QHP = NO
Chris@366 1266
Chris@366 1267 # If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify
Chris@366 1268 # the file name of the resulting .qch file. The path specified is relative to
Chris@366 1269 # the HTML output folder.
Chris@366 1270 # This tag requires that the tag GENERATE_QHP is set to YES.
Chris@366 1271
Chris@366 1272 QCH_FILE =
Chris@366 1273
Chris@366 1274 # The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help
Chris@366 1275 # Project output. For more information please see Qt Help Project / Namespace
Chris@366 1276 # (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#namespace).
Chris@366 1277 # The default value is: org.doxygen.Project.
Chris@366 1278 # This tag requires that the tag GENERATE_QHP is set to YES.
Chris@366 1279
Chris@366 1280 QHP_NAMESPACE = org.doxygen.Project
Chris@366 1281
Chris@366 1282 # The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt
Chris@366 1283 # Help Project output. For more information please see Qt Help Project / Virtual
Chris@366 1284 # Folders (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#virtual-
Chris@366 1285 # folders).
Chris@366 1286 # The default value is: doc.
Chris@366 1287 # This tag requires that the tag GENERATE_QHP is set to YES.
Chris@366 1288
Chris@366 1289 QHP_VIRTUAL_FOLDER = doc
Chris@366 1290
Chris@366 1291 # If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom
Chris@366 1292 # filter to add. For more information please see Qt Help Project / Custom
Chris@366 1293 # Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-
Chris@366 1294 # filters).
Chris@366 1295 # This tag requires that the tag GENERATE_QHP is set to YES.
Chris@366 1296
Chris@366 1297 QHP_CUST_FILTER_NAME =
Chris@366 1298
Chris@366 1299 # The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the
Chris@366 1300 # custom filter to add. For more information please see Qt Help Project / Custom
Chris@366 1301 # Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-
Chris@366 1302 # filters).
Chris@366 1303 # This tag requires that the tag GENERATE_QHP is set to YES.
Chris@366 1304
Chris@366 1305 QHP_CUST_FILTER_ATTRS =
Chris@366 1306
Chris@366 1307 # The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this
Chris@366 1308 # project's filter section matches. Qt Help Project / Filter Attributes (see:
Chris@366 1309 # http://qt-project.org/doc/qt-4.8/qthelpproject.html#filter-attributes).
Chris@366 1310 # This tag requires that the tag GENERATE_QHP is set to YES.
Chris@366 1311
Chris@366 1312 QHP_SECT_FILTER_ATTRS =
Chris@366 1313
Chris@366 1314 # The QHG_LOCATION tag can be used to specify the location of Qt's
Chris@366 1315 # qhelpgenerator. If non-empty doxygen will try to run qhelpgenerator on the
Chris@366 1316 # generated .qhp file.
Chris@366 1317 # This tag requires that the tag GENERATE_QHP is set to YES.
Chris@366 1318
Chris@366 1319 QHG_LOCATION =
Chris@366 1320
Chris@366 1321 # If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be
Chris@366 1322 # generated, together with the HTML files, they form an Eclipse help plugin. To
Chris@366 1323 # install this plugin and make it available under the help contents menu in
Chris@366 1324 # Eclipse, the contents of the directory containing the HTML and XML files needs
Chris@366 1325 # to be copied into the plugins directory of eclipse. The name of the directory
Chris@366 1326 # within the plugins directory should be the same as the ECLIPSE_DOC_ID value.
Chris@366 1327 # After copying Eclipse needs to be restarted before the help appears.
Chris@366 1328 # The default value is: NO.
Chris@366 1329 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1330
Chris@366 1331 GENERATE_ECLIPSEHELP = NO
Chris@366 1332
Chris@366 1333 # A unique identifier for the Eclipse help plugin. When installing the plugin
Chris@366 1334 # the directory name containing the HTML and XML files should also have this
Chris@366 1335 # name. Each documentation set should have its own identifier.
Chris@366 1336 # The default value is: org.doxygen.Project.
Chris@366 1337 # This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES.
Chris@366 1338
Chris@366 1339 ECLIPSE_DOC_ID = org.doxygen.Project
Chris@366 1340
Chris@366 1341 # If you want full control over the layout of the generated HTML pages it might
Chris@366 1342 # be necessary to disable the index and replace it with your own. The
Chris@366 1343 # DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top
Chris@366 1344 # of each HTML page. A value of NO enables the index and the value YES disables
Chris@366 1345 # it. Since the tabs in the index contain the same information as the navigation
Chris@366 1346 # tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES.
Chris@366 1347 # The default value is: NO.
Chris@366 1348 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1349
Chris@366 1350 DISABLE_INDEX = NO
Chris@366 1351
Chris@366 1352 # The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
Chris@366 1353 # structure should be generated to display hierarchical information. If the tag
Chris@366 1354 # value is set to YES, a side panel will be generated containing a tree-like
Chris@366 1355 # index structure (just like the one that is generated for HTML Help). For this
Chris@366 1356 # to work a browser that supports JavaScript, DHTML, CSS and frames is required
Chris@366 1357 # (i.e. any modern browser). Windows users are probably better off using the
Chris@366 1358 # HTML help feature. Via custom stylesheets (see HTML_EXTRA_STYLESHEET) one can
Chris@366 1359 # further fine-tune the look of the index. As an example, the default style
Chris@366 1360 # sheet generated by doxygen has an example that shows how to put an image at
Chris@366 1361 # the root of the tree instead of the PROJECT_NAME. Since the tree basically has
Chris@366 1362 # the same information as the tab index, you could consider setting
Chris@366 1363 # DISABLE_INDEX to YES when enabling this option.
Chris@366 1364 # The default value is: NO.
Chris@366 1365 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1366
Chris@366 1367 GENERATE_TREEVIEW = NO
Chris@366 1368
Chris@366 1369 # The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that
Chris@366 1370 # doxygen will group on one line in the generated HTML documentation.
Chris@366 1371 #
Chris@366 1372 # Note that a value of 0 will completely suppress the enum values from appearing
Chris@366 1373 # in the overview section.
Chris@366 1374 # Minimum value: 0, maximum value: 20, default value: 4.
Chris@366 1375 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1376
Chris@366 1377 ENUM_VALUES_PER_LINE = 4
Chris@366 1378
Chris@366 1379 # If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used
Chris@366 1380 # to set the initial width (in pixels) of the frame in which the tree is shown.
Chris@366 1381 # Minimum value: 0, maximum value: 1500, default value: 250.
Chris@366 1382 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1383
Chris@366 1384 TREEVIEW_WIDTH = 250
Chris@366 1385
Chris@366 1386 # When the EXT_LINKS_IN_WINDOW option is set to YES doxygen will open links to
Chris@366 1387 # external symbols imported via tag files in a separate window.
Chris@366 1388 # The default value is: NO.
Chris@366 1389 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1390
Chris@366 1391 EXT_LINKS_IN_WINDOW = NO
Chris@366 1392
Chris@366 1393 # Use this tag to change the font size of LaTeX formulas included as images in
Chris@366 1394 # the HTML documentation. When you change the font size after a successful
Chris@366 1395 # doxygen run you need to manually remove any form_*.png images from the HTML
Chris@366 1396 # output directory to force them to be regenerated.
Chris@366 1397 # Minimum value: 8, maximum value: 50, default value: 10.
Chris@366 1398 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1399
Chris@366 1400 FORMULA_FONTSIZE = 10
Chris@366 1401
Chris@366 1402 # Use the FORMULA_TRANPARENT tag to determine whether or not the images
Chris@366 1403 # generated for formulas are transparent PNGs. Transparent PNGs are not
Chris@366 1404 # supported properly for IE 6.0, but are supported on all modern browsers.
Chris@366 1405 #
Chris@366 1406 # Note that when changing this option you need to delete any form_*.png files in
Chris@366 1407 # the HTML output directory before the changes have effect.
Chris@366 1408 # The default value is: YES.
Chris@366 1409 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1410
Chris@366 1411 FORMULA_TRANSPARENT = YES
Chris@366 1412
Chris@366 1413 # Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see
Chris@366 1414 # http://www.mathjax.org) which uses client side Javascript for the rendering
Chris@366 1415 # instead of using prerendered bitmaps. Use this if you do not have LaTeX
Chris@366 1416 # installed or if you want to formulas look prettier in the HTML output. When
Chris@366 1417 # enabled you may also need to install MathJax separately and configure the path
Chris@366 1418 # to it using the MATHJAX_RELPATH option.
Chris@366 1419 # The default value is: NO.
Chris@366 1420 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1421
Chris@366 1422 USE_MATHJAX = NO
Chris@366 1423
Chris@366 1424 # When MathJax is enabled you can set the default output format to be used for
Chris@366 1425 # the MathJax output. See the MathJax site (see:
Chris@366 1426 # http://docs.mathjax.org/en/latest/output.html) for more details.
Chris@366 1427 # Possible values are: HTML-CSS (which is slower, but has the best
Chris@366 1428 # compatibility), NativeMML (i.e. MathML) and SVG.
Chris@366 1429 # The default value is: HTML-CSS.
Chris@366 1430 # This tag requires that the tag USE_MATHJAX is set to YES.
Chris@366 1431
Chris@366 1432 MATHJAX_FORMAT = HTML-CSS
Chris@366 1433
Chris@366 1434 # When MathJax is enabled you need to specify the location relative to the HTML
Chris@366 1435 # output directory using the MATHJAX_RELPATH option. The destination directory
Chris@366 1436 # should contain the MathJax.js script. For instance, if the mathjax directory
Chris@366 1437 # is located at the same level as the HTML output directory, then
Chris@366 1438 # MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax
Chris@366 1439 # Content Delivery Network so you can quickly see the result without installing
Chris@366 1440 # MathJax. However, it is strongly recommended to install a local copy of
Chris@366 1441 # MathJax from http://www.mathjax.org before deployment.
Chris@366 1442 # The default value is: http://cdn.mathjax.org/mathjax/latest.
Chris@366 1443 # This tag requires that the tag USE_MATHJAX is set to YES.
Chris@366 1444
Chris@366 1445 MATHJAX_RELPATH = http://cdn.mathjax.org/mathjax/latest
Chris@366 1446
Chris@366 1447 # The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax
Chris@366 1448 # extension names that should be enabled during MathJax rendering. For example
Chris@366 1449 # MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols
Chris@366 1450 # This tag requires that the tag USE_MATHJAX is set to YES.
Chris@366 1451
Chris@366 1452 MATHJAX_EXTENSIONS =
Chris@366 1453
Chris@366 1454 # The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces
Chris@366 1455 # of code that will be used on startup of the MathJax code. See the MathJax site
Chris@366 1456 # (see: http://docs.mathjax.org/en/latest/output.html) for more details. For an
Chris@366 1457 # example see the documentation.
Chris@366 1458 # This tag requires that the tag USE_MATHJAX is set to YES.
Chris@366 1459
Chris@366 1460 MATHJAX_CODEFILE =
Chris@366 1461
Chris@366 1462 # When the SEARCHENGINE tag is enabled doxygen will generate a search box for
Chris@366 1463 # the HTML output. The underlying search engine uses javascript and DHTML and
Chris@366 1464 # should work on any modern browser. Note that when using HTML help
Chris@366 1465 # (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET)
Chris@366 1466 # there is already a search function so this one should typically be disabled.
Chris@366 1467 # For large projects the javascript based search engine can be slow, then
Chris@366 1468 # enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to
Chris@366 1469 # search using the keyboard; to jump to the search box use <access key> + S
Chris@366 1470 # (what the <access key> is depends on the OS and browser, but it is typically
Chris@366 1471 # <CTRL>, <ALT>/<option>, or both). Inside the search box use the <cursor down
Chris@366 1472 # key> to jump into the search results window, the results can be navigated
Chris@366 1473 # using the <cursor keys>. Press <Enter> to select an item or <escape> to cancel
Chris@366 1474 # the search. The filter options can be selected when the cursor is inside the
Chris@366 1475 # search box by pressing <Shift>+<cursor down>. Also here use the <cursor keys>
Chris@366 1476 # to select a filter and <Enter> or <escape> to activate or cancel the filter
Chris@366 1477 # option.
Chris@366 1478 # The default value is: YES.
Chris@366 1479 # This tag requires that the tag GENERATE_HTML is set to YES.
Chris@366 1480
Chris@366 1481 SEARCHENGINE = YES
Chris@366 1482
Chris@366 1483 # When the SERVER_BASED_SEARCH tag is enabled the search engine will be
Chris@366 1484 # implemented using a web server instead of a web client using Javascript. There
Chris@366 1485 # are two flavors of web server based searching depending on the EXTERNAL_SEARCH
Chris@366 1486 # setting. When disabled, doxygen will generate a PHP script for searching and
Chris@366 1487 # an index file used by the script. When EXTERNAL_SEARCH is enabled the indexing
Chris@366 1488 # and searching needs to be provided by external tools. See the section
Chris@366 1489 # "External Indexing and Searching" for details.
Chris@366 1490 # The default value is: NO.
Chris@366 1491 # This tag requires that the tag SEARCHENGINE is set to YES.
Chris@366 1492
Chris@366 1493 SERVER_BASED_SEARCH = NO
Chris@366 1494
Chris@366 1495 # When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP
Chris@366 1496 # script for searching. Instead the search results are written to an XML file
Chris@366 1497 # which needs to be processed by an external indexer. Doxygen will invoke an
Chris@366 1498 # external search engine pointed to by the SEARCHENGINE_URL option to obtain the
Chris@366 1499 # search results.
Chris@366 1500 #
Chris@366 1501 # Doxygen ships with an example indexer ( doxyindexer) and search engine
Chris@366 1502 # (doxysearch.cgi) which are based on the open source search engine library
Chris@366 1503 # Xapian (see: http://xapian.org/).
Chris@366 1504 #
Chris@366 1505 # See the section "External Indexing and Searching" for details.
Chris@366 1506 # The default value is: NO.
Chris@366 1507 # This tag requires that the tag SEARCHENGINE is set to YES.
Chris@366 1508
Chris@366 1509 EXTERNAL_SEARCH = NO
Chris@366 1510
Chris@366 1511 # The SEARCHENGINE_URL should point to a search engine hosted by a web server
Chris@366 1512 # which will return the search results when EXTERNAL_SEARCH is enabled.
Chris@366 1513 #
Chris@366 1514 # Doxygen ships with an example indexer ( doxyindexer) and search engine
Chris@366 1515 # (doxysearch.cgi) which are based on the open source search engine library
Chris@366 1516 # Xapian (see: http://xapian.org/). See the section "External Indexing and
Chris@366 1517 # Searching" for details.
Chris@366 1518 # This tag requires that the tag SEARCHENGINE is set to YES.
Chris@366 1519
Chris@366 1520 SEARCHENGINE_URL =
Chris@366 1521
Chris@366 1522 # When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the unindexed
Chris@366 1523 # search data is written to a file for indexing by an external tool. With the
Chris@366 1524 # SEARCHDATA_FILE tag the name of this file can be specified.
Chris@366 1525 # The default file is: searchdata.xml.
Chris@366 1526 # This tag requires that the tag SEARCHENGINE is set to YES.
Chris@366 1527
Chris@366 1528 SEARCHDATA_FILE = searchdata.xml
Chris@366 1529
Chris@366 1530 # When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the
Chris@366 1531 # EXTERNAL_SEARCH_ID tag can be used as an identifier for the project. This is
Chris@366 1532 # useful in combination with EXTRA_SEARCH_MAPPINGS to search through multiple
Chris@366 1533 # projects and redirect the results back to the right project.
Chris@366 1534 # This tag requires that the tag SEARCHENGINE is set to YES.
Chris@366 1535
Chris@366 1536 EXTERNAL_SEARCH_ID =
Chris@366 1537
Chris@366 1538 # The EXTRA_SEARCH_MAPPINGS tag can be used to enable searching through doxygen
Chris@366 1539 # projects other than the one defined by this configuration file, but that are
Chris@366 1540 # all added to the same external search index. Each project needs to have a
Chris@366 1541 # unique id set via EXTERNAL_SEARCH_ID. The search mapping then maps the id of
Chris@366 1542 # to a relative location where the documentation can be found. The format is:
Chris@366 1543 # EXTRA_SEARCH_MAPPINGS = tagname1=loc1 tagname2=loc2 ...
Chris@366 1544 # This tag requires that the tag SEARCHENGINE is set to YES.
Chris@366 1545
Chris@366 1546 EXTRA_SEARCH_MAPPINGS =
Chris@366 1547
Chris@366 1548 #---------------------------------------------------------------------------
Chris@366 1549 # Configuration options related to the LaTeX output
Chris@366 1550 #---------------------------------------------------------------------------
Chris@366 1551
Chris@366 1552 # If the GENERATE_LATEX tag is set to YES doxygen will generate LaTeX output.
Chris@366 1553 # The default value is: YES.
Chris@366 1554
Chris@366 1555 GENERATE_LATEX = YES
Chris@366 1556
Chris@366 1557 # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
Chris@366 1558 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
Chris@366 1559 # it.
Chris@366 1560 # The default directory is: latex.
Chris@366 1561 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1562
Chris@366 1563 LATEX_OUTPUT = latex
Chris@366 1564
Chris@366 1565 # The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
Chris@366 1566 # invoked.
Chris@366 1567 #
Chris@366 1568 # Note that when enabling USE_PDFLATEX this option is only used for generating
Chris@366 1569 # bitmaps for formulas in the HTML output, but not in the Makefile that is
Chris@366 1570 # written to the output directory.
Chris@366 1571 # The default file is: latex.
Chris@366 1572 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1573
Chris@366 1574 LATEX_CMD_NAME = latex
Chris@366 1575
Chris@366 1576 # The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate
Chris@366 1577 # index for LaTeX.
Chris@366 1578 # The default file is: makeindex.
Chris@366 1579 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1580
Chris@366 1581 MAKEINDEX_CMD_NAME = makeindex
Chris@366 1582
Chris@366 1583 # If the COMPACT_LATEX tag is set to YES doxygen generates more compact LaTeX
Chris@366 1584 # documents. This may be useful for small projects and may help to save some
Chris@366 1585 # trees in general.
Chris@366 1586 # The default value is: NO.
Chris@366 1587 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1588
Chris@366 1589 COMPACT_LATEX = NO
Chris@366 1590
Chris@366 1591 # The PAPER_TYPE tag can be used to set the paper type that is used by the
Chris@366 1592 # printer.
Chris@366 1593 # Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x
Chris@366 1594 # 14 inches) and executive (7.25 x 10.5 inches).
Chris@366 1595 # The default value is: a4.
Chris@366 1596 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1597
Chris@366 1598 PAPER_TYPE = a4
Chris@366 1599
Chris@366 1600 # The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
Chris@366 1601 # that should be included in the LaTeX output. To get the times font for
Chris@366 1602 # instance you can specify
Chris@366 1603 # EXTRA_PACKAGES=times
Chris@366 1604 # If left blank no extra packages will be included.
Chris@366 1605 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1606
Chris@366 1607 EXTRA_PACKAGES =
Chris@366 1608
Chris@366 1609 # The LATEX_HEADER tag can be used to specify a personal LaTeX header for the
Chris@366 1610 # generated LaTeX document. The header should contain everything until the first
Chris@366 1611 # chapter. If it is left blank doxygen will generate a standard header. See
Chris@366 1612 # section "Doxygen usage" for information on how to let doxygen write the
Chris@366 1613 # default header to a separate file.
Chris@366 1614 #
Chris@366 1615 # Note: Only use a user-defined header if you know what you are doing! The
Chris@366 1616 # following commands have a special meaning inside the header: $title,
Chris@366 1617 # $datetime, $date, $doxygenversion, $projectname, $projectnumber. Doxygen will
Chris@366 1618 # replace them by respectively the title of the page, the current date and time,
Chris@366 1619 # only the current date, the version number of doxygen, the project name (see
Chris@366 1620 # PROJECT_NAME), or the project number (see PROJECT_NUMBER).
Chris@366 1621 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1622
Chris@366 1623 LATEX_HEADER =
Chris@366 1624
Chris@366 1625 # The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for the
Chris@366 1626 # generated LaTeX document. The footer should contain everything after the last
Chris@366 1627 # chapter. If it is left blank doxygen will generate a standard footer.
Chris@366 1628 #
Chris@366 1629 # Note: Only use a user-defined footer if you know what you are doing!
Chris@366 1630 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1631
Chris@366 1632 LATEX_FOOTER =
Chris@366 1633
Chris@366 1634 # The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or
Chris@366 1635 # other source files which should be copied to the LATEX_OUTPUT output
Chris@366 1636 # directory. Note that the files will be copied as-is; there are no commands or
Chris@366 1637 # markers available.
Chris@366 1638 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1639
Chris@366 1640 LATEX_EXTRA_FILES =
Chris@366 1641
Chris@366 1642 # If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is
Chris@366 1643 # prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will
Chris@366 1644 # contain links (just like the HTML output) instead of page references. This
Chris@366 1645 # makes the output suitable for online browsing using a PDF viewer.
Chris@366 1646 # The default value is: YES.
Chris@366 1647 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1648
Chris@366 1649 PDF_HYPERLINKS = YES
Chris@366 1650
Chris@366 1651 # If the LATEX_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate
Chris@366 1652 # the PDF file directly from the LaTeX files. Set this option to YES to get a
Chris@366 1653 # higher quality PDF documentation.
Chris@366 1654 # The default value is: YES.
Chris@366 1655 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1656
Chris@366 1657 USE_PDFLATEX = YES
Chris@366 1658
Chris@366 1659 # If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode
Chris@366 1660 # command to the generated LaTeX files. This will instruct LaTeX to keep running
Chris@366 1661 # if errors occur, instead of asking the user for help. This option is also used
Chris@366 1662 # when generating formulas in HTML.
Chris@366 1663 # The default value is: NO.
Chris@366 1664 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1665
Chris@366 1666 LATEX_BATCHMODE = NO
Chris@366 1667
Chris@366 1668 # If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the
Chris@366 1669 # index chapters (such as File Index, Compound Index, etc.) in the output.
Chris@366 1670 # The default value is: NO.
Chris@366 1671 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1672
Chris@366 1673 LATEX_HIDE_INDICES = NO
Chris@366 1674
Chris@366 1675 # If the LATEX_SOURCE_CODE tag is set to YES then doxygen will include source
Chris@366 1676 # code with syntax highlighting in the LaTeX output.
Chris@366 1677 #
Chris@366 1678 # Note that which sources are shown also depends on other settings such as
Chris@366 1679 # SOURCE_BROWSER.
Chris@366 1680 # The default value is: NO.
Chris@366 1681 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1682
Chris@366 1683 LATEX_SOURCE_CODE = NO
Chris@366 1684
Chris@366 1685 # The LATEX_BIB_STYLE tag can be used to specify the style to use for the
Chris@366 1686 # bibliography, e.g. plainnat, or ieeetr. See
Chris@366 1687 # http://en.wikipedia.org/wiki/BibTeX and \cite for more info.
Chris@366 1688 # The default value is: plain.
Chris@366 1689 # This tag requires that the tag GENERATE_LATEX is set to YES.
Chris@366 1690
Chris@366 1691 LATEX_BIB_STYLE = plain
Chris@366 1692
Chris@366 1693 #---------------------------------------------------------------------------
Chris@366 1694 # Configuration options related to the RTF output
Chris@366 1695 #---------------------------------------------------------------------------
Chris@366 1696
Chris@366 1697 # If the GENERATE_RTF tag is set to YES doxygen will generate RTF output. The
Chris@366 1698 # RTF output is optimized for Word 97 and may not look too pretty with other RTF
Chris@366 1699 # readers/editors.
Chris@366 1700 # The default value is: NO.
Chris@366 1701
Chris@366 1702 GENERATE_RTF = NO
Chris@366 1703
Chris@366 1704 # The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a
Chris@366 1705 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
Chris@366 1706 # it.
Chris@366 1707 # The default directory is: rtf.
Chris@366 1708 # This tag requires that the tag GENERATE_RTF is set to YES.
Chris@366 1709
Chris@366 1710 RTF_OUTPUT = rtf
Chris@366 1711
Chris@366 1712 # If the COMPACT_RTF tag is set to YES doxygen generates more compact RTF
Chris@366 1713 # documents. This may be useful for small projects and may help to save some
Chris@366 1714 # trees in general.
Chris@366 1715 # The default value is: NO.
Chris@366 1716 # This tag requires that the tag GENERATE_RTF is set to YES.
Chris@366 1717
Chris@366 1718 COMPACT_RTF = NO
Chris@366 1719
Chris@366 1720 # If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will
Chris@366 1721 # contain hyperlink fields. The RTF file will contain links (just like the HTML
Chris@366 1722 # output) instead of page references. This makes the output suitable for online
Chris@366 1723 # browsing using Word or some other Word compatible readers that support those
Chris@366 1724 # fields.
Chris@366 1725 #
Chris@366 1726 # Note: WordPad (write) and others do not support links.
Chris@366 1727 # The default value is: NO.
Chris@366 1728 # This tag requires that the tag GENERATE_RTF is set to YES.
Chris@366 1729
Chris@366 1730 RTF_HYPERLINKS = NO
Chris@366 1731
Chris@366 1732 # Load stylesheet definitions from file. Syntax is similar to doxygen's config
Chris@366 1733 # file, i.e. a series of assignments. You only have to provide replacements,
Chris@366 1734 # missing definitions are set to their default value.
Chris@366 1735 #
Chris@366 1736 # See also section "Doxygen usage" for information on how to generate the
Chris@366 1737 # default style sheet that doxygen normally uses.
Chris@366 1738 # This tag requires that the tag GENERATE_RTF is set to YES.
Chris@366 1739
Chris@366 1740 RTF_STYLESHEET_FILE =
Chris@366 1741
Chris@366 1742 # Set optional variables used in the generation of an RTF document. Syntax is
Chris@366 1743 # similar to doxygen's config file. A template extensions file can be generated
Chris@366 1744 # using doxygen -e rtf extensionFile.
Chris@366 1745 # This tag requires that the tag GENERATE_RTF is set to YES.
Chris@366 1746
Chris@366 1747 RTF_EXTENSIONS_FILE =
Chris@366 1748
Chris@366 1749 #---------------------------------------------------------------------------
Chris@366 1750 # Configuration options related to the man page output
Chris@366 1751 #---------------------------------------------------------------------------
Chris@366 1752
Chris@366 1753 # If the GENERATE_MAN tag is set to YES doxygen will generate man pages for
Chris@366 1754 # classes and files.
Chris@366 1755 # The default value is: NO.
Chris@366 1756
Chris@366 1757 GENERATE_MAN = NO
Chris@366 1758
Chris@366 1759 # The MAN_OUTPUT tag is used to specify where the man pages will be put. If a
Chris@366 1760 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
Chris@366 1761 # it. A directory man3 will be created inside the directory specified by
Chris@366 1762 # MAN_OUTPUT.
Chris@366 1763 # The default directory is: man.
Chris@366 1764 # This tag requires that the tag GENERATE_MAN is set to YES.
Chris@366 1765
Chris@366 1766 MAN_OUTPUT = man
Chris@366 1767
Chris@366 1768 # The MAN_EXTENSION tag determines the extension that is added to the generated
Chris@366 1769 # man pages. In case the manual section does not start with a number, the number
Chris@366 1770 # 3 is prepended. The dot (.) at the beginning of the MAN_EXTENSION tag is
Chris@366 1771 # optional.
Chris@366 1772 # The default value is: .3.
Chris@366 1773 # This tag requires that the tag GENERATE_MAN is set to YES.
Chris@366 1774
Chris@366 1775 MAN_EXTENSION = .3
Chris@366 1776
Chris@366 1777 # The MAN_SUBDIR tag determines the name of the directory created within
Chris@366 1778 # MAN_OUTPUT in which the man pages are placed. If defaults to man followed by
Chris@366 1779 # MAN_EXTENSION with the initial . removed.
Chris@366 1780 # This tag requires that the tag GENERATE_MAN is set to YES.
Chris@366 1781
Chris@366 1782 MAN_SUBDIR =
Chris@366 1783
Chris@366 1784 # If the MAN_LINKS tag is set to YES and doxygen generates man output, then it
Chris@366 1785 # will generate one additional man file for each entity documented in the real
Chris@366 1786 # man page(s). These additional files only source the real man page, but without
Chris@366 1787 # them the man command would be unable to find the correct page.
Chris@366 1788 # The default value is: NO.
Chris@366 1789 # This tag requires that the tag GENERATE_MAN is set to YES.
Chris@366 1790
Chris@366 1791 MAN_LINKS = NO
Chris@366 1792
Chris@366 1793 #---------------------------------------------------------------------------
Chris@366 1794 # Configuration options related to the XML output
Chris@366 1795 #---------------------------------------------------------------------------
Chris@366 1796
Chris@366 1797 # If the GENERATE_XML tag is set to YES doxygen will generate an XML file that
Chris@366 1798 # captures the structure of the code including all documentation.
Chris@366 1799 # The default value is: NO.
Chris@366 1800
Chris@366 1801 GENERATE_XML = NO
Chris@366 1802
Chris@366 1803 # The XML_OUTPUT tag is used to specify where the XML pages will be put. If a
Chris@366 1804 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
Chris@366 1805 # it.
Chris@366 1806 # The default directory is: xml.
Chris@366 1807 # This tag requires that the tag GENERATE_XML is set to YES.
Chris@366 1808
Chris@366 1809 XML_OUTPUT = xml
Chris@366 1810
Chris@366 1811 # If the XML_PROGRAMLISTING tag is set to YES doxygen will dump the program
Chris@366 1812 # listings (including syntax highlighting and cross-referencing information) to
Chris@366 1813 # the XML output. Note that enabling this will significantly increase the size
Chris@366 1814 # of the XML output.
Chris@366 1815 # The default value is: YES.
Chris@366 1816 # This tag requires that the tag GENERATE_XML is set to YES.
Chris@366 1817
Chris@366 1818 XML_PROGRAMLISTING = YES
Chris@366 1819
Chris@366 1820 #---------------------------------------------------------------------------
Chris@366 1821 # Configuration options related to the DOCBOOK output
Chris@366 1822 #---------------------------------------------------------------------------
Chris@366 1823
Chris@366 1824 # If the GENERATE_DOCBOOK tag is set to YES doxygen will generate Docbook files
Chris@366 1825 # that can be used to generate PDF.
Chris@366 1826 # The default value is: NO.
Chris@366 1827
Chris@366 1828 GENERATE_DOCBOOK = NO
Chris@366 1829
Chris@366 1830 # The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put.
Chris@366 1831 # If a relative path is entered the value of OUTPUT_DIRECTORY will be put in
Chris@366 1832 # front of it.
Chris@366 1833 # The default directory is: docbook.
Chris@366 1834 # This tag requires that the tag GENERATE_DOCBOOK is set to YES.
Chris@366 1835
Chris@366 1836 DOCBOOK_OUTPUT = docbook
Chris@366 1837
Chris@366 1838 #---------------------------------------------------------------------------
Chris@366 1839 # Configuration options for the AutoGen Definitions output
Chris@366 1840 #---------------------------------------------------------------------------
Chris@366 1841
Chris@366 1842 # If the GENERATE_AUTOGEN_DEF tag is set to YES doxygen will generate an AutoGen
Chris@366 1843 # Definitions (see http://autogen.sf.net) file that captures the structure of
Chris@366 1844 # the code including all documentation. Note that this feature is still
Chris@366 1845 # experimental and incomplete at the moment.
Chris@366 1846 # The default value is: NO.
Chris@366 1847
Chris@366 1848 GENERATE_AUTOGEN_DEF = NO
Chris@366 1849
Chris@366 1850 #---------------------------------------------------------------------------
Chris@366 1851 # Configuration options related to the Perl module output
Chris@366 1852 #---------------------------------------------------------------------------
Chris@366 1853
Chris@366 1854 # If the GENERATE_PERLMOD tag is set to YES doxygen will generate a Perl module
Chris@366 1855 # file that captures the structure of the code including all documentation.
Chris@366 1856 #
Chris@366 1857 # Note that this feature is still experimental and incomplete at the moment.
Chris@366 1858 # The default value is: NO.
Chris@366 1859
Chris@366 1860 GENERATE_PERLMOD = NO
Chris@366 1861
Chris@366 1862 # If the PERLMOD_LATEX tag is set to YES doxygen will generate the necessary
Chris@366 1863 # Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI
Chris@366 1864 # output from the Perl module output.
Chris@366 1865 # The default value is: NO.
Chris@366 1866 # This tag requires that the tag GENERATE_PERLMOD is set to YES.
Chris@366 1867
Chris@366 1868 PERLMOD_LATEX = NO
Chris@366 1869
Chris@366 1870 # If the PERLMOD_PRETTY tag is set to YES the Perl module output will be nicely
Chris@366 1871 # formatted so it can be parsed by a human reader. This is useful if you want to
Chris@366 1872 # understand what is going on. On the other hand, if this tag is set to NO the
Chris@366 1873 # size of the Perl module output will be much smaller and Perl will parse it
Chris@366 1874 # just the same.
Chris@366 1875 # The default value is: YES.
Chris@366 1876 # This tag requires that the tag GENERATE_PERLMOD is set to YES.
Chris@366 1877
Chris@366 1878 PERLMOD_PRETTY = YES
Chris@366 1879
Chris@366 1880 # The names of the make variables in the generated doxyrules.make file are
Chris@366 1881 # prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. This is useful
Chris@366 1882 # so different doxyrules.make files included by the same Makefile don't
Chris@366 1883 # overwrite each other's variables.
Chris@366 1884 # This tag requires that the tag GENERATE_PERLMOD is set to YES.
Chris@366 1885
Chris@366 1886 PERLMOD_MAKEVAR_PREFIX =
Chris@366 1887
Chris@366 1888 #---------------------------------------------------------------------------
Chris@366 1889 # Configuration options related to the preprocessor
Chris@366 1890 #---------------------------------------------------------------------------
Chris@366 1891
Chris@366 1892 # If the ENABLE_PREPROCESSING tag is set to YES doxygen will evaluate all
Chris@366 1893 # C-preprocessor directives found in the sources and include files.
Chris@366 1894 # The default value is: YES.
Chris@366 1895
Chris@366 1896 ENABLE_PREPROCESSING = YES
Chris@366 1897
Chris@366 1898 # If the MACRO_EXPANSION tag is set to YES doxygen will expand all macro names
Chris@366 1899 # in the source code. If set to NO only conditional compilation will be
Chris@366 1900 # performed. Macro expansion can be done in a controlled way by setting
Chris@366 1901 # EXPAND_ONLY_PREDEF to YES.
Chris@366 1902 # The default value is: NO.
Chris@366 1903 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
Chris@366 1904
Chris@366 1905 MACRO_EXPANSION = NO
Chris@366 1906
Chris@366 1907 # If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then
Chris@366 1908 # the macro expansion is limited to the macros specified with the PREDEFINED and
Chris@366 1909 # EXPAND_AS_DEFINED tags.
Chris@366 1910 # The default value is: NO.
Chris@366 1911 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
Chris@366 1912
Chris@366 1913 EXPAND_ONLY_PREDEF = NO
Chris@366 1914
Chris@366 1915 # If the SEARCH_INCLUDES tag is set to YES the includes files in the
Chris@366 1916 # INCLUDE_PATH will be searched if a #include is found.
Chris@366 1917 # The default value is: YES.
Chris@366 1918 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
Chris@366 1919
Chris@366 1920 SEARCH_INCLUDES = YES
Chris@366 1921
Chris@366 1922 # The INCLUDE_PATH tag can be used to specify one or more directories that
Chris@366 1923 # contain include files that are not input files but should be processed by the
Chris@366 1924 # preprocessor.
Chris@366 1925 # This tag requires that the tag SEARCH_INCLUDES is set to YES.
Chris@366 1926
Chris@366 1927 INCLUDE_PATH =
Chris@366 1928
Chris@366 1929 # You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
Chris@366 1930 # patterns (like *.h and *.hpp) to filter out the header-files in the
Chris@366 1931 # directories. If left blank, the patterns specified with FILE_PATTERNS will be
Chris@366 1932 # used.
Chris@366 1933 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
Chris@366 1934
Chris@366 1935 INCLUDE_FILE_PATTERNS =
Chris@366 1936
Chris@366 1937 # The PREDEFINED tag can be used to specify one or more macro names that are
Chris@366 1938 # defined before the preprocessor is started (similar to the -D option of e.g.
Chris@366 1939 # gcc). The argument of the tag is a list of macros of the form: name or
Chris@366 1940 # name=definition (no spaces). If the definition and the "=" are omitted, "=1"
Chris@366 1941 # is assumed. To prevent a macro definition from being undefined via #undef or
Chris@366 1942 # recursively expanded use the := operator instead of the = operator.
Chris@366 1943 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
Chris@366 1944
Chris@366 1945 PREDEFINED =
Chris@366 1946
Chris@366 1947 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
Chris@366 1948 # tag can be used to specify a list of macro names that should be expanded. The
Chris@366 1949 # macro definition that is found in the sources will be used. Use the PREDEFINED
Chris@366 1950 # tag if you want to use a different macro definition that overrules the
Chris@366 1951 # definition found in the source code.
Chris@366 1952 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
Chris@366 1953
Chris@366 1954 EXPAND_AS_DEFINED =
Chris@366 1955
Chris@366 1956 # If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will
Chris@366 1957 # remove all references to function-like macros that are alone on a line, have
Chris@366 1958 # an all uppercase name, and do not end with a semicolon. Such function macros
Chris@366 1959 # are typically used for boiler-plate code, and will confuse the parser if not
Chris@366 1960 # removed.
Chris@366 1961 # The default value is: YES.
Chris@366 1962 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
Chris@366 1963
Chris@366 1964 SKIP_FUNCTION_MACROS = YES
Chris@366 1965
Chris@366 1966 #---------------------------------------------------------------------------
Chris@366 1967 # Configuration options related to external references
Chris@366 1968 #---------------------------------------------------------------------------
Chris@366 1969
Chris@366 1970 # The TAGFILES tag can be used to specify one or more tag files. For each tag
Chris@366 1971 # file the location of the external documentation should be added. The format of
Chris@366 1972 # a tag file without this location is as follows:
Chris@366 1973 # TAGFILES = file1 file2 ...
Chris@366 1974 # Adding location for the tag files is done as follows:
Chris@366 1975 # TAGFILES = file1=loc1 "file2 = loc2" ...
Chris@366 1976 # where loc1 and loc2 can be relative or absolute paths or URLs. See the
Chris@366 1977 # section "Linking to external documentation" for more information about the use
Chris@366 1978 # of tag files.
Chris@366 1979 # Note: Each tag file must have a unique name (where the name does NOT include
Chris@366 1980 # the path). If a tag file is not located in the directory in which doxygen is
Chris@366 1981 # run, you must also specify the path to the tagfile here.
Chris@366 1982
Chris@366 1983 TAGFILES =
Chris@366 1984
Chris@366 1985 # When a file name is specified after GENERATE_TAGFILE, doxygen will create a
Chris@366 1986 # tag file that is based on the input files it reads. See section "Linking to
Chris@366 1987 # external documentation" for more information about the usage of tag files.
Chris@366 1988
Chris@366 1989 GENERATE_TAGFILE =
Chris@366 1990
Chris@366 1991 # If the ALLEXTERNALS tag is set to YES all external class will be listed in the
Chris@366 1992 # class index. If set to NO only the inherited external classes will be listed.
Chris@366 1993 # The default value is: NO.
Chris@366 1994
Chris@366 1995 ALLEXTERNALS = NO
Chris@366 1996
Chris@366 1997 # If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed in
Chris@366 1998 # the modules index. If set to NO, only the current project's groups will be
Chris@366 1999 # listed.
Chris@366 2000 # The default value is: YES.
Chris@366 2001
Chris@366 2002 EXTERNAL_GROUPS = YES
Chris@366 2003
Chris@366 2004 # If the EXTERNAL_PAGES tag is set to YES all external pages will be listed in
Chris@366 2005 # the related pages index. If set to NO, only the current project's pages will
Chris@366 2006 # be listed.
Chris@366 2007 # The default value is: YES.
Chris@366 2008
Chris@366 2009 EXTERNAL_PAGES = YES
Chris@366 2010
Chris@366 2011 # The PERL_PATH should be the absolute path and name of the perl script
Chris@366 2012 # interpreter (i.e. the result of 'which perl').
Chris@366 2013 # The default file (with absolute path) is: /usr/bin/perl.
Chris@366 2014
Chris@366 2015 PERL_PATH = /usr/bin/perl
Chris@366 2016
Chris@366 2017 #---------------------------------------------------------------------------
Chris@366 2018 # Configuration options related to the dot tool
Chris@366 2019 #---------------------------------------------------------------------------
Chris@366 2020
Chris@366 2021 # If the CLASS_DIAGRAMS tag is set to YES doxygen will generate a class diagram
Chris@366 2022 # (in HTML and LaTeX) for classes with base or super classes. Setting the tag to
Chris@366 2023 # NO turns the diagrams off. Note that this option also works with HAVE_DOT
Chris@366 2024 # disabled, but it is recommended to install and use dot, since it yields more
Chris@366 2025 # powerful graphs.
Chris@366 2026 # The default value is: YES.
Chris@366 2027
Chris@366 2028 CLASS_DIAGRAMS = YES
Chris@366 2029
Chris@366 2030 # You can define message sequence charts within doxygen comments using the \msc
Chris@366 2031 # command. Doxygen will then run the mscgen tool (see:
Chris@366 2032 # http://www.mcternan.me.uk/mscgen/)) to produce the chart and insert it in the
Chris@366 2033 # documentation. The MSCGEN_PATH tag allows you to specify the directory where
Chris@366 2034 # the mscgen tool resides. If left empty the tool is assumed to be found in the
Chris@366 2035 # default search path.
Chris@366 2036
Chris@366 2037 MSCGEN_PATH =
Chris@366 2038
Chris@366 2039 # You can include diagrams made with dia in doxygen documentation. Doxygen will
Chris@366 2040 # then run dia to produce the diagram and insert it in the documentation. The
Chris@366 2041 # DIA_PATH tag allows you to specify the directory where the dia binary resides.
Chris@366 2042 # If left empty dia is assumed to be found in the default search path.
Chris@366 2043
Chris@366 2044 DIA_PATH =
Chris@366 2045
Chris@366 2046 # If set to YES, the inheritance and collaboration graphs will hide inheritance
Chris@366 2047 # and usage relations if the target is undocumented or is not a class.
Chris@366 2048 # The default value is: YES.
Chris@366 2049
Chris@366 2050 HIDE_UNDOC_RELATIONS = YES
Chris@366 2051
Chris@366 2052 # If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
Chris@366 2053 # available from the path. This tool is part of Graphviz (see:
Chris@366 2054 # http://www.graphviz.org/), a graph visualization toolkit from AT&T and Lucent
Chris@366 2055 # Bell Labs. The other options in this section have no effect if this option is
Chris@366 2056 # set to NO
Chris@366 2057 # The default value is: NO.
Chris@366 2058
Chris@366 2059 HAVE_DOT = NO
Chris@366 2060
Chris@366 2061 # The DOT_NUM_THREADS specifies the number of dot invocations doxygen is allowed
Chris@366 2062 # to run in parallel. When set to 0 doxygen will base this on the number of
Chris@366 2063 # processors available in the system. You can set it explicitly to a value
Chris@366 2064 # larger than 0 to get control over the balance between CPU load and processing
Chris@366 2065 # speed.
Chris@366 2066 # Minimum value: 0, maximum value: 32, default value: 0.
Chris@366 2067 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2068
Chris@366 2069 DOT_NUM_THREADS = 0
Chris@366 2070
Chris@366 2071 # When you want a differently looking font n the dot files that doxygen
Chris@366 2072 # generates you can specify the font name using DOT_FONTNAME. You need to make
Chris@366 2073 # sure dot is able to find the font, which can be done by putting it in a
Chris@366 2074 # standard location or by setting the DOTFONTPATH environment variable or by
Chris@366 2075 # setting DOT_FONTPATH to the directory containing the font.
Chris@366 2076 # The default value is: Helvetica.
Chris@366 2077 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2078
Chris@366 2079 DOT_FONTNAME = Helvetica
Chris@366 2080
Chris@366 2081 # The DOT_FONTSIZE tag can be used to set the size (in points) of the font of
Chris@366 2082 # dot graphs.
Chris@366 2083 # Minimum value: 4, maximum value: 24, default value: 10.
Chris@366 2084 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2085
Chris@366 2086 DOT_FONTSIZE = 10
Chris@366 2087
Chris@366 2088 # By default doxygen will tell dot to use the default font as specified with
Chris@366 2089 # DOT_FONTNAME. If you specify a different font using DOT_FONTNAME you can set
Chris@366 2090 # the path where dot can find it using this tag.
Chris@366 2091 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2092
Chris@366 2093 DOT_FONTPATH =
Chris@366 2094
Chris@366 2095 # If the CLASS_GRAPH tag is set to YES then doxygen will generate a graph for
Chris@366 2096 # each documented class showing the direct and indirect inheritance relations.
Chris@366 2097 # Setting this tag to YES will force the CLASS_DIAGRAMS tag to NO.
Chris@366 2098 # The default value is: YES.
Chris@366 2099 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2100
Chris@366 2101 CLASS_GRAPH = YES
Chris@366 2102
Chris@366 2103 # If the COLLABORATION_GRAPH tag is set to YES then doxygen will generate a
Chris@366 2104 # graph for each documented class showing the direct and indirect implementation
Chris@366 2105 # dependencies (inheritance, containment, and class references variables) of the
Chris@366 2106 # class with other documented classes.
Chris@366 2107 # The default value is: YES.
Chris@366 2108 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2109
Chris@366 2110 COLLABORATION_GRAPH = YES
Chris@366 2111
Chris@366 2112 # If the GROUP_GRAPHS tag is set to YES then doxygen will generate a graph for
Chris@366 2113 # groups, showing the direct groups dependencies.
Chris@366 2114 # The default value is: YES.
Chris@366 2115 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2116
Chris@366 2117 GROUP_GRAPHS = YES
Chris@366 2118
Chris@366 2119 # If the UML_LOOK tag is set to YES doxygen will generate inheritance and
Chris@366 2120 # collaboration diagrams in a style similar to the OMG's Unified Modeling
Chris@366 2121 # Language.
Chris@366 2122 # The default value is: NO.
Chris@366 2123 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2124
Chris@366 2125 UML_LOOK = NO
Chris@366 2126
Chris@366 2127 # If the UML_LOOK tag is enabled, the fields and methods are shown inside the
Chris@366 2128 # class node. If there are many fields or methods and many nodes the graph may
Chris@366 2129 # become too big to be useful. The UML_LIMIT_NUM_FIELDS threshold limits the
Chris@366 2130 # number of items for each type to make the size more manageable. Set this to 0
Chris@366 2131 # for no limit. Note that the threshold may be exceeded by 50% before the limit
Chris@366 2132 # is enforced. So when you set the threshold to 10, up to 15 fields may appear,
Chris@366 2133 # but if the number exceeds 15, the total amount of fields shown is limited to
Chris@366 2134 # 10.
Chris@366 2135 # Minimum value: 0, maximum value: 100, default value: 10.
Chris@366 2136 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2137
Chris@366 2138 UML_LIMIT_NUM_FIELDS = 10
Chris@366 2139
Chris@366 2140 # If the TEMPLATE_RELATIONS tag is set to YES then the inheritance and
Chris@366 2141 # collaboration graphs will show the relations between templates and their
Chris@366 2142 # instances.
Chris@366 2143 # The default value is: NO.
Chris@366 2144 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2145
Chris@366 2146 TEMPLATE_RELATIONS = NO
Chris@366 2147
Chris@366 2148 # If the INCLUDE_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are set to
Chris@366 2149 # YES then doxygen will generate a graph for each documented file showing the
Chris@366 2150 # direct and indirect include dependencies of the file with other documented
Chris@366 2151 # files.
Chris@366 2152 # The default value is: YES.
Chris@366 2153 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2154
Chris@366 2155 INCLUDE_GRAPH = YES
Chris@366 2156
Chris@366 2157 # If the INCLUDED_BY_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are
Chris@366 2158 # set to YES then doxygen will generate a graph for each documented file showing
Chris@366 2159 # the direct and indirect include dependencies of the file with other documented
Chris@366 2160 # files.
Chris@366 2161 # The default value is: YES.
Chris@366 2162 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2163
Chris@366 2164 INCLUDED_BY_GRAPH = YES
Chris@366 2165
Chris@366 2166 # If the CALL_GRAPH tag is set to YES then doxygen will generate a call
Chris@366 2167 # dependency graph for every global function or class method.
Chris@366 2168 #
Chris@366 2169 # Note that enabling this option will significantly increase the time of a run.
Chris@366 2170 # So in most cases it will be better to enable call graphs for selected
Chris@366 2171 # functions only using the \callgraph command.
Chris@366 2172 # The default value is: NO.
Chris@366 2173 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2174
Chris@366 2175 CALL_GRAPH = NO
Chris@366 2176
Chris@366 2177 # If the CALLER_GRAPH tag is set to YES then doxygen will generate a caller
Chris@366 2178 # dependency graph for every global function or class method.
Chris@366 2179 #
Chris@366 2180 # Note that enabling this option will significantly increase the time of a run.
Chris@366 2181 # So in most cases it will be better to enable caller graphs for selected
Chris@366 2182 # functions only using the \callergraph command.
Chris@366 2183 # The default value is: NO.
Chris@366 2184 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2185
Chris@366 2186 CALLER_GRAPH = NO
Chris@366 2187
Chris@366 2188 # If the GRAPHICAL_HIERARCHY tag is set to YES then doxygen will graphical
Chris@366 2189 # hierarchy of all classes instead of a textual one.
Chris@366 2190 # The default value is: YES.
Chris@366 2191 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2192
Chris@366 2193 GRAPHICAL_HIERARCHY = YES
Chris@366 2194
Chris@366 2195 # If the DIRECTORY_GRAPH tag is set to YES then doxygen will show the
Chris@366 2196 # dependencies a directory has on other directories in a graphical way. The
Chris@366 2197 # dependency relations are determined by the #include relations between the
Chris@366 2198 # files in the directories.
Chris@366 2199 # The default value is: YES.
Chris@366 2200 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2201
Chris@366 2202 DIRECTORY_GRAPH = YES
Chris@366 2203
Chris@366 2204 # The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
Chris@366 2205 # generated by dot.
Chris@366 2206 # Note: If you choose svg you need to set HTML_FILE_EXTENSION to xhtml in order
Chris@366 2207 # to make the SVG files visible in IE 9+ (other browsers do not have this
Chris@366 2208 # requirement).
Chris@366 2209 # Possible values are: png, jpg, gif and svg.
Chris@366 2210 # The default value is: png.
Chris@366 2211 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2212
Chris@366 2213 DOT_IMAGE_FORMAT = png
Chris@366 2214
Chris@366 2215 # If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to
Chris@366 2216 # enable generation of interactive SVG images that allow zooming and panning.
Chris@366 2217 #
Chris@366 2218 # Note that this requires a modern browser other than Internet Explorer. Tested
Chris@366 2219 # and working are Firefox, Chrome, Safari, and Opera.
Chris@366 2220 # Note: For IE 9+ you need to set HTML_FILE_EXTENSION to xhtml in order to make
Chris@366 2221 # the SVG files visible. Older versions of IE do not have SVG support.
Chris@366 2222 # The default value is: NO.
Chris@366 2223 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2224
Chris@366 2225 INTERACTIVE_SVG = NO
Chris@366 2226
Chris@366 2227 # The DOT_PATH tag can be used to specify the path where the dot tool can be
Chris@366 2228 # found. If left blank, it is assumed the dot tool can be found in the path.
Chris@366 2229 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2230
Chris@366 2231 DOT_PATH =
Chris@366 2232
Chris@366 2233 # The DOTFILE_DIRS tag can be used to specify one or more directories that
Chris@366 2234 # contain dot files that are included in the documentation (see the \dotfile
Chris@366 2235 # command).
Chris@366 2236 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2237
Chris@366 2238 DOTFILE_DIRS =
Chris@366 2239
Chris@366 2240 # The MSCFILE_DIRS tag can be used to specify one or more directories that
Chris@366 2241 # contain msc files that are included in the documentation (see the \mscfile
Chris@366 2242 # command).
Chris@366 2243
Chris@366 2244 MSCFILE_DIRS =
Chris@366 2245
Chris@366 2246 # The DIAFILE_DIRS tag can be used to specify one or more directories that
Chris@366 2247 # contain dia files that are included in the documentation (see the \diafile
Chris@366 2248 # command).
Chris@366 2249
Chris@366 2250 DIAFILE_DIRS =
Chris@366 2251
Chris@366 2252 # The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of nodes
Chris@366 2253 # that will be shown in the graph. If the number of nodes in a graph becomes
Chris@366 2254 # larger than this value, doxygen will truncate the graph, which is visualized
Chris@366 2255 # by representing a node as a red box. Note that doxygen if the number of direct
Chris@366 2256 # children of the root node in a graph is already larger than
Chris@366 2257 # DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that
Chris@366 2258 # the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
Chris@366 2259 # Minimum value: 0, maximum value: 10000, default value: 50.
Chris@366 2260 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2261
Chris@366 2262 DOT_GRAPH_MAX_NODES = 50
Chris@366 2263
Chris@366 2264 # The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the graphs
Chris@366 2265 # generated by dot. A depth value of 3 means that only nodes reachable from the
Chris@366 2266 # root by following a path via at most 3 edges will be shown. Nodes that lay
Chris@366 2267 # further from the root node will be omitted. Note that setting this option to 1
Chris@366 2268 # or 2 may greatly reduce the computation time needed for large code bases. Also
Chris@366 2269 # note that the size of a graph can be further restricted by
Chris@366 2270 # DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.
Chris@366 2271 # Minimum value: 0, maximum value: 1000, default value: 0.
Chris@366 2272 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2273
Chris@366 2274 MAX_DOT_GRAPH_DEPTH = 0
Chris@366 2275
Chris@366 2276 # Set the DOT_TRANSPARENT tag to YES to generate images with a transparent
Chris@366 2277 # background. This is disabled by default, because dot on Windows does not seem
Chris@366 2278 # to support this out of the box.
Chris@366 2279 #
Chris@366 2280 # Warning: Depending on the platform used, enabling this option may lead to
Chris@366 2281 # badly anti-aliased labels on the edges of a graph (i.e. they become hard to
Chris@366 2282 # read).
Chris@366 2283 # The default value is: NO.
Chris@366 2284 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2285
Chris@366 2286 DOT_TRANSPARENT = NO
Chris@366 2287
Chris@366 2288 # Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output
Chris@366 2289 # files in one run (i.e. multiple -o and -T options on the command line). This
Chris@366 2290 # makes dot run faster, but since only newer versions of dot (>1.8.10) support
Chris@366 2291 # this, this feature is disabled by default.
Chris@366 2292 # The default value is: NO.
Chris@366 2293 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2294
Chris@366 2295 DOT_MULTI_TARGETS = NO
Chris@366 2296
Chris@366 2297 # If the GENERATE_LEGEND tag is set to YES doxygen will generate a legend page
Chris@366 2298 # explaining the meaning of the various boxes and arrows in the dot generated
Chris@366 2299 # graphs.
Chris@366 2300 # The default value is: YES.
Chris@366 2301 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2302
Chris@366 2303 GENERATE_LEGEND = YES
Chris@366 2304
Chris@366 2305 # If the DOT_CLEANUP tag is set to YES doxygen will remove the intermediate dot
Chris@366 2306 # files that are used to generate the various graphs.
Chris@366 2307 # The default value is: YES.
Chris@366 2308 # This tag requires that the tag HAVE_DOT is set to YES.
Chris@366 2309
Chris@366 2310 DOT_CLEANUP = YES