annotate src/libvorbis-1.3.3/doc/Doxyfile.in @ 83:ae30d91d2ffe

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