comparison Doxyfile @ 54:933fee59d33a

* doc updates
author cannam
date Fri, 30 Mar 2007 17:14:16 +0000
parents 74822738965b
children 0f8524203677
comparison
equal deleted inserted replaced
53:74822738965b 54:933fee59d33a
136 # will interpret the first line (until the first dot) of a JavaDoc-style 136 # will interpret the first line (until the first dot) of a JavaDoc-style
137 # comment as the brief description. If set to NO, the JavaDoc 137 # comment as the brief description. If set to NO, the JavaDoc
138 # comments will behave just like the Qt-style comments (thus requiring an 138 # comments will behave just like the Qt-style comments (thus requiring an
139 # explicit @brief command for a brief description. 139 # explicit @brief command for a brief description.
140 140
141 JAVADOC_AUTOBRIEF = NO 141 JAVADOC_AUTOBRIEF = YES
142 142
143 # The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen 143 # The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen
144 # treat a multi-line C++ special comment block (i.e. a block of //! or /// 144 # treat a multi-line C++ special comment block (i.e. a block of //! or ///
145 # comments) as a brief description. This used to be the default behaviour. 145 # comments) as a brief description. This used to be the default behaviour.
146 # The new default is to treat a multi-line C++ comment block as a detailed 146 # The new default is to treat a multi-line C++ comment block as a detailed
151 # If the DETAILS_AT_TOP tag is set to YES then Doxygen 151 # If the DETAILS_AT_TOP tag is set to YES then Doxygen
152 # will output the detailed description near the top, like JavaDoc. 152 # will output the detailed description near the top, like JavaDoc.
153 # If set to NO, the detailed description appears after the member 153 # If set to NO, the detailed description appears after the member
154 # documentation. 154 # documentation.
155 155
156 DETAILS_AT_TOP = NO 156 DETAILS_AT_TOP = YES
157 157
158 # If the INHERIT_DOCS tag is set to YES (the default) then an undocumented 158 # If the INHERIT_DOCS tag is set to YES (the default) then an undocumented
159 # member inherits the documentation from any documented member that it 159 # member inherits the documentation from any documented member that it
160 # re-implements. 160 # re-implements.
161 161
448 # The INPUT tag can be used to specify the files and/or directories that contain 448 # The INPUT tag can be used to specify the files and/or directories that contain
449 # documented source files. You may enter file names like "myfile.cpp" or 449 # documented source files. You may enter file names like "myfile.cpp" or
450 # directories like "/usr/src/myproject". Separate the files or directories 450 # directories like "/usr/src/myproject". Separate the files or directories
451 # with spaces. 451 # with spaces.
452 452
453 INPUT = vamp vamp-sdk 453 INPUT = vamp vamp-sdk examples host
454 454
455 # If the value of the INPUT tag contains directories, you can use the 455 # If the value of the INPUT tag contains directories, you can use the
456 # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 456 # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
457 # and *.h) to filter out the source-files in the directories. If left 457 # and *.h) to filter out the source-files in the directories. If left
458 # blank the following patterns are tested: 458 # blank the following patterns are tested:
460 # *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm 460 # *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm
461 461
462 FILE_PATTERNS = *.h \ 462 FILE_PATTERNS = *.h \
463 *.C \ 463 *.C \
464 *.cpp \ 464 *.cpp \
465 *.cc 465 *.cc \
466 doc-overview
466 467
467 # The RECURSIVE tag can be used to turn specify whether or not subdirectories 468 # The RECURSIVE tag can be used to turn specify whether or not subdirectories
468 # should be searched for input files as well. Possible values are YES and NO. 469 # should be searched for input files as well. Possible values are YES and NO.
469 # If left blank NO is used. 470 # If left blank NO is used.
470 471
471 RECURSIVE = YES 472 RECURSIVE = NO
472 473
473 # The EXCLUDE tag can be used to specify files and/or directories that should 474 # The EXCLUDE tag can be used to specify files and/or directories that should
474 # excluded from the INPUT source files. This way you can easily exclude a 475 # excluded from the INPUT source files. This way you can easily exclude a
475 # subdirectory from a directory tree whose root is specified with the INPUT tag. 476 # subdirectory from a directory tree whose root is specified with the INPUT tag.
476 477
486 # EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude 487 # EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
487 # certain files from those directories. Note that the wildcards are matched 488 # certain files from those directories. Note that the wildcards are matched
488 # against the file with absolute path, so to exclude all test directories 489 # against the file with absolute path, so to exclude all test directories
489 # for example use the pattern */test/* 490 # for example use the pattern */test/*
490 491
491 EXCLUDE_PATTERNS = *.moc.cpp \ 492 EXCLUDE_PATTERNS = qrc_*.cpp \
493 moc_*.cpp \
494 *.moc.cpp \
492 *_skel.cpp 495 *_skel.cpp
493 496
494 # The EXAMPLE_PATH tag can be used to specify one or more files or 497 # The EXAMPLE_PATH tag can be used to specify one or more files or
495 # directories that contain example code fragments that are included (see 498 # directories that contain example code fragments that are included (see
496 # the \include command). 499 # the \include command).
580 # will point to the HTML generated by the htags(1) tool instead of doxygen 583 # will point to the HTML generated by the htags(1) tool instead of doxygen
581 # built-in source browser. The htags tool is part of GNU's global source 584 # built-in source browser. The htags tool is part of GNU's global source
582 # tagging system (see http://www.gnu.org/software/global/global.html). You 585 # tagging system (see http://www.gnu.org/software/global/global.html). You
583 # will need version 4.8.6 or higher. 586 # will need version 4.8.6 or higher.
584 587
585 USE_HTAGS = NO 588 #USE_HTAGS = NO
586 589
587 # If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen 590 # If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen
588 # will generate a verbatim copy of the header file for each class for 591 # will generate a verbatim copy of the header file for each class for
589 # which an include is specified. Set to NO to disable this. 592 # which an include is specified. Set to NO to disable this.
590 593
602 605
603 # If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then 606 # If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then
604 # the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns 607 # the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns
605 # in which this list will be split (can be a number in the range [1..20]) 608 # in which this list will be split (can be a number in the range [1..20])
606 609
607 COLS_IN_ALPHA_INDEX = 5 610 COLS_IN_ALPHA_INDEX = 3
608 611
609 # In case all classes in a project start with a common prefix, all 612 # In case all classes in a project start with a common prefix, all
610 # classes will be put under the same header in the alphabetical index. 613 # classes will be put under the same header in the alphabetical index.
611 # The IGNORE_PREFIX tag can be used to specify one or more prefixes that 614 # The IGNORE_PREFIX tag can be used to specify one or more prefixes that
612 # should be ignored while generating the index headers. 615 # should be ignored while generating the index headers.
715 # is generated for HTML Help). For this to work a browser that supports 718 # is generated for HTML Help). For this to work a browser that supports
716 # JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, 719 # JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+,
717 # Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are 720 # Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are
718 # probably better off using the HTML help feature. 721 # probably better off using the HTML help feature.
719 722
720 GENERATE_TREEVIEW = NO 723 GENERATE_TREEVIEW = YES
721 724
722 # If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 725 # If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be
723 # used to set the initial width (in pixels) of the frame in which the tree 726 # used to set the initial width (in pixels) of the frame in which the tree
724 # is shown. 727 # is shown.
725 728
975 EXPAND_ONLY_PREDEF = NO 978 EXPAND_ONLY_PREDEF = NO
976 979
977 # If the SEARCH_INCLUDES tag is set to YES (the default) the includes files 980 # If the SEARCH_INCLUDES tag is set to YES (the default) the includes files
978 # in the INCLUDE_PATH (see below) will be search if a #include is found. 981 # in the INCLUDE_PATH (see below) will be search if a #include is found.
979 982
980 SEARCH_INCLUDES = YES 983 SEARCH_INCLUDES = NO
981 984
982 # The INCLUDE_PATH tag can be used to specify one or more directories that 985 # The INCLUDE_PATH tag can be used to specify one or more directories that
983 # contain include files that are not input files but should be processed by 986 # contain include files that are not input files but should be processed by
984 # the preprocessor. 987 # the preprocessor.
985 988
986 INCLUDE_PATH = 989 INCLUDE_PATH =
987 990
988 # You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard 991 # You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
989 # patterns (like *.h and *.hpp) to filter out the header-files in the 992 # patterns (like *.h and *.hpp) to filter out the header-files in the
990 # directories. If left blank, the patterns specified with FILE_PATTERNS will 993 # directories. If left blank, the patterns specified with FILE_PATTERNS will
991 # be used. 994 # be used.
992 995
993 INCLUDE_FILE_PATTERNS = 996 INCLUDE_FILE_PATTERNS =
994 997
995 # The PREDEFINED tag can be used to specify one or more macro names that 998 # The PREDEFINED tag can be used to specify one or more macro names that
996 # are defined before the preprocessor is started (similar to the -D option of 999 # are defined before the preprocessor is started (similar to the -D option of
997 # gcc). The argument of the tag is a list of macros of the form: name 1000 # gcc). The argument of the tag is a list of macros of the form: name
998 # or name=definition (no spaces). If the definition and the = are 1001 # or name=definition (no spaces). If the definition and the = are
999 # omitted =1 is assumed. To prevent a macro definition from being 1002 # omitted =1 is assumed. To prevent a macro definition from being
1000 # undefined via #undef or recursively expanded use the := operator 1003 # undefined via #undef or recursively expanded use the := operator
1001 # instead of the = operator. 1004 # instead of the = operator.
1002 1005
1003 PREDEFINED = HAVE_ALSA HAVE_LIBJACK HAVE_DSSI HAVE_LADSPA HAVE_LIBLO HAVE_LIBLRDF HAVE_XFT HAVE_LIRC 1006 PREDEFINED = HAVE_FFTW3F HAVE_FISHSOUND HAVE_JACK HAVE_LIBLO HAVE_LRDF HAVE_MAD HAVE_OGGZ HAVE_PORTAUDIO HAVE_SAMPLERATE HAVE_SNDFILE HAVE_VAMP
1004 1007
1005 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then 1008 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then
1006 # this tag can be used to specify a list of macro names that should be expanded. 1009 # this tag can be used to specify a list of macro names that should be expanded.
1007 # The macro definition that is found in the sources will be used. 1010 # The macro definition that is found in the sources will be used.
1008 # Use the PREDEFINED tag if you want to use a different macro definition. 1011 # Use the PREDEFINED tag if you want to use a different macro definition.
1069 # or super classes. Setting the tag to NO turns the diagrams off. Note that 1072 # or super classes. Setting the tag to NO turns the diagrams off. Note that
1070 # this option is superseded by the HAVE_DOT option below. This is only a 1073 # this option is superseded by the HAVE_DOT option below. This is only a
1071 # fallback. It is recommended to install and use dot, since it yields more 1074 # fallback. It is recommended to install and use dot, since it yields more
1072 # powerful graphs. 1075 # powerful graphs.
1073 1076
1074 CLASS_DIAGRAMS = YES 1077 CLASS_DIAGRAMS = NO
1075 1078
1076 # If set to YES, the inheritance and collaboration graphs will hide 1079 # If set to YES, the inheritance and collaboration graphs will hide
1077 # inheritance and usage relations if the target is undocumented 1080 # inheritance and usage relations if the target is undocumented
1078 # or is not a class. 1081 # or is not a class.
1079 1082
1082 # If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is 1085 # If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
1083 # available from the path. This tool is part of Graphviz, a graph visualization 1086 # available from the path. This tool is part of Graphviz, a graph visualization
1084 # toolkit from AT&T and Lucent Bell Labs. The other options in this section 1087 # toolkit from AT&T and Lucent Bell Labs. The other options in this section
1085 # have no effect if this option is set to NO (the default) 1088 # have no effect if this option is set to NO (the default)
1086 1089
1087 HAVE_DOT = NO 1090 HAVE_DOT = YES
1088 1091
1089 # If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen 1092 # If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen
1090 # will generate a graph for each documented class showing the direct and 1093 # will generate a graph for each documented class showing the direct and
1091 # indirect inheritance relations. Setting this tag to YES will force the 1094 # indirect inheritance relations. Setting this tag to YES will force the
1092 # the CLASS_DIAGRAMS tag to NO. 1095 # the CLASS_DIAGRAMS tag to NO.
1096 # If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen 1099 # If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen
1097 # will generate a graph for each documented class showing the direct and 1100 # will generate a graph for each documented class showing the direct and
1098 # indirect implementation dependencies (inheritance, containment, and 1101 # indirect implementation dependencies (inheritance, containment, and
1099 # class references variables) of the class with other documented classes. 1102 # class references variables) of the class with other documented classes.
1100 1103
1101 COLLABORATION_GRAPH = YES 1104 COLLABORATION_GRAPH = NO
1102 1105
1103 # If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen 1106 # If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen
1104 # will generate a graph for groups, showing the direct groups dependencies 1107 # will generate a graph for groups, showing the direct groups dependencies
1105 1108
1106 GROUP_GRAPHS = YES 1109 GROUP_GRAPHS = YES
1206 # Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output 1209 # Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output
1207 # files in one run (i.e. multiple -o and -T options on the command line). This 1210 # files in one run (i.e. multiple -o and -T options on the command line). This
1208 # makes dot run faster, but since only newer versions of dot (>1.8.10) 1211 # makes dot run faster, but since only newer versions of dot (>1.8.10)
1209 # support this, this feature is disabled by default. 1212 # support this, this feature is disabled by default.
1210 1213
1211 DOT_MULTI_TARGETS = NO 1214 DOT_MULTI_TARGETS = YES
1212 1215
1213 # If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will 1216 # If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will
1214 # generate a legend page explaining the meaning of the various boxes and 1217 # generate a legend page explaining the meaning of the various boxes and
1215 # arrows in the dot generated graphs. 1218 # arrows in the dot generated graphs.
1216 1219