Mercurial > hg > vamp-plugin-sdk
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 |