1# Doxyfile 1.2.12 2 3# This file describes the settings to be used by the documentation system 4# doxygen (www.doxygen.org) for a project 5# 6# All text after a hash (#) is considered a comment and will be ignored 7# The format is: 8# TAG = value [value, ...] 9# For lists items can also be appended using: 10# TAG += value [value, ...] 11# Values that contain spaces should be placed between quotes (" ") 12 13#--------------------------------------------------------------------------- 14# General configuration options 15#--------------------------------------------------------------------------- 16 17# The PROJECT_NAME tag is a single word (or a sequence of words surrounded 18# by quotes) that should identify the project. 19 20PROJECT_NAME = "SIGMA0 Protocol Bindings" 21 22# The PROJECT_NUMBER tag can be used to enter a project or revision number. 23# This could be handy for archiving the generated documentation or 24# if some version control system is used. 25 26PROJECT_NUMBER = 27 28# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) 29# base path where the generated documentation will be put. 30# If a relative path is entered, it will be relative to the location 31# where doxygen was started. If left blank the current directory will be used. 32 33OUTPUT_DIRECTORY = libsigma0 34 35# The OUTPUT_LANGUAGE tag is used to specify the language in which all 36# documentation generated by doxygen is written. Doxygen will use this 37# information to generate all constant output in the proper language. 38# The default language is English, other supported languages are: 39# Brazilian, Chinese, Croatian, Czech, Danish, Dutch, Finnish, French, 40# German, Hungarian, Italian, Japanese, Korean, Norwegian, Polish, 41# Portuguese, Romanian, Russian, Slovak, Slovene, Spanish and Swedish. 42 43OUTPUT_LANGUAGE = English 44 45# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in 46# documentation are documented, even if no documentation was available. 47# Private class members and static file members will be hidden unless 48# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES 49 50EXTRACT_ALL = NO 51 52# If the EXTRACT_PRIVATE tag is set to YES all private members of a class 53# will be included in the documentation. 54 55EXTRACT_PRIVATE = NO 56 57# If the EXTRACT_STATIC tag is set to YES all static members of a file 58# will be included in the documentation. 59 60EXTRACT_STATIC = YES 61 62# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all 63# undocumented members of documented classes, files or namespaces. 64# If set to NO (the default) these members will be included in the 65# various overviews, but no documentation section is generated. 66# This option has no effect if EXTRACT_ALL is enabled. 67 68HIDE_UNDOC_MEMBERS = YES 69 70# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all 71# undocumented classes that are normally visible in the class hierarchy. 72# If set to NO (the default) these class will be included in the various 73# overviews. This option has no effect if EXTRACT_ALL is enabled. 74 75HIDE_UNDOC_CLASSES = YES 76 77# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will 78# include brief member descriptions after the members that are listed in 79# the file and class documentation (similar to JavaDoc). 80# Set to NO to disable this. 81 82BRIEF_MEMBER_DESC = YES 83 84# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend 85# the brief description of a member or function before the detailed description. 86# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the 87# brief descriptions will be completely suppressed. 88 89REPEAT_BRIEF = YES 90 91# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then 92# Doxygen will generate a detailed section even if there is only a brief 93# description. 94 95ALWAYS_DETAILED_SEC = YES 96 97# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full 98# path before files name in the file list and in the header files. If set 99# to NO the shortest path that makes the file name unique will be used. 100 101FULL_PATH_NAMES = NO 102 103# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag 104# can be used to strip a user defined part of the path. Stripping is 105# only done if one of the specified strings matches the left-hand part of 106# the path. It is allowed to use relative paths in the argument list. 107 108STRIP_FROM_PATH = 109 110# The INTERNAL_DOCS tag determines if documentation 111# that is typed after a \internal command is included. If the tag is set 112# to NO (the default) then the documentation will be excluded. 113# Set it to YES to include the internal documentation. 114 115INTERNAL_DOCS = NO 116 117# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct 118# doxygen to hide any special comment blocks from generated source code 119# fragments. Normal C and C++ comments will always remain visible. 120 121STRIP_CODE_COMMENTS = YES 122 123# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate 124# file names in lower case letters. If set to YES upper case letters are also 125# allowed. This is useful if you have classes or files whose names only differ 126# in case and if your file system supports case sensitive file names. Windows 127# users are adviced to set this option to NO. 128 129CASE_SENSE_NAMES = YES 130 131# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter 132# (but less readable) file names. This can be useful is your file systems 133# doesn't support long names like on DOS, Mac, or CD-ROM. 134 135SHORT_NAMES = NO 136 137# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen 138# will show members with their full class and namespace scopes in the 139# documentation. If set to YES the scope will be hidden. 140 141HIDE_SCOPE_NAMES = NO 142 143# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen 144# will generate a verbatim copy of the header file for each class for 145# which an include is specified. Set to NO to disable this. 146 147VERBATIM_HEADERS = YES 148 149# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen 150# will put list of the files that are included by a file in the documentation 151# of that file. 152 153SHOW_INCLUDE_FILES = NO 154 155# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen 156# will interpret the first line (until the first dot) of a JavaDoc-style 157# comment as the brief description. If set to NO, the JavaDoc 158# comments will behave just like the Qt-style comments (thus requiring an 159# explict @brief command for a brief description. 160 161JAVADOC_AUTOBRIEF = NO 162 163# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented 164# member inherits the documentation from any documented member that it 165# reimplements. 166 167INHERIT_DOCS = YES 168 169# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] 170# is inserted in the documentation for inline members. 171 172INLINE_INFO = YES 173 174# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen 175# will sort the (detailed) documentation of file and class members 176# alphabetically by member name. If set to NO the members will appear in 177# declaration order. 178 179SORT_MEMBER_DOCS = NO 180 181# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC 182# tag is set to YES, then doxygen will reuse the documentation of the first 183# member in the group (if any) for the other members of the group. By default 184# all members of a group must be documented explicitly. 185 186DISTRIBUTE_GROUP_DOC = NO 187 188# The TAB_SIZE tag can be used to set the number of spaces in a tab. 189# Doxygen uses this value to replace tabs by spaces in code fragments. 190 191TAB_SIZE = 2 192 193# The GENERATE_TODOLIST tag can be used to enable (YES) or 194# disable (NO) the todo list. This list is created by putting \todo 195# commands in the documentation. 196 197GENERATE_TODOLIST = NO 198 199# The GENERATE_TESTLIST tag can be used to enable (YES) or 200# disable (NO) the test list. This list is created by putting \test 201# commands in the documentation. 202 203GENERATE_TESTLIST = NO 204 205# The GENERATE_BUGLIST tag can be used to enable (YES) or 206# disable (NO) the bug list. This list is created by putting \bug 207# commands in the documentation. 208 209GENERATE_BUGLIST = YES 210 211# This tag can be used to specify a number of aliases that acts 212# as commands in the documentation. An alias has the form "name=value". 213# For example adding "sideeffect=\par Side Effects:\n" will allow you to 214# put the command \sideeffect (or @sideeffect) in the documentation, which 215# will result in a user defined paragraph with heading "Side Effects:". 216# You can put \n's in the value part of an alias to insert newlines. 217 218ALIASES = 219 220# The ENABLED_SECTIONS tag can be used to enable conditional 221# documentation sections, marked by \if sectionname ... \endif. 222 223ENABLED_SECTIONS = 224 225# The MAX_INITIALIZER_LINES tag determines the maximum number of lines 226# the initial value of a variable or define consist of for it to appear in 227# the documentation. If the initializer consists of more lines than specified 228# here it will be hidden. Use a value of 0 to hide initializers completely. 229# The appearance of the initializer of individual variables and defines in the 230# documentation can be controlled using \showinitializer or \hideinitializer 231# command in the documentation regardless of this setting. 232 233MAX_INITIALIZER_LINES = 30 234 235# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources 236# only. Doxygen will then generate output that is more tailored for C. 237# For instance some of the names that are used will be different. The list 238# of all members will be omitted, etc. 239 240OPTIMIZE_OUTPUT_FOR_C = YES 241 242# Set the SHOW_USED_FILES tag to NO to disable the list of files generated 243# at the bottom of the documentation of classes and structs. If set to YES the 244# list will mention the files that were used to generate the documentation. 245 246SHOW_USED_FILES = YES 247 248#--------------------------------------------------------------------------- 249# configuration options related to warning and progress messages 250#--------------------------------------------------------------------------- 251 252# The QUIET tag can be used to turn on/off the messages that are generated 253# by doxygen. Possible values are YES and NO. If left blank NO is used. 254 255QUIET = YES 256 257# The WARNINGS tag can be used to turn on/off the warning messages that are 258# generated by doxygen. Possible values are YES and NO. If left blank 259# NO is used. 260 261WARNINGS = NO 262 263# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings 264# for undocumented members. If EXTRACT_ALL is set to YES then this flag will 265# automatically be disabled. 266 267WARN_IF_UNDOCUMENTED = YES 268 269# The WARN_FORMAT tag determines the format of the warning messages that 270# doxygen can produce. The string should contain the $file, $line, and $text 271# tags, which will be replaced by the file and line number from which the 272# warning originated and the warning text. 273 274WARN_FORMAT = 275 276# The WARN_LOGFILE tag can be used to specify a file to which warning 277# and error messages should be written. If left blank the output is written 278# to stderr. 279 280WARN_LOGFILE = 281 282#--------------------------------------------------------------------------- 283# configuration options related to the input files 284#--------------------------------------------------------------------------- 285 286# The INPUT tag can be used to specify the files and/or directories that contain 287# documented source files. You may enter file names like "myfile.cpp" or 288# directories like "/usr/src/myproject". Separate the files or directories 289# with spaces. 290 291@INCLUDE = $(L4DIR)/pkg/libsigma0/doc/files.cfg 292 293# If the value of the INPUT tag contains directories, you can use the 294# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 295# and *.h) to filter out the source-files in the directories. If left 296# blank file matching one of the following patterns are included: 297# *.c *.cc *.cxx *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx *.hpp 298# *.h++ *.idl 299 300FILE_PATTERNS = *.h 301 302# The RECURSIVE tag can be used to turn specify whether or not subdirectories 303# should be searched for input files as well. Possible values are YES and NO. 304# If left blank NO is used. 305 306RECURSIVE = YES 307 308# The EXCLUDE tag can be used to specify files and/or directories that should 309# excluded from the INPUT source files. This way you can easily exclude a 310# subdirectory from a directory tree whose root is specified with the INPUT tag. 311 312EXCLUDE = 313 314# If the value of the INPUT tag contains directories, you can use the 315# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude 316# certain files from those directories. 317 318EXCLUDE_PATTERNS = *-server.h *-client.h *include/l4/dm_*/*-sys.h 319 320# The EXAMPLE_PATH tag can be used to specify one or more files or 321# directories that contain example code fragments that are included (see 322# the \include command). 323 324EXAMPLE_PATH = 325 326# If the value of the EXAMPLE_PATH tag contains directories, you can use the 327# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 328# and *.h) to filter out the source-files in the directories. If left 329# blank all files are included. 330 331EXAMPLE_PATTERNS = 332 333# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be 334# searched for input files to be used with the \include or \dontinclude 335# commands irrespective of the value of the RECURSIVE tag. 336# Possible values are YES and NO. If left blank NO is used. 337 338EXAMPLE_RECURSIVE = NO 339 340# The IMAGE_PATH tag can be used to specify one or more files or 341# directories that contain image that are included in the documentation (see 342# the \image command). 343 344IMAGE_PATH = 345 346# The INPUT_FILTER tag can be used to specify a program that doxygen should 347# invoke to filter for each input file. Doxygen will invoke the filter program 348# by executing (via popen()) the command <filter> <input-file>, where <filter> 349# is the value of the INPUT_FILTER tag, and <input-file> is the name of an 350# input file. Doxygen will then use the output that the filter program writes 351# to standard output. 352 353INPUT_FILTER = 354 355# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using 356# INPUT_FILTER) will be used to filter the input files when producing source 357# files to browse. 358 359FILTER_SOURCE_FILES = NO 360 361#--------------------------------------------------------------------------- 362# configuration options related to source browsing 363#--------------------------------------------------------------------------- 364 365# If the SOURCE_BROWSER tag is set to YES then a list of source files will 366# be generated. Documented entities will be cross-referenced with these sources. 367 368SOURCE_BROWSER = YES 369 370# Setting the INLINE_SOURCES tag to YES will include the body 371# of functions and classes directly in the documentation. 372 373INLINE_SOURCES = NO 374 375# If the REFERENCED_BY_RELATION tag is set to YES (the default) 376# then for each documented function all documented 377# functions referencing it will be listed. 378 379REFERENCED_BY_RELATION = YES 380 381# If the REFERENCES_RELATION tag is set to YES (the default) 382# then for each documented function all documented entities 383# called/used by that function will be listed. 384 385REFERENCES_RELATION = YES 386 387#--------------------------------------------------------------------------- 388# configuration options related to the alphabetical class index 389#--------------------------------------------------------------------------- 390 391# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index 392# of all compounds will be generated. Enable this if the project 393# contains a lot of classes, structs, unions or interfaces. 394 395ALPHABETICAL_INDEX = NO 396 397# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then 398# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns 399# in which this list will be split (can be a number in the range [1..20]) 400 401COLS_IN_ALPHA_INDEX = 5 402 403# In case all classes in a project start with a common prefix, all 404# classes will be put under the same header in the alphabetical index. 405# The IGNORE_PREFIX tag can be used to specify one or more prefixes that 406# should be ignored while generating the index headers. 407 408IGNORE_PREFIX = 409 410#--------------------------------------------------------------------------- 411# configuration options related to the HTML output 412#--------------------------------------------------------------------------- 413 414# If the GENERATE_HTML tag is set to YES (the default) Doxygen will 415# generate HTML output. 416 417GENERATE_HTML = YES 418 419# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. 420# If a relative path is entered the value of OUTPUT_DIRECTORY will be 421# put in front of it. If left blank `html' will be used as the default path. 422 423HTML_OUTPUT = html 424 425# The HTML_HEADER tag can be used to specify a personal HTML header for 426# each generated HTML page. If it is left blank doxygen will generate a 427# standard header. 428 429HTML_HEADER = 430 431# The HTML_FOOTER tag can be used to specify a personal HTML footer for 432# each generated HTML page. If it is left blank doxygen will generate a 433# standard footer. 434 435HTML_FOOTER = 436 437# The HTML_STYLESHEET tag can be used to specify a user defined cascading 438# style sheet that is used by each HTML page. It can be used to 439# fine-tune the look of the HTML output. If the tag is left blank doxygen 440# will generate a default style sheet 441 442HTML_STYLESHEET = 443 444# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, 445# files or namespaces will be aligned in HTML using tables. If set to 446# NO a bullet list will be used. 447 448HTML_ALIGN_MEMBERS = YES 449 450# If the GENERATE_HTMLHELP tag is set to YES, additional index files 451# will be generated that can be used as input for tools like the 452# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) 453# of the generated HTML documentation. 454 455GENERATE_HTMLHELP = NO 456 457# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag 458# controls if a separate .chi index file is generated (YES) or that 459# it should be included in the master .chm file (NO). 460 461GENERATE_CHI = NO 462 463# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag 464# controls whether a binary table of contents is generated (YES) or a 465# normal table of contents (NO) in the .chm file. 466 467BINARY_TOC = NO 468 469# The TOC_EXPAND flag can be set to YES to add extra items for group members 470# to the contents of the Html help documentation and to the tree view. 471 472TOC_EXPAND = NO 473 474# The DISABLE_INDEX tag can be used to turn on/off the condensed index at 475# top of each HTML page. The value NO (the default) enables the index and 476# the value YES disables it. 477 478DISABLE_INDEX = YES 479 480# This tag can be used to set the number of enum values (range [1..20]) 481# that doxygen will group on one line in the generated HTML documentation. 482 483ENUM_VALUES_PER_LINE = 4 484 485# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be 486# generated containing a tree-like index structure (just like the one that 487# is generated for HTML Help). For this to work a browser that supports 488# JavaScript and frames is required (for instance Mozilla, Netscape 4.0+, 489# or Internet explorer 4.0+). Note that for large projects the tree generation 490# can take a very long time. In such cases it is better to disable this feature. 491# Windows users are probably better off using the HTML help feature. 492 493GENERATE_TREEVIEW = NO 494 495# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 496# used to set the initial width (in pixels) of the frame in which the tree 497# is shown. 498 499TREEVIEW_WIDTH = 250 500 501#--------------------------------------------------------------------------- 502# configuration options related to the LaTeX output 503#--------------------------------------------------------------------------- 504 505# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will 506# generate Latex output. 507 508GENERATE_LATEX = NO 509 510# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. 511# If a relative path is entered the value of OUTPUT_DIRECTORY will be 512# put in front of it. If left blank `latex' will be used as the default path. 513 514LATEX_OUTPUT = latex 515 516# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact 517# LaTeX documents. This may be useful for small projects and may help to 518# save some trees in general. 519 520COMPACT_LATEX = YES 521 522# The PAPER_TYPE tag can be used to set the paper type that is used 523# by the printer. Possible values are: a4, a4wide, letter, legal and 524# executive. If left blank a4wide will be used. 525 526PAPER_TYPE = a4wide 527 528# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX 529# packages that should be included in the LaTeX output. 530 531EXTRA_PACKAGES = 532 533# The LATEX_HEADER tag can be used to specify a personal LaTeX header for 534# the generated latex document. The header should contain everything until 535# the first chapter. If it is left blank doxygen will generate a 536# standard header. Notice: only use this tag if you know what you are doing! 537 538LATEX_HEADER = 539 540# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated 541# is prepared for conversion to pdf (using ps2pdf). The pdf file will 542# contain links (just like the HTML output) instead of page references 543# This makes the output suitable for online browsing using a pdf viewer. 544 545PDF_HYPERLINKS = YES 546 547# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of 548# plain latex in the generated Makefile. Set this option to YES to get a 549# higher quality PDF documentation. 550 551USE_PDFLATEX = NO 552 553# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. 554# command to the generated LaTeX files. This will instruct LaTeX to keep 555# running if errors occur, instead of asking the user for help. 556# This option is also used when generating formulas in HTML. 557 558LATEX_BATCHMODE = NO 559 560#--------------------------------------------------------------------------- 561# configuration options related to the RTF output 562#--------------------------------------------------------------------------- 563 564# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output 565# The RTF output is optimised for Word 97 and may not look very pretty with 566# other RTF readers or editors. 567 568GENERATE_RTF = NO 569 570# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. 571# If a relative path is entered the value of OUTPUT_DIRECTORY will be 572# put in front of it. If left blank `rtf' will be used as the default path. 573 574RTF_OUTPUT = rtf 575 576# If the COMPACT_RTF tag is set to YES Doxygen generates more compact 577# RTF documents. This may be useful for small projects and may help to 578# save some trees in general. 579 580COMPACT_RTF = NO 581 582# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated 583# will contain hyperlink fields. The RTF file will 584# contain links (just like the HTML output) instead of page references. 585# This makes the output suitable for online browsing using WORD or other 586# programs which support those fields. 587# Note: wordpad (write) and others do not support links. 588 589RTF_HYPERLINKS = NO 590 591# Load stylesheet definitions from file. Syntax is similar to doxygen's 592# config file, i.e. a series of assigments. You only have to provide 593# replacements, missing definitions are set to their default value. 594 595RTF_STYLESHEET_FILE = 596 597# Set optional variables used in the generation of an rtf document. 598# Syntax is similar to doxygen's config file. 599 600RTF_EXTENSIONS_FILE = 601 602#--------------------------------------------------------------------------- 603# configuration options related to the man page output 604#--------------------------------------------------------------------------- 605 606# If the GENERATE_MAN tag is set to YES (the default) Doxygen will 607# generate man pages 608 609GENERATE_MAN = NO 610 611# The MAN_OUTPUT tag is used to specify where the man pages will be put. 612# If a relative path is entered the value of OUTPUT_DIRECTORY will be 613# put in front of it. If left blank `man' will be used as the default path. 614 615MAN_OUTPUT = 616 617# The MAN_EXTENSION tag determines the extension that is added to 618# the generated man pages (default is the subroutine's section .3) 619 620MAN_EXTENSION = 621 622# If the MAN_LINKS tag is set to YES and Doxygen generates man output, 623# then it will generate one additional man file for each entity 624# documented in the real man page(s). These additional files 625# only source the real man page, but without them the man command 626# would be unable to find the correct page. The default is NO. 627 628MAN_LINKS = NO 629 630#--------------------------------------------------------------------------- 631# configuration options related to the XML output 632#--------------------------------------------------------------------------- 633 634# If the GENERATE_XML tag is set to YES Doxygen will 635# generate an XML file that captures the structure of 636# the code including all documentation. Note that this 637# feature is still experimental and incomplete at the 638# moment. 639 640GENERATE_XML = NO 641 642#--------------------------------------------------------------------------- 643# Configuration options related to the preprocessor 644#--------------------------------------------------------------------------- 645 646# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will 647# evaluate all C-preprocessor directives found in the sources and include 648# files. 649 650ENABLE_PREPROCESSING = YES 651 652# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro 653# names in the source code. If set to NO (the default) only conditional 654# compilation will be performed. Macro expansion can be done in a controlled 655# way by setting EXPAND_ONLY_PREDEF to YES. 656 657MACRO_EXPANSION = NO 658 659# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES 660# then the macro expansion is limited to the macros specified with the 661# PREDEFINED and EXPAND_AS_PREDEFINED tags. 662 663EXPAND_ONLY_PREDEF = NO 664 665# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files 666# in the INCLUDE_PATH (see below) will be search if a #include is found. 667 668SEARCH_INCLUDES = YES 669 670# The INCLUDE_PATH tag can be used to specify one or more directories that 671# contain include files that are not input files but should be processed by 672# the preprocessor. 673 674INCLUDE_PATH = 675 676# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard 677# patterns (like *.h and *.hpp) to filter out the header-files in the 678# directories. If left blank, the patterns specified with FILE_PATTERNS will 679# be used. 680 681INCLUDE_FILE_PATTERNS = 682 683# The PREDEFINED tag can be used to specify one or more macro names that 684# are defined before the preprocessor is started (similar to the -D option of 685# gcc). The argument of the tag is a list of macros of the form: name 686# or name=definition (no spaces). If the definition and the = are 687# omitted =1 is assumed. 688 689PREDEFINED = 690 691# If the MACRO_EXPANSION and EXPAND_PREDEF_ONLY tags are set to YES then 692# this tag can be used to specify a list of macro names that should be expanded. 693# The macro definition that is found in the sources will be used. 694# Use the PREDEFINED tag if you want to use a different macro definition. 695 696EXPAND_AS_DEFINED = 697 698# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then 699# doxygen's preprocessor will remove all function-like macros that are alone 700# on a line and do not end with a semicolon. Such function macros are typically 701# used for boiler-plate code, and will confuse the parser if not removed. 702 703SKIP_FUNCTION_MACROS = YES 704 705#--------------------------------------------------------------------------- 706# Configuration::addtions related to external references 707#--------------------------------------------------------------------------- 708 709# The TAGFILES tag can be used to specify one or more tagfiles. 710 711TAGFILES = 712 713# When a file name is specified after GENERATE_TAGFILE, doxygen will create 714# a tag file that is based on the input files it reads. 715 716GENERATE_TAGFILE = 717 718# If the ALLEXTERNALS tag is set to YES all external classes will be listed 719# in the class index. If set to NO only the inherited external classes 720# will be listed. 721 722ALLEXTERNALS = NO 723 724# The PERL_PATH should be the absolute path and name of the perl script 725# interpreter (i.e. the result of `which perl'). 726 727PERL_PATH = 728 729#--------------------------------------------------------------------------- 730# Configuration options related to the dot tool 731#--------------------------------------------------------------------------- 732 733# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will 734# generate a inheritance diagram (in Html, RTF and LaTeX) for classes with base or 735# super classes. Setting the tag to NO turns the diagrams off. Note that this 736# option is superceded by the HAVE_DOT option below. This is only a fallback. It is 737# recommended to install and use dot, since it yield more powerful graphs. 738 739CLASS_DIAGRAMS = NO 740 741# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is 742# available from the path. This tool is part of Graphviz, a graph visualization 743# toolkit from AT&T and Lucent Bell Labs. The other options in this section 744# have no effect if this option is set to NO (the default) 745 746HAVE_DOT = NO 747 748# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen 749# will generate a graph for each documented class showing the direct and 750# indirect inheritance relations. Setting this tag to YES will force the 751# the CLASS_DIAGRAMS tag to NO. 752 753CLASS_GRAPH = YES 754 755# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen 756# will generate a graph for each documented class showing the direct and 757# indirect implementation dependencies (inheritance, containment, and 758# class references variables) of the class with other documented classes. 759 760COLLABORATION_GRAPH = YES 761 762# If set to YES, the inheritance and collaboration graphs will show the 763# relations between templates and their instances. 764 765TEMPLATE_RELATIONS = YES 766 767# If set to YES, the inheritance and collaboration graphs will hide 768# inheritance and usage relations if the target is undocumented 769# or is not a class. 770 771HIDE_UNDOC_RELATIONS = YES 772 773# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT 774# tags are set to YES then doxygen will generate a graph for each documented 775# file showing the direct and indirect include dependencies of the file with 776# other documented files. 777 778INCLUDE_GRAPH = YES 779 780# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and 781# HAVE_DOT tags are set to YES then doxygen will generate a graph for each 782# documented header file showing the documented files that directly or 783# indirectly include this file. 784 785INCLUDED_BY_GRAPH = YES 786 787# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen 788# will graphical hierarchy of all classes instead of a textual one. 789 790GRAPHICAL_HIERARCHY = YES 791 792# The tag DOT_PATH can be used to specify the path where the dot tool can be 793# found. If left blank, it is assumed the dot tool can be found on the path. 794 795DOT_PATH = 796 797# The DOTFILE_DIRS tag can be used to specify one or more directories that 798# contain dot files that are included in the documentation (see the 799# \dotfile command). 800 801DOTFILE_DIRS = 802 803# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width 804# (in pixels) of the graphs generated by dot. If a graph becomes larger than 805# this value, doxygen will try to truncate the graph, so that it fits within 806# the specified constraint. Beware that most browsers cannot cope with very 807# large images. 808 809MAX_DOT_GRAPH_WIDTH = 1024 810 811# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height 812# (in pixels) of the graphs generated by dot. If a graph becomes larger than 813# this value, doxygen will try to truncate the graph, so that it fits within 814# the specified constraint. Beware that most browsers cannot cope with very 815# large images. 816 817MAX_DOT_GRAPH_HEIGHT = 1024 818 819# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will 820# generate a legend page explaining the meaning of the various boxes and 821# arrows in the dot generated graphs. 822 823GENERATE_LEGEND = YES 824 825# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will 826# remove the intermedate dot files that are used to generate 827# the various graphs. 828 829DOT_CLEANUP = YES 830 831#--------------------------------------------------------------------------- 832# Configuration::addtions related to the search engine 833#--------------------------------------------------------------------------- 834 835# The SEARCHENGINE tag specifies whether or not a search engine should be 836# used. If set to NO the values of all tags below this one will be ignored. 837 838SEARCHENGINE = NO 839 840# The CGI_NAME tag should be the name of the CGI script that 841# starts the search engine (doxysearch) with the correct parameters. 842# A script with this name will be generated by doxygen. 843 844