annotate Doxyfile @ 403:eb84b06301da

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