372 lines
14 KiB
Plaintext
372 lines
14 KiB
Plaintext
#
|
|
# This file describes the settings to be used by the documentation system
|
|
# doxygen (www.doxygen.org) for a project.
|
|
#
|
|
|
|
PROJECT_NAME = "Sming Framework API"
|
|
PROJECT_NUMBER = $(API_VERSION)
|
|
PROJECT_BRIEF = "Open Source framework for high efficiency WiFi SoC ESP8266 native development with C++ language."
|
|
PROJECT_LOGO = api-logo.png
|
|
OUTPUT_DIRECTORY = api
|
|
|
|
# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
|
|
# doxygen will generate a detailed section even if there is only a brief
|
|
# description.
|
|
# The default value is: NO.
|
|
|
|
ALWAYS_DETAILED_SEC = YES
|
|
|
|
# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
|
|
# inherited members of a class in the documentation of that class as if those
|
|
# members were ordinary class members. Constructors, destructors and assignment
|
|
# operators of the base classes will not be shown.
|
|
# The default value is: NO.
|
|
|
|
INLINE_INHERITED_MEMB = NO
|
|
|
|
# If the FULL_PATH_NAMES tag is set to YES, doxygen will prepend the full path
|
|
# before files name in the file list and in the header files. If set to NO the
|
|
# shortest path that makes the file name unique will be used
|
|
# The default value is: YES.
|
|
|
|
FULL_PATH_NAMES = NO
|
|
|
|
# The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen
|
|
# uses this value to replace tabs by spaces in code fragments.
|
|
# Minimum value: 1, maximum value: 16, default value: 4.
|
|
|
|
TAB_SIZE = 4
|
|
|
|
# This tag can be used to specify a number of aliases that act as commands in
|
|
# the documentation. An alias has the form:
|
|
# name=value
|
|
# For example adding
|
|
# "sideeffect=@par Side Effects:\n"
|
|
# will allow you to put the command \sideeffect (or @sideeffect) in the
|
|
# documentation, which will result in a user-defined paragraph with heading
|
|
# "Side Effects:". You can put \n's in the value part of an alias to insert
|
|
# newlines.
|
|
|
|
ALIASES = "license=@par License:\n"
|
|
|
|
|
|
EXTRACT_ALL = YES
|
|
|
|
# If the EXTRACT_STATIC tag is set to YES, all static members of a file will be
|
|
# included in the documentation.
|
|
# The default value is: NO.
|
|
|
|
EXTRACT_STATIC = YES
|
|
|
|
CASE_SENSE_NAMES = YES
|
|
|
|
# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy
|
|
# of group names into alphabetical order. If set to NO the group names will
|
|
# appear in their defined order.
|
|
# The default value is: NO.
|
|
|
|
SORT_GROUP_NAMES = YES
|
|
|
|
# Set the SHOW_USED_FILES tag to NO to disable the list of files generated at
|
|
# the bottom of the documentation of classes and structs. If set to YES, the
|
|
# list will mention the files that were used to generate the documentation.
|
|
# The default value is: YES.
|
|
|
|
SHOW_USED_FILES = YES
|
|
|
|
# Set the SHOW_FILES tag to NO to disable the generation of the Files page. This
|
|
# will remove the Files entry from the Quick Index and from the Folder Tree View
|
|
# (if specified).
|
|
# The default value is: YES.
|
|
|
|
SHOW_FILES = YES
|
|
|
|
# The WARN_LOGFILE tag can be used to specify a file to which warning and error
|
|
# messages should be written. If left blank the output is written to standard
|
|
# error (stderr).
|
|
|
|
WARN_LOGFILE = api/error.log
|
|
|
|
#---------------------------------------------------------------------------
|
|
# Configuration options related to the input files
|
|
#---------------------------------------------------------------------------
|
|
|
|
# The INPUT tag is used to specify the files and/or directories that contain
|
|
# documented source files. You may enter file names like myfile.cpp or
|
|
# directories like /usr/src/myproject. Separate the files or directories with
|
|
# spaces.
|
|
# Note: If this tag is empty the current directory is searched.
|
|
|
|
STRIP_FROM_PATH = $(SMING_HOME)
|
|
|
|
INPUT = $(DOXYGEN_INPUT)
|
|
|
|
INCLUDE_PATH = $(DOXYGEN_INCLUDE_PATH)
|
|
|
|
INPUT_ENCODING = ISO-8859-1
|
|
|
|
RECURSIVE = YES
|
|
|
|
# If the value of the INPUT tag contains directories, you can use the
|
|
# FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
|
|
# *.h) to filter out the source-files in the directories. If left blank the
|
|
# following patterns are tested:*.c, *.cc, *.cxx, *.cpp, *.c++, *.java, *.ii,
|
|
# *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, *.hh, *.hxx, *.hpp,
|
|
# *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc, *.m, *.markdown,
|
|
# *.md, *.mm, *.dox, *.py, *.f90, *.f, *.for, *.tcl, *.vhd, *.vhdl, *.ucf,
|
|
# *.qsf, *.as and *.js.
|
|
|
|
FILE_PATTERNS = *.h *.hpp
|
|
|
|
# The EXCLUDE tag can be used to specify files and/or directories that should be
|
|
# excluded from the INPUT source files. This way you can easily exclude a
|
|
# subdirectory from a directory tree whose root is specified with the INPUT tag.
|
|
#
|
|
# Note that relative paths are relative to the directory from which doxygen is
|
|
# run.
|
|
|
|
EXCLUDE = samples Sming/Libraries
|
|
|
|
# If the value of the INPUT tag contains directories, you can use the
|
|
# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
|
|
# certain files from those directories.
|
|
#
|
|
# Note that the wildcards are matched against the file with absolute path, so to
|
|
# exclude all test directories for example use the pattern */test/*
|
|
|
|
EXCLUDE_PATTERNS =
|
|
|
|
# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
|
|
# (namespaces, classes, functions, etc.) that should be excluded from the
|
|
# output. The symbol name can be a fully qualified name, a word, or if the
|
|
# wildcard * is used, a substring. Examples: ANamespace, AClass,
|
|
# AClass::ANamespace, ANamespace::*Test
|
|
#
|
|
# Note that the wildcards are matched against the file with absolute path, so to
|
|
# exclude all test directories use the pattern */test/*
|
|
|
|
EXCLUDE_SYMBOLS =
|
|
|
|
# The EXAMPLE_PATH tag can be used to specify one or more files or directories
|
|
# that contain example code fragments that are included (see the \include
|
|
# command).
|
|
|
|
EXAMPLE_PATH =
|
|
|
|
# If the value of the EXAMPLE_PATH tag contains directories, you can use the
|
|
# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
|
|
# *.h) to filter out the source-files in the directories. If left blank all
|
|
# files are included.
|
|
|
|
EXAMPLE_PATTERNS =
|
|
|
|
# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
|
|
# searched for input files to be used with the \include or \dontinclude commands
|
|
# irrespective of the value of the RECURSIVE tag.
|
|
# The default value is: NO.
|
|
|
|
EXAMPLE_RECURSIVE = YES
|
|
|
|
# The IMAGE_PATH tag can be used to specify one or more files or directories
|
|
# that contain images that are to be included in the documentation (see the
|
|
# \image command).
|
|
|
|
IMAGE_PATH =
|
|
|
|
#---------------------------------------------------------------------------
|
|
# Configuration options related to source browsing
|
|
#---------------------------------------------------------------------------
|
|
|
|
# If the SOURCE_BROWSER tag is set to YES then a list of source files will be
|
|
# generated. Documented entities will be cross-referenced with these sources.
|
|
#
|
|
# Note: To get rid of all source code in the generated output, make sure that
|
|
# also VERBATIM_HEADERS is set to NO.
|
|
# The default value is: NO.
|
|
|
|
SOURCE_BROWSER = NO
|
|
|
|
# Setting the INLINE_SOURCES tag to YES will include the body of functions,
|
|
# classes and enums directly into the documentation.
|
|
# The default value is: NO.
|
|
|
|
INLINE_SOURCES = NO
|
|
|
|
# Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any
|
|
# special comment blocks from generated source code fragments. Normal C, C++ and
|
|
# Fortran comments will always remain visible.
|
|
# The default value is: YES.
|
|
|
|
STRIP_CODE_COMMENTS = YES
|
|
|
|
# If the REFERENCED_BY_RELATION tag is set to YES then for each documented
|
|
# function all documented functions referencing it will be listed.
|
|
# The default value is: NO.
|
|
|
|
REFERENCED_BY_RELATION = NO
|
|
|
|
# If the REFERENCES_RELATION tag is set to YES then for each documented function
|
|
# all documented entities called/used by that function will be listed.
|
|
# The default value is: NO.
|
|
|
|
REFERENCES_RELATION = NO
|
|
|
|
# If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set
|
|
# to YES then the hyperlinks from functions in REFERENCES_RELATION and
|
|
# REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will
|
|
# link to the documentation.
|
|
# The default value is: YES.
|
|
|
|
REFERENCES_LINK_SOURCE = YES
|
|
|
|
# If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the
|
|
# source code will show a tooltip with additional information such as prototype,
|
|
# brief description and links to the definition and documentation. Since this
|
|
# will make the HTML file larger and loading of large files a bit slower, you
|
|
# can opt to disable this feature.
|
|
# The default value is: YES.
|
|
# This tag requires that the tag SOURCE_BROWSER is set to YES.
|
|
|
|
SOURCE_TOOLTIPS = YES
|
|
|
|
# If the USE_HTAGS tag is set to YES then the references to source code will
|
|
# point to the HTML generated by the htags(1) tool instead of doxygen built-in
|
|
# source browser. The htags tool is part of GNU's global source tagging system
|
|
# (see http://www.gnu.org/software/global/global.html). You will need version
|
|
# 4.8.6 or higher.
|
|
#
|
|
# To use it do the following:
|
|
# - Install the latest version of global
|
|
# - Enable SOURCE_BROWSER and USE_HTAGS in the config file
|
|
# - Make sure the INPUT points to the root of the source tree
|
|
# - Run doxygen as normal
|
|
#
|
|
# Doxygen will invoke htags (and that will in turn invoke gtags), so these
|
|
# tools must be available from the command line (i.e. in the search path).
|
|
#
|
|
# The result: instead of the source browser generated by doxygen, the links to
|
|
# source code will now point to the output of htags.
|
|
# The default value is: NO.
|
|
# This tag requires that the tag SOURCE_BROWSER is set to YES.
|
|
|
|
USE_HTAGS = NO
|
|
|
|
# If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a
|
|
# verbatim copy of the header file for each class for which an include is
|
|
# specified. Set to NO to disable this.
|
|
# See also: Section \class.
|
|
# The default value is: YES.
|
|
|
|
VERBATIM_HEADERS = YES
|
|
|
|
# If the CLANG_ASSISTED_PARSING tag is set to YES then doxygen will use the
|
|
# clang parser (see: http://clang.llvm.org/) for more accurate parsing at the
|
|
# cost of reduced performance. This can be particularly helpful with template
|
|
# rich C++ code for which doxygen's built-in parser lacks the necessary type
|
|
# information.
|
|
# Note: The availability of this option depends on whether or not doxygen was
|
|
# compiled with the --with-libclang option.
|
|
# The default value is: NO.
|
|
|
|
CLANG_ASSISTED_PARSING = NO
|
|
|
|
# If clang assisted parsing is enabled you can provide the compiler with command
|
|
# line options that you would normally use when invoking the compiler. Note that
|
|
# the include paths will already be set by doxygen for the files and directories
|
|
# specified with INPUT and INCLUDE_PATH.
|
|
# This tag requires that the tag CLANG_ASSISTED_PARSING is set to YES.
|
|
|
|
CLANG_OPTIONS =
|
|
|
|
#---------------------------------------------------------------------------
|
|
# Configuration options related to the alphabetical class index
|
|
#---------------------------------------------------------------------------
|
|
|
|
# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all
|
|
# compounds will be generated. Enable this if the project contains a lot of
|
|
# classes, structs, unions or interfaces.
|
|
# The default value is: YES.
|
|
|
|
ALPHABETICAL_INDEX = YES
|
|
|
|
# The COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns in
|
|
# which the alphabetical index list will be split.
|
|
# Minimum value: 1, maximum value: 20, default value: 5.
|
|
# This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
|
|
|
|
COLS_IN_ALPHA_INDEX = 5
|
|
|
|
# In case all classes in a project start with a common prefix, all classes will
|
|
# be put under the same header in the alphabetical index. The IGNORE_PREFIX tag
|
|
# can be used to specify a prefix (or a list of prefixes) that should be ignored
|
|
# while generating the index headers.
|
|
# This tag requires that the tag ALPHABETICAL_INDEX is set to YES.
|
|
|
|
IGNORE_PREFIX =
|
|
|
|
##
|
|
GENERATE_HTML = YES
|
|
HTML_OUTPUT = html/api
|
|
HTML_DYNAMIC_SECTIONS = NO
|
|
HTML_HEADER = api-header.html
|
|
HTML_FOOTER = api-footer.html
|
|
HTML_EXTRA_STYLESHEET = doxy-boot/customdoxygen.css
|
|
HTML_EXTRA_FILES = \
|
|
doxy-boot/doxy-boot.js \
|
|
doxy-boot/jquery.smartmenus.min.js \
|
|
doxy-boot/addons/bootstrap/jquery.smartmenus.bootstrap.min.js \
|
|
doxy-boot/addons/bootstrap/jquery.smartmenus.bootstrap.css
|
|
|
|
|
|
#LAYOUT_FILE = api-layout.xml
|
|
|
|
GENERATE_LATEX = NO
|
|
GENERATE_MAN = NO
|
|
GENERATE_RTF = NO
|
|
|
|
# Graph creation
|
|
HAVE_DOT = YES
|
|
DOT_MULTI_TARGETS = YES
|
|
DOT_IMAGE_FORMAT = svg
|
|
INTERACTIVE_SVG = NO
|
|
DOT_CLEANUP = YES
|
|
DOT_GRAPH_MAX_NODES = 100
|
|
DISABLE_INDEX = NO
|
|
GENERATE_TREEVIEW = NO
|
|
|
|
HIDE_UNDOC_RELATIONS = NO
|
|
|
|
WARN_IF_UNDOCUMENTED = NO
|
|
|
|
#
|
|
GENERATE_XML = YES
|
|
XML_OUTPUT = xml
|
|
|
|
# If the XML_PROGRAMLISTING tag is set to YES, doxygen will dump the program
|
|
# listings (including syntax highlighting and cross-referencing information) to
|
|
# the XML output. Note that enabling this will significantly increase the size
|
|
# of the XML output.
|
|
# The default value is: YES.
|
|
# This tag requires that the tag GENERATE_XML is set to YES.
|
|
|
|
XML_PROGRAMLISTING = NO
|
|
|
|
|
|
#---------------------------------------------------------------------------
|
|
# Configuration options related to the preprocessor
|
|
#---------------------------------------------------------------------------
|
|
|
|
# The PREDEFINED tag can be used to specify one or more macro names that are
|
|
# defined before the preprocessor is started (similar to the -D option of e.g.
|
|
# gcc). The argument of the tag is a list of macros of the form: name or
|
|
# name=definition (no spaces). If the definition and the "=" are omitted, "=1"
|
|
# is assumed. To prevent a macro definition from being undefined via #undef or
|
|
# recursively expanded use the := operator instead of the = operator.
|
|
# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
|
|
|
|
SEARCH_INCLUDES = YES
|
|
ENABLE_PREPROCESSING = YES
|
|
MACRO_EXPANSION = YES
|
|
EXPAND_ONLY_PREDEF = YES
|
|
PREDEFINED = $(DOXYGEN_PREDEFINED)
|