xref: /AliOS-Things-master/components/jsoncpp/doc/web_doxyfile.in

9 # All text after a single hash (#) is considered a comment and will be ignored.
51 # and the maximum width should not exceed 200 pixels. Doxygen will copy the logo
57 # into which the generated documentation will be written. If a relative path is
58 # entered, it will be relative to the location where doxygen was started. If
59 # left blank the current directory will be used.
63 # If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 4096 sub-
65 # will distribute the generated files over these directories. Enabling this
74 # documentation generated by doxygen is written. Doxygen will use this
86 # If the BRIEF_MEMBER_DESC tag is set to YES doxygen will include brief member
93 # If the REPEAT_BRIEF tag is set to YES doxygen will prepend the brief
97 # brief descriptions will be completely suppressed.
104 # as the leading text of the brief description, will be stripped from the text
124 # doxygen will generate a detailed section even if there is only a brief
130 # If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
133 # operators of the base classes will not be shown.
138 # If the FULL_PATH_NAMES tag is set to YES doxygen will prepend the full path
140 # shortest path that makes the file name unique will be used
152 # will be relative from the directory where doxygen is started.
166 # If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but
173 # If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the
175 # description. If set to NO, the Javadoc-style will behave just like regular Qt-
182 # If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
184 # set to NO, the Qt-style will behave just like regular Qt-style comments (thus
208 # If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce a
209 # new page for each member. If set to NO, the documentation of a member will be
226 # will allow you to put the command \sideeffect (or @sideeffect) in the
227 # documentation, which will result in a user-defined paragraph with heading
238 # will allow you to use the command class in the itcl::class meaning.
243 # only. Doxygen will then generate output that is more tailored for C. For
244 # instance, some of the names that are used will be different. The list of all
245 # members will be omitted, etc.
251 # Python sources only. Doxygen will then generate output that is more tailored
252 # for that language. For instance, namespaces will be presented as packages,
253 # qualified scopes will look different, etc.
259 # sources. Doxygen will then generate output that is tailored for Fortran.
265 # sources. Doxygen will then generate output that is tailored for VHDL.
322 # will parse them like normal C++ but will assume all classes use public instead
329 # getter and setter methods for a property. Setting this option to YES will make
331 # This will only work if the methods are indeed getting or setting a simple
339 # tag is set to YES, then doxygen will reuse the documentation of the first
367 # with only public data fields or simple typedef fields will be shown inline in
378 # typedef struct TypeS {} TypeT, will appear in the documentation as a struct
379 # with name TypeT. When disabled the typedef will appear as a member of a file,
380 # namespace, or class. And the struct will be named TypeS. This can typically be
391 # doxygen will become slower. If the cache is too large, memory is wasted. The
394 # symbols. At the end of a run doxygen will report the cache usage and suggest
404 # If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
406 # class members and static file members will be hidden unless the
408 # Note: This will also disable the warnings about undocumented members that are
414 # If the EXTRACT_PRIVATE tag is set to YES all private members of a class will
421 # scope will be included in the documentation.
426 # If the EXTRACT_STATIC tag is set to YES all static members of a file will be
433 # locally in source files will be included in the documentation. If set to NO
448 # If this flag is set to YES, the members of anonymous namespaces will be
450 # 'anonymous_namespace{file}', where file will be replaced with the base name of
457 # If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all
459 # members will be included in the various overviews, but no documentation
465 # If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all
467 # to NO these classes will be included in the various overviews. This option has
473 # If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend
474 # (class|struct|union) declarations. If set to NO these declarations will be
480 # If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any
482 # blocks will be appended to the function's detailed documentation block.
489 # will be excluded. Set it to YES to include the internal documentation.
494 # If the CASE_SENSE_NAMES tag is set to NO then doxygen will only generate file
503 # If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with
505 # scope will be hidden.
510 # If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of
516 # If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include
528 # If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the
530 # name. If set to NO the members will appear in declaration order.
535 # If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief
537 # name. If set to NO the members will appear in declaration order.
542 # If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the
544 # destructors are listed first. If set to NO the constructors will appear in the
554 # If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy
555 # of group names into alphabetical order. If set to NO the group names will
561 # If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by
562 # fully-qualified names, including namespaces. If set to NO, the class list will
572 # type resolution of all parameters of a function it will reject a match between
575 # simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still
617 # it will be hidden. Use a value of 0 to hide initializers completely. The
627 # will mention the files that were used to generate the documentation.
633 # will remove the Files entry from the Quick Index and from the Folder Tree View
640 # page. This will remove the Namespaces entry from the Quick Index and from the
648 # the version control system). Doxygen will invoke the program by executing (via
656 # The LAYOUT_FILE tag can be used to specify a layout file which will be parsed
661 # will be used as the name of the layout file.
664 # DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
700 # If the WARN_IF_UNDOCUMENTED tag is set to YES, then doxygen will generate
702 # will automatically be disabled.
707 # If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for
717 # value. If set to NO doxygen will only warn about wrong or incomplete parameter
725 # will be replaced by the file and line number from which the warning originated
726 # and the warning text. Optionally the format may contain $version, which will
831 # If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
845 # invoke to filter for each input file. Doxygen will invoke the filter program
851 # name of an input file. Doxygen will then use the output that the filter
853 # will be ignored.
857 # or removed, the anchors will not be placed correctly.
862 # basis. Doxygen will compare the file name with each pattern and apply the
871 # INPUT_FILTER ) will also be used to filter the input files that are used for
878 # pattern. A pattern will override the setting for FILTER_PATTERN (if any) and
886 # is part of the input, its contents will be placed on the main page
896 # If the SOURCE_BROWSER tag is set to YES then a list of source files will be
897 # generated. Documented entities will be cross-referenced with these sources.
905 # Setting the INLINE_SOURCES tag to YES will include the body of functions,
911 # Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any
913 # Fortran comments will always remain visible.
919 # function all documented functions referencing it will be listed.
925 # all documented entities called/used by that function will be listed.
932 # REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will
939 # source code will show a tooltip with additional information such as prototype,
941 # will make the HTML file larger and loading of large files a bit slower, you
948 # If the USE_HTAGS tag is set to YES then the references to source code will
951 # (see http://www.gnu.org/software/global/global.html). You will need version
960 # Doxygen will invoke htags (and that will in turn invoke gtags), so these
964 # source code will now point to the output of htags.
970 # If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a
983 # compounds will be generated. Enable this if the project contains a lot of
991 # which the alphabetical index list will be split.
997 # In case all classes in a project start with a common prefix, all classes will
1009 # If the GENERATE_HTML tag is set to YES doxygen will generate HTML output
1014 # The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a
1015 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
1030 # each generated HTML page. If the tag is left blank doxygen will generate a
1050 # generated HTML page. If the tag is left blank doxygen will generate a standard
1061 # the HTML output. If left blank doxygen will generate a default style sheet.
1065 # it is more robust and this tag (HTML_STYLESHEET) will in the future become
1076 # Doxygen will copy the style sheet file to the output directory. For an example
1084 # that these files will be copied to the base HTML output directory. Use the
1087 # files will be copied as-is; there are no commands or markers available.
1093 # will adjust the colors in the stylesheet and background images according to
1104 # in the HTML output. For a value of 0 the output will use grayscales only. A
1105 # value of 255 will produce the most vivid colors.
1123 # page will contain the date and time when the page was generated. Setting this
1131 # documentation will contain sections that can be hidden and shown after the
1140 # and collapse entries dynamically later on. Doxygen will expand the tree to
1143 # entries 1 will produce a full collapsed tree by default. 0 is a special value
1144 # representing an infinite number of entries and will result in a full expanded
1151 # If the GENERATE_DOCSET tag is set to YES, additional index files will be
1154 # OSX 10.5 (Leopard). To create a documentation set, doxygen will generate a
1155 # Makefile in the HTML output directory. Running make will produce the docset in
1156 # that directory and running make install will install the docset in
1157 # ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at
1175 # com.mycompany.MyDocSet. Doxygen will append .docset to the name.
1203 # files are now used as the Windows 98 help format, and will replace the old
1222 # doxygen will try to run the HTML help compiler on the generated index.hhp.
1256 # QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that
1312 # qhelpgenerator. If non-empty doxygen will try to run qhelpgenerator on the
1318 # If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be
1351 # value is set to YES, a side panel will be generated containing a tree-like
1367 # doxygen will group on one line in the generated HTML documentation.
1369 # Note that a value of 0 will completely suppress the enum values from appearing
1383 # When the EXT_LINKS_IN_WINDOW option is set to YES doxygen will open links to
1452 # of code that will be used on startup of the MathJax code. See the MathJax site
1459 # When the SEARCHENGINE tag is enabled doxygen will generate a search box for
1480 # When the SERVER_BASED_SEARCH tag is enabled the search engine will be
1483 # EXTERNAL_SEARCH setting. When disabled, doxygen will generate a PHP script for
1492 # When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP
1494 # which needs to be processed by an external indexer. Doxygen will invoke an
1509 # which will return the search results when EXTERNAL_SEARCH is enabled.
1549 # If the GENERATE_LATEX tag is set to YES doxygen will generate LaTeX output.
1554 # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a
1555 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
1601 # If left blank no extra packages will be included.
1608 # chapter. If it is left blank doxygen will generate a standard header. See
1614 # $datetime, $date, $doxygenversion, $projectname, $projectnumber. Doxygen will
1624 # chapter. If it is left blank doxygen will generate a standard footer.
1633 # directory. Note that the files will be copied as-is; there are no commands or
1640 # prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will
1648 # If the LATEX_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate
1656 # If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode
1657 # command to the generated LaTeX files. This will instruct LaTeX to keep running
1665 # If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the
1672 # If the LATEX_SOURCE_CODE tag is set to YES then doxygen will include source
1694 # If the GENERATE_RTF tag is set to YES doxygen will generate RTF output. The
1701 # The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a
1702 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
1717 # If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will
1718 # contain hyperlink fields. The RTF file will contain links (just like the HTML
1750 # If the GENERATE_MAN tag is set to YES doxygen will generate man pages for
1756 # The MAN_OUTPUT tag is used to specify where the man pages will be put. If a
1757 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
1758 # it. A directory man3 will be created inside the directory specified by
1775 # will generate one additional man file for each entity documented in the real
1787 # If the GENERATE_XML tag is set to YES doxygen will generate an XML file that
1793 # The XML_OUTPUT tag is used to specify where the XML pages will be put. If a
1794 # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
1801 # If the XML_PROGRAMLISTING tag is set to YES doxygen will dump the program
1803 # the XML output. Note that enabling this will significantly increase the size
1814 # If the GENERATE_DOCBOOK tag is set to YES doxygen will generate Docbook files
1820 # The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put.
1821 # If a relative path is entered the value of OUTPUT_DIRECTORY will be put in
1832 # If the GENERATE_AUTOGEN_DEF tag is set to YES doxygen will generate an AutoGen
1844 # If the GENERATE_PERLMOD tag is set to YES doxygen will generate a Perl module
1852 # If the PERLMOD_LATEX tag is set to YES doxygen will generate the necessary
1860 # If the PERLMOD_PRETTY tag is set to YES the Perl module output will be nicely
1863 # size of the Perl module output will be much smaller and Perl will parse it
1882 # If the ENABLE_PREPROCESSING tag is set to YES doxygen will evaluate all
1888 # If the MACRO_EXPANSION tag is set to YES doxygen will expand all macro names
1889 # in the source code. If set to NO only conditional compilation will be
1906 # INCLUDE_PATH will be searched if a #include is found.
1921 # directories. If left blank, the patterns specified with FILE_PATTERNS will be
1942 # macro definition that is found in the sources will be used. Use the PREDEFINED
1949 # If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will
1952 # typically used for boiler-plate code, and will confuse the parser if not
1978 # When a file name is specified after GENERATE_TAGFILE, doxygen will create a
1984 # If the ALLEXTERNALS tag is set to YES all external class will be listed in the
1985 # class index. If set to NO only the inherited external classes will be listed.
1990 # If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed in
1991 # the modules index. If set to NO, only the current project's groups will be
1997 # If the EXTERNAL_PAGES tag is set to YES all external pages will be listed in
1998 # the related pages index. If set to NO, only the current project's pages will
2014 # If the CLASS_DIAGRAMS tag is set to YES doxygen will generate a class diagram
2024 # command. Doxygen will then run the mscgen tool (see:
2032 # If set to YES, the inheritance and collaboration graphs will hide inheritance
2038 # If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is
2048 # to run in parallel. When set to 0 doxygen will base this on the number of
2074 # By default doxygen will tell dot to use the default font as specified with
2081 # If the CLASS_GRAPH tag is set to YES then doxygen will generate a graph for
2083 # Setting this tag to YES will force the CLASS_DIAGRAMS tag to NO.
2089 # If the COLLABORATION_GRAPH tag is set to YES then doxygen will generate a
2098 # If the GROUP_GRAPHS tag is set to YES then doxygen will generate a graph for
2105 # If the UML_LOOK tag is set to YES doxygen will generate inheritance and
2127 # collaboration graphs will show the relations between templates and their
2135 # YES then doxygen will generate a graph for each documented file showing the
2144 # set to YES then doxygen will generate a graph for each documented file showing
2152 # If the CALL_GRAPH tag is set to YES then doxygen will generate a call
2155 # Note that enabling this option will significantly increase the time of a run.
2156 # So in most cases it will be better to enable call graphs for selected
2163 # If the CALLER_GRAPH tag is set to YES then doxygen will generate a caller
2166 # Note that enabling this option will significantly increase the time of a run.
2167 # So in most cases it will be better to enable caller graphs for selected
2174 # If the GRAPHICAL_HIERARCHY tag is set to YES then doxygen will graphical
2181 # If the DIRECTORY_GRAPH tag is set to YES then doxygen will show the
2233 # that will be shown in the graph. If the number of nodes in a graph becomes
2234 # larger than this value, doxygen will truncate the graph, which is visualized
2237 # DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that
2246 # root by following a path via at most 3 edges will be shown. Nodes that lay
2247 # further from the root node will be omitted. Note that setting this option to 1
2277 # If the GENERATE_LEGEND tag is set to YES doxygen will generate a legend page
2285 # If the DOT_CLEANUP tag is set to YES doxygen will remove the intermediate dot

Last Index update Sun Aug 20 00:18:20 CST 2023