Add doxygen to CMake and update the config
This commit is contained in:
		| @@ -77,6 +77,7 @@ add_compile_options(-mlittle-endian -mthumb -mcpu=cortex-m4 -mthumb-interwork -m | |||||||
| set(GIT_DESCRIBE "${GIT_DESCRIBE}") | set(GIT_DESCRIBE "${GIT_DESCRIBE}") | ||||||
| add_definitions(-DBASE64_LOOKUP_TABLE_SECTION=\".ccm.bss\" -DSHELLMATTA_HELP_ALIAS=\"?\" -DGIT_VER=${GIT_DESCRIBE} -DHSE_VALUE=8000000UL -DSTM32F407xx -DSTM32F4XX -DARM_MATH_CM4) | add_definitions(-DBASE64_LOOKUP_TABLE_SECTION=\".ccm.bss\" -DSHELLMATTA_HELP_ALIAS=\"?\" -DGIT_VER=${GIT_DESCRIBE} -DHSE_VALUE=8000000UL -DSTM32F407xx -DSTM32F4XX -DARM_MATH_CM4) | ||||||
|  |  | ||||||
|  | add_subdirectory(doxygen) | ||||||
| add_subdirectory(updater/ram-code) | add_subdirectory(updater/ram-code) | ||||||
|  |  | ||||||
| include_directories(${CMAKE_CURRENT_SOURCE_DIR}/include) | include_directories(${CMAKE_CURRENT_SOURCE_DIR}/include) | ||||||
|   | |||||||
							
								
								
									
										40
									
								
								stm-firmware/doxygen/CMakeLists.txt
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										40
									
								
								stm-firmware/doxygen/CMakeLists.txt
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,40 @@ | |||||||
|  | find_package(Doxygen) | ||||||
|  |  | ||||||
|  | if(NOT WIN32) | ||||||
|  |   string(ASCII 27 Esc) | ||||||
|  |   set(ColorReset "${Esc}[m") | ||||||
|  |   set(ColorBold  "${Esc}[1m") | ||||||
|  |   set(Red         "${Esc}[31m") | ||||||
|  |   set(Green       "${Esc}[32m") | ||||||
|  |   set(Yellow      "${Esc}[33m") | ||||||
|  |   set(Blue        "${Esc}[34m") | ||||||
|  |   set(Magenta     "${Esc}[35m") | ||||||
|  |   set(Cyan        "${Esc}[36m") | ||||||
|  |   set(White       "${Esc}[37m") | ||||||
|  |   set(BoldRed     "${Esc}[1;31m") | ||||||
|  |   set(BoldGreen   "${Esc}[1;32m") | ||||||
|  |   set(BoldYellow  "${Esc}[1;33m") | ||||||
|  |   set(BoldBlue    "${Esc}[1;34m") | ||||||
|  |   set(BoldMagenta "${Esc}[1;35m") | ||||||
|  |   set(BoldCyan    "${Esc}[1;36m") | ||||||
|  |   set(BoldWhite   "${Esc}[1;37m") | ||||||
|  | endif() | ||||||
|  |  | ||||||
|  | if (DOXYGEN_FOUND) | ||||||
|  | 	add_custom_target(documentation DEPENDS doxygen doxygen-pdf) | ||||||
|  |  | ||||||
|  | 	add_custom_target(doxygen | ||||||
|  | 		COMMAND ./build-doxygen.sh "${PROJECT_BINARY_DIR}" | ||||||
|  | 		WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR} | ||||||
|  | 		COMMENT "Generating documentation with Doxygen") | ||||||
|  |  | ||||||
|  | 	add_custom_target( | ||||||
|  | 	   doxygen-pdf | ||||||
|  | 	   COMMAND make | ||||||
|  | 	   WORKING_DIRECTORY "${PROJECT_BINARY_DIR}/latex" | ||||||
|  | 	   DEPENDS doxygen | ||||||
|  | 	   ) | ||||||
|  | else (DOXYGEN_FOUND) | ||||||
|  | 	message("${BoldMagenta}Doxygen needs to be installed to generate the doxygen documentation${ColorReset}") | ||||||
|  | 	message("${BoldMagenta}doxygen, documentation, doxygen-latex targets will not be available${ColorReset}") | ||||||
|  | endif (DOXYGEN_FOUND) | ||||||
| @@ -1,4 +1,4 @@ | |||||||
| # Doxyfile 1.9.1 | # Doxyfile 1.9.2 | ||||||
|  |  | ||||||
| # This file describes the settings to be used by the documentation system | # This file describes the settings to be used by the documentation system | ||||||
| # doxygen (www.doxygen.org) for a project. | # doxygen (www.doxygen.org) for a project. | ||||||
| @@ -93,14 +93,6 @@ ALLOW_UNICODE_NAMES    = NO | |||||||
|  |  | ||||||
| OUTPUT_LANGUAGE        = English | OUTPUT_LANGUAGE        = English | ||||||
|  |  | ||||||
| # The OUTPUT_TEXT_DIRECTION tag is used to specify the direction in which all |  | ||||||
| # documentation generated by doxygen is written. Doxygen will use this |  | ||||||
| # information to generate all generated output in the proper direction. |  | ||||||
| # Possible values are: None, LTR, RTL and Context. |  | ||||||
| # The default value is: None. |  | ||||||
|  |  | ||||||
| OUTPUT_TEXT_DIRECTION  = None |  | ||||||
|  |  | ||||||
| # If the BRIEF_MEMBER_DESC tag is set to YES, doxygen will include brief member | # If the BRIEF_MEMBER_DESC tag is set to YES, doxygen will include brief member | ||||||
| # descriptions after the members that are listed in the file and class | # descriptions after the members that are listed in the file and class | ||||||
| # documentation (similar to Javadoc). Set to NO to disable this. | # documentation (similar to Javadoc). Set to NO to disable this. | ||||||
| @@ -258,16 +250,16 @@ TAB_SIZE               = 8 | |||||||
| # the documentation. An alias has the form: | # the documentation. An alias has the form: | ||||||
| # name=value | # name=value | ||||||
| # For example adding | # For example adding | ||||||
| # "sideeffect=@par Side Effects:\n" | # "sideeffect=@par Side Effects:^^" | ||||||
| # will allow you to put the command \sideeffect (or @sideeffect) in the | # will allow you to put the command \sideeffect (or @sideeffect) in the | ||||||
| # documentation, which will result in a user-defined paragraph with heading | # 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 | # "Side Effects:". Note that you cannot put \n's in the value part of an alias | ||||||
| # newlines (in the resulting output). You can put ^^ in the value part of an | # to insert newlines (in the resulting output). You can put ^^ in the value part | ||||||
| # alias to insert a newline as if a physical newline was in the original file. | # of an alias to insert a newline as if a physical newline was in the original | ||||||
| # When you need a literal { or } or , in the value part of an alias you have to | # file. When you need a literal { or } or , in the value part of an alias you | ||||||
| # escape them by means of a backslash (\), this can lead to conflicts with the | # have to escape them by means of a backslash (\), this can lead to conflicts | ||||||
| # commands \{ and \} for these it is advised to use the version @{ and @} or use | # with the commands \{ and \} for these it is advised to use the version @{ and | ||||||
| # a double escape (\\{ and \\}) | # @} or use a double escape (\\{ and \\}) | ||||||
|  |  | ||||||
| ALIASES                = | ALIASES                = | ||||||
|  |  | ||||||
| @@ -312,8 +304,8 @@ OPTIMIZE_OUTPUT_SLICE  = NO | |||||||
| # extension. Doxygen has a built-in mapping, but you can override or extend it | # extension. Doxygen has a built-in mapping, but you can override or extend it | ||||||
| # using this tag. The format is ext=language, where ext is a file extension, and | # using this tag. The format is ext=language, where ext is a file extension, and | ||||||
| # language is one of the parsers supported by doxygen: IDL, Java, JavaScript, | # language is one of the parsers supported by doxygen: IDL, Java, JavaScript, | ||||||
| # Csharp (C#), C, C++, D, PHP, md (Markdown), Objective-C, Python, Slice, VHDL, | # Csharp (C#), C, C++, Lex, D, PHP, md (Markdown), Objective-C, Python, Slice, | ||||||
| # Fortran (fixed format Fortran: FortranFixed, free formatted Fortran: | # VHDL, Fortran (fixed format Fortran: FortranFixed, free formatted Fortran: | ||||||
| # FortranFree, unknown formatted Fortran: Fortran. In the later case the parser | # FortranFree, unknown formatted Fortran: Fortran. In the later case the parser | ||||||
| # tries to guess whether the code is fixed or free formatted code, this is the | # tries to guess whether the code is fixed or free formatted code, this is the | ||||||
| # default for Fortran type files). For instance to make doxygen treat .inc files | # default for Fortran type files). For instance to make doxygen treat .inc files | ||||||
| @@ -466,7 +458,7 @@ LOOKUP_CACHE_SIZE      = 0 | |||||||
| # than 0 to get more control over the balance between CPU load and processing | # than 0 to get more control over the balance between CPU load and processing | ||||||
| # speed. At this moment only the input processing can be done using multiple | # speed. At this moment only the input processing can be done using multiple | ||||||
| # threads. Since this is still an experimental feature the default is set to 1, | # threads. Since this is still an experimental feature the default is set to 1, | ||||||
| # which efficively disables parallel processing. Please report any issues you | # which effectively disables parallel processing. Please report any issues you | ||||||
| # encounter. Generating dot graphs in parallel is controlled by the | # encounter. Generating dot graphs in parallel is controlled by the | ||||||
| # DOT_NUM_THREADS setting. | # DOT_NUM_THREADS setting. | ||||||
| # Minimum value: 0, maximum value: 32, default value: 1. | # Minimum value: 0, maximum value: 32, default value: 1. | ||||||
| @@ -610,6 +602,12 @@ HIDE_SCOPE_NAMES       = YES | |||||||
|  |  | ||||||
| HIDE_COMPOUND_REFERENCE= NO | HIDE_COMPOUND_REFERENCE= NO | ||||||
|  |  | ||||||
|  | # If the SHOW_HEADERFILE tag is set to YES then the documentation for a class | ||||||
|  | # will show which file needs to be included to use the class. | ||||||
|  | # The default value is: YES. | ||||||
|  |  | ||||||
|  | SHOW_HEADERFILE        = YES | ||||||
|  |  | ||||||
| # If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of | # If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of | ||||||
| # the files that are included by a file in the documentation of that file. | # the files that are included by a file in the documentation of that file. | ||||||
| # The default value is: YES. | # The default value is: YES. | ||||||
| @@ -767,7 +765,8 @@ FILE_VERSION_FILTER    = | |||||||
| # output files in an output format independent way. To create the layout file | # output files in an output format independent way. To create the layout file | ||||||
| # that represents doxygen's defaults, run doxygen with the -l option. You can | # that represents doxygen's defaults, run doxygen with the -l option. You can | ||||||
| # optionally specify a file name after the option, if omitted DoxygenLayout.xml | # optionally specify a file name after the option, if omitted DoxygenLayout.xml | ||||||
| # will be used as the name of the layout file. | # will be used as the name of the layout file. See also section "Changing the | ||||||
|  | # layout of pages" for information. | ||||||
| # | # | ||||||
| # Note that if you run doxygen from a directory containing a file called | # Note that if you run doxygen from a directory containing a file called | ||||||
| # DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE | # DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE | ||||||
| @@ -813,18 +812,26 @@ WARNINGS               = YES | |||||||
| WARN_IF_UNDOCUMENTED   = YES | WARN_IF_UNDOCUMENTED   = YES | ||||||
|  |  | ||||||
| # If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for | # If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for | ||||||
| # potential errors in the documentation, such as not documenting some parameters | # potential errors in the documentation, such as documenting some parameters in | ||||||
| # in a documented function, or documenting parameters that don't exist or using | # a documented function twice, or documenting parameters that don't exist or | ||||||
| # markup commands wrongly. | # using markup commands wrongly. | ||||||
| # The default value is: YES. | # The default value is: YES. | ||||||
|  |  | ||||||
| WARN_IF_DOC_ERROR      = YES | WARN_IF_DOC_ERROR      = YES | ||||||
|  |  | ||||||
|  | # If WARN_IF_INCOMPLETE_DOC is set to YES, doxygen will warn about incomplete | ||||||
|  | # function parameter documentation. If set to NO, doxygen will accept that some | ||||||
|  | # parameters have no documentation without warning. | ||||||
|  | # The default value is: YES. | ||||||
|  |  | ||||||
|  | WARN_IF_INCOMPLETE_DOC = YES | ||||||
|  |  | ||||||
| # This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that | # This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that | ||||||
| # are documented, but have no documentation for their parameters or return | # are documented, but have no documentation for their parameters or return | ||||||
| # value. If set to NO, doxygen will only warn about wrong or incomplete | # value. If set to NO, doxygen will only warn about wrong parameter | ||||||
| # parameter documentation, but not about the absence of documentation. If | # documentation, but not about the absence of documentation. If EXTRACT_ALL is | ||||||
| # EXTRACT_ALL is set to YES then this flag will automatically be disabled. | # set to YES then this flag will automatically be disabled. See also | ||||||
|  | # WARN_IF_INCOMPLETE_DOC | ||||||
| # The default value is: NO. | # The default value is: NO. | ||||||
|  |  | ||||||
| WARN_NO_PARAMDOC       = NO | WARN_NO_PARAMDOC       = NO | ||||||
| @@ -888,10 +895,10 @@ INPUT_ENCODING         = UTF-8 | |||||||
| # | # | ||||||
| # If left blank the following patterns are tested:*.c, *.cc, *.cxx, *.cpp, | # If left blank the following patterns are tested:*.c, *.cc, *.cxx, *.cpp, | ||||||
| # *.c++, *.java, *.ii, *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, | # *.c++, *.java, *.ii, *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, | ||||||
| # *.hh, *.hxx, *.hpp, *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc, | # *.hh, *.hxx, *.hpp, *.h++, *.l, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, | ||||||
| # *.m, *.markdown, *.md, *.mm, *.dox (to be provided as doxygen C comment), | # *.inc, *.m, *.markdown, *.md, *.mm, *.dox (to be provided as doxygen C | ||||||
| # *.py, *.pyw, *.f90, *.f95, *.f03, *.f08, *.f18, *.f, *.for, *.vhd, *.vhdl, | # comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08, *.f18, *.f, *.for, *.vhd, | ||||||
| # *.ucf, *.qsf and *.ice. | # *.vhdl, *.ucf, *.qsf and *.ice. | ||||||
|  |  | ||||||
| FILE_PATTERNS          = *.c \ | FILE_PATTERNS          = *.c \ | ||||||
|                          *.cc \ |                          *.cc \ | ||||||
| @@ -1268,7 +1275,7 @@ HTML_EXTRA_FILES       = | |||||||
|  |  | ||||||
| # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen | # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen | ||||||
| # will adjust the colors in the style sheet and background images according to | # will adjust the colors in the style sheet and background images according to | ||||||
| # this color. Hue is specified as an angle on a colorwheel, see | # this color. Hue is specified as an angle on a color-wheel, see | ||||||
| # https://en.wikipedia.org/wiki/Hue for more information. For instance the value | # https://en.wikipedia.org/wiki/Hue for more information. For instance the value | ||||||
| # 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300 | # 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300 | ||||||
| # purple, and 360 is red again. | # purple, and 360 is red again. | ||||||
| @@ -1278,7 +1285,7 @@ HTML_EXTRA_FILES       = | |||||||
| HTML_COLORSTYLE_HUE    = 220 | HTML_COLORSTYLE_HUE    = 220 | ||||||
|  |  | ||||||
| # The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors | # The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors | ||||||
| # in the HTML output. For a value of 0 the output will use grayscales only. A | # in the HTML output. For a value of 0 the output will use gray-scales only. A | ||||||
| # value of 255 will produce the most vivid colors. | # value of 255 will produce the most vivid colors. | ||||||
| # Minimum value: 0, maximum value: 255, default value: 100. | # Minimum value: 0, maximum value: 255, default value: 100. | ||||||
| # This tag requires that the tag GENERATE_HTML is set to YES. | # This tag requires that the tag GENERATE_HTML is set to YES. | ||||||
| @@ -1385,8 +1392,12 @@ DOCSET_PUBLISHER_NAME  = Publisher | |||||||
| # If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three | # If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three | ||||||
| # additional HTML index files: index.hhp, index.hhc, and index.hhk. The | # additional HTML index files: index.hhp, index.hhc, and index.hhk. The | ||||||
| # index.hhp is a project file that can be read by Microsoft's HTML Help Workshop | # index.hhp is a project file that can be read by Microsoft's HTML Help Workshop | ||||||
| # (see: | # on Windows. In the beginning of 2021 Microsoft took the original page, with | ||||||
| # https://www.microsoft.com/en-us/download/details.aspx?id=21138) on Windows. | # a.o. the download links, offline the HTML help workshop was already many years | ||||||
|  | # in maintenance mode). You can download the HTML help workshop from the web | ||||||
|  | # archives at Installation executable (see: | ||||||
|  | # http://web.archive.org/web/20160201063255/http://download.microsoft.com/downlo | ||||||
|  | # ad/0/A/9/0A939EF6-E31C-430F-A3DF-DFAE7960D564/htmlhelp.exe). | ||||||
| # | # | ||||||
| # The HTML Help Workshop contains a compiler that can convert all HTML output | # The HTML Help Workshop contains a compiler that can convert all HTML output | ||||||
| # generated by doxygen into a single compiled HTML file (.chm). Compiled HTML | # generated by doxygen into a single compiled HTML file (.chm). Compiled HTML | ||||||
| @@ -1545,16 +1556,28 @@ DISABLE_INDEX          = NO | |||||||
| # to work a browser that supports JavaScript, DHTML, CSS and frames is required | # to work a browser that supports JavaScript, DHTML, CSS and frames is required | ||||||
| # (i.e. any modern browser). Windows users are probably better off using the | # (i.e. any modern browser). Windows users are probably better off using the | ||||||
| # HTML help feature. Via custom style sheets (see HTML_EXTRA_STYLESHEET) one can | # HTML help feature. Via custom style sheets (see HTML_EXTRA_STYLESHEET) one can | ||||||
| # further fine-tune the look of the index. As an example, the default style | # further fine tune the look of the index (see "Fine-tuning the output"). As an | ||||||
| # sheet generated by doxygen has an example that shows how to put an image at | # example, the default style sheet generated by doxygen has an example that | ||||||
| # the root of the tree instead of the PROJECT_NAME. Since the tree basically has | # shows how to put an image at the root of the tree instead of the PROJECT_NAME. | ||||||
| # the same information as the tab index, you could consider setting | # Since the tree basically has the same information as the tab index, you could | ||||||
| # DISABLE_INDEX to YES when enabling this option. | # consider setting DISABLE_INDEX to YES when enabling this option. | ||||||
| # The default value is: NO. | # The default value is: NO. | ||||||
| # This tag requires that the tag GENERATE_HTML is set to YES. | # This tag requires that the tag GENERATE_HTML is set to YES. | ||||||
|  |  | ||||||
| GENERATE_TREEVIEW      = NO | GENERATE_TREEVIEW      = NO | ||||||
|  |  | ||||||
|  | # When both GENERATE_TREEVIEW and DISABLE_INDEX are set to YES, then the | ||||||
|  | # FULL_SIDEBAR option determines if the side bar is limited to only the treeview | ||||||
|  | # area (value NO) or if it should extend to the full height of the window (value | ||||||
|  | # YES). Setting this to YES gives a layout similar to | ||||||
|  | # https://docs.readthedocs.io with more room for contents, but less room for the | ||||||
|  | # project logo, title, and description. If either GENERATOR_TREEVIEW or | ||||||
|  | # DISABLE_INDEX is set to NO, this option has no effect. | ||||||
|  | # The default value is: NO. | ||||||
|  | # This tag requires that the tag GENERATE_HTML is set to YES. | ||||||
|  |  | ||||||
|  | FULL_SIDEBAR           = NO | ||||||
|  |  | ||||||
| # The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that | # The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that | ||||||
| # doxygen will group on one line in the generated HTML documentation. | # doxygen will group on one line in the generated HTML documentation. | ||||||
| # | # | ||||||
| @@ -1627,11 +1650,29 @@ FORMULA_MACROFILE      = | |||||||
|  |  | ||||||
| USE_MATHJAX            = YES | USE_MATHJAX            = YES | ||||||
|  |  | ||||||
|  | # With MATHJAX_VERSION it is possible to specify the MathJax version to be used. | ||||||
|  | # Note that the different versions of MathJax have different requirements with | ||||||
|  | # regards to the different settings, so it is possible that also other MathJax | ||||||
|  | # settings have to be changed when switching between the different MathJax | ||||||
|  | # versions. | ||||||
|  | # Possible values are: MathJax_2 and MathJax_3. | ||||||
|  | # The default value is: MathJax_2. | ||||||
|  | # This tag requires that the tag USE_MATHJAX is set to YES. | ||||||
|  |  | ||||||
|  | MATHJAX_VERSION        = MathJax_2 | ||||||
|  |  | ||||||
| # When MathJax is enabled you can set the default output format to be used for | # When MathJax is enabled you can set the default output format to be used for | ||||||
| # the MathJax output. See the MathJax site (see: | # the MathJax output. For more details about the output format see MathJax | ||||||
| # http://docs.mathjax.org/en/v2.7-latest/output.html) for more details. | # version 2 (see: | ||||||
|  | # http://docs.mathjax.org/en/v2.7-latest/output.html) and MathJax version 3 | ||||||
|  | # (see: | ||||||
|  | # http://docs.mathjax.org/en/latest/web/components/output.html). | ||||||
| # Possible values are: HTML-CSS (which is slower, but has the best | # Possible values are: HTML-CSS (which is slower, but has the best | ||||||
| # compatibility), NativeMML (i.e. MathML) and SVG. | # compatibility. This is the name for Mathjax version 2, for MathJax version 3 | ||||||
|  | # this will be translated into chtml), NativeMML (i.e. MathML. Only supported | ||||||
|  | # for NathJax 2. For MathJax version 3 chtml will be used instead.), chtml (This | ||||||
|  | # is the name for Mathjax version 3, for MathJax version 2 this will be | ||||||
|  | # translated into HTML-CSS) and SVG. | ||||||
| # The default value is: HTML-CSS. | # The default value is: HTML-CSS. | ||||||
| # This tag requires that the tag USE_MATHJAX is set to YES. | # This tag requires that the tag USE_MATHJAX is set to YES. | ||||||
|  |  | ||||||
| @@ -1644,15 +1685,21 @@ MATHJAX_FORMAT         = HTML-CSS | |||||||
| # MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax | # MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax | ||||||
| # Content Delivery Network so you can quickly see the result without installing | # Content Delivery Network so you can quickly see the result without installing | ||||||
| # MathJax. However, it is strongly recommended to install a local copy of | # MathJax. However, it is strongly recommended to install a local copy of | ||||||
| # MathJax from https://www.mathjax.org before deployment. | # MathJax from https://www.mathjax.org before deployment. The default value is: | ||||||
| # The default value is: https://cdn.jsdelivr.net/npm/mathjax@2. | # - in case of MathJax version 2: https://cdn.jsdelivr.net/npm/mathjax@2 | ||||||
|  | # - in case of MathJax version 3: https://cdn.jsdelivr.net/npm/mathjax@3 | ||||||
| # This tag requires that the tag USE_MATHJAX is set to YES. | # This tag requires that the tag USE_MATHJAX is set to YES. | ||||||
|  |  | ||||||
| MATHJAX_RELPATH        = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/ | MATHJAX_RELPATH        = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.5/ | ||||||
|  |  | ||||||
| # The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax | # The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax | ||||||
| # extension names that should be enabled during MathJax rendering. For example | # extension names that should be enabled during MathJax rendering. For example | ||||||
|  | # for MathJax version 2 (see | ||||||
|  | # https://docs.mathjax.org/en/v2.7-latest/tex.html#tex-and-latex-extensions): | ||||||
| # MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols | # MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols | ||||||
|  | # For example for MathJax version 3 (see | ||||||
|  | # http://docs.mathjax.org/en/latest/input/tex/extensions/index.html): | ||||||
|  | # MATHJAX_EXTENSIONS = ams | ||||||
| # This tag requires that the tag USE_MATHJAX is set to YES. | # This tag requires that the tag USE_MATHJAX is set to YES. | ||||||
|  |  | ||||||
| MATHJAX_EXTENSIONS     = | MATHJAX_EXTENSIONS     = | ||||||
| @@ -1761,7 +1808,7 @@ EXTRA_SEARCH_MAPPINGS  = | |||||||
| # If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output. | # If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output. | ||||||
| # The default value is: YES. | # The default value is: YES. | ||||||
|  |  | ||||||
| GENERATE_LATEX         = NO | GENERATE_LATEX         = YES | ||||||
|  |  | ||||||
| # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a | # The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a | ||||||
| # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of | # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of | ||||||
| @@ -1832,29 +1879,31 @@ PAPER_TYPE             = a4 | |||||||
|  |  | ||||||
| EXTRA_PACKAGES         = amsmath | EXTRA_PACKAGES         = amsmath | ||||||
|  |  | ||||||
| # The LATEX_HEADER tag can be used to specify a personal LaTeX header for the | # The LATEX_HEADER tag can be used to specify a user-defined LaTeX header for | ||||||
| # generated LaTeX document. The header should contain everything until the first | # the generated LaTeX document. The header should contain everything until the | ||||||
| # chapter. If it is left blank doxygen will generate a standard header. See | # first chapter. If it is left blank doxygen will generate a standard header. It | ||||||
| # section "Doxygen usage" for information on how to let doxygen write the | # is highly recommended to start with a default header using | ||||||
| # default header to a separate file. | # doxygen -w latex new_header.tex new_footer.tex new_stylesheet.sty | ||||||
|  | # and then modify the file new_header.tex. See also section "Doxygen usage" for | ||||||
|  | # information on how to generate the default header that doxygen normally uses. | ||||||
| # | # | ||||||
| # Note: Only use a user-defined header if you know what you are doing! The | # Note: Only use a user-defined header if you know what you are doing! | ||||||
| # following commands have a special meaning inside the header: $title, | # Note: The header is subject to change so you typically have to regenerate the | ||||||
| # $datetime, $date, $doxygenversion, $projectname, $projectnumber, | # default header when upgrading to a newer version of doxygen. The following | ||||||
| # $projectbrief, $projectlogo. Doxygen will replace $title with the empty | # commands have a special meaning inside the header (and footer): For a | ||||||
| # string, for the replacement values of the other commands the user is referred | # description of the possible markers and block names see the documentation. | ||||||
| # to HTML_HEADER. |  | ||||||
| # This tag requires that the tag GENERATE_LATEX is set to YES. | # This tag requires that the tag GENERATE_LATEX is set to YES. | ||||||
|  |  | ||||||
| LATEX_HEADER           = | LATEX_HEADER           = | ||||||
|  |  | ||||||
| # The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for the | # The LATEX_FOOTER tag can be used to specify a user-defined LaTeX footer for | ||||||
| # generated LaTeX document. The footer should contain everything after the last | # the generated LaTeX document. The footer should contain everything after the | ||||||
| # chapter. If it is left blank doxygen will generate a standard footer. See | # last chapter. If it is left blank doxygen will generate a standard footer. See | ||||||
| # LATEX_HEADER for more information on how to generate a default footer and what | # LATEX_HEADER for more information on how to generate a default footer and what | ||||||
| # special commands can be used inside the footer. | # special commands can be used inside the footer. See also section "Doxygen | ||||||
| # | # usage" for information on how to generate the default footer that doxygen | ||||||
| # Note: Only use a user-defined footer if you know what you are doing! | # normally uses. Note: Only use a user-defined footer if you know what you are | ||||||
|  | # doing! | ||||||
| # This tag requires that the tag GENERATE_LATEX is set to YES. | # This tag requires that the tag GENERATE_LATEX is set to YES. | ||||||
|  |  | ||||||
| LATEX_FOOTER           = | LATEX_FOOTER           = | ||||||
| @@ -1899,8 +1948,7 @@ USE_PDFLATEX           = YES | |||||||
|  |  | ||||||
| # If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode | # If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode | ||||||
| # command to the generated LaTeX files. This will instruct LaTeX to keep running | # command to the generated LaTeX files. This will instruct LaTeX to keep running | ||||||
| # if errors occur, instead of asking the user for help. This option is also used | # if errors occur, instead of asking the user for help. | ||||||
| # when generating formulas in HTML. |  | ||||||
| # The default value is: NO. | # The default value is: NO. | ||||||
| # This tag requires that the tag GENERATE_LATEX is set to YES. | # This tag requires that the tag GENERATE_LATEX is set to YES. | ||||||
|  |  | ||||||
| @@ -1913,16 +1961,6 @@ LATEX_BATCHMODE        = NO | |||||||
|  |  | ||||||
| LATEX_HIDE_INDICES     = NO | LATEX_HIDE_INDICES     = NO | ||||||
|  |  | ||||||
| # If the LATEX_SOURCE_CODE tag is set to YES then doxygen will include source |  | ||||||
| # code with syntax highlighting in the LaTeX output. |  | ||||||
| # |  | ||||||
| # Note that which sources are shown also depends on other settings such as |  | ||||||
| # SOURCE_BROWSER. |  | ||||||
| # The default value is: NO. |  | ||||||
| # This tag requires that the tag GENERATE_LATEX is set to YES. |  | ||||||
|  |  | ||||||
| LATEX_SOURCE_CODE      = YES |  | ||||||
|  |  | ||||||
| # The LATEX_BIB_STYLE tag can be used to specify the style to use for the | # The LATEX_BIB_STYLE tag can be used to specify the style to use for the | ||||||
| # bibliography, e.g. plainnat, or ieeetr. See | # bibliography, e.g. plainnat, or ieeetr. See | ||||||
| # https://en.wikipedia.org/wiki/BibTeX and \cite for more info. | # https://en.wikipedia.org/wiki/BibTeX and \cite for more info. | ||||||
| @@ -2003,16 +2041,6 @@ RTF_STYLESHEET_FILE    = | |||||||
|  |  | ||||||
| RTF_EXTENSIONS_FILE    = | RTF_EXTENSIONS_FILE    = | ||||||
|  |  | ||||||
| # If the RTF_SOURCE_CODE tag is set to YES then doxygen will include source code |  | ||||||
| # with syntax highlighting in the RTF output. |  | ||||||
| # |  | ||||||
| # Note that which sources are shown also depends on other settings such as |  | ||||||
| # SOURCE_BROWSER. |  | ||||||
| # The default value is: NO. |  | ||||||
| # This tag requires that the tag GENERATE_RTF is set to YES. |  | ||||||
|  |  | ||||||
| RTF_SOURCE_CODE        = NO |  | ||||||
|  |  | ||||||
| #--------------------------------------------------------------------------- | #--------------------------------------------------------------------------- | ||||||
| # Configuration options related to the man page output | # Configuration options related to the man page output | ||||||
| #--------------------------------------------------------------------------- | #--------------------------------------------------------------------------- | ||||||
| @@ -2109,15 +2137,6 @@ GENERATE_DOCBOOK       = NO | |||||||
|  |  | ||||||
| DOCBOOK_OUTPUT         = docbook | DOCBOOK_OUTPUT         = docbook | ||||||
|  |  | ||||||
| # If the DOCBOOK_PROGRAMLISTING tag is set to YES, doxygen will include the |  | ||||||
| # program listings (including syntax highlighting and cross-referencing |  | ||||||
| # information) to the DOCBOOK output. Note that enabling this will significantly |  | ||||||
| # increase the size of the DOCBOOK output. |  | ||||||
| # The default value is: NO. |  | ||||||
| # This tag requires that the tag GENERATE_DOCBOOK is set to YES. |  | ||||||
|  |  | ||||||
| DOCBOOK_PROGRAMLISTING = NO |  | ||||||
|  |  | ||||||
| #--------------------------------------------------------------------------- | #--------------------------------------------------------------------------- | ||||||
| # Configuration options for the AutoGen Definitions output | # Configuration options for the AutoGen Definitions output | ||||||
| #--------------------------------------------------------------------------- | #--------------------------------------------------------------------------- | ||||||
| @@ -2625,8 +2644,8 @@ GENERATE_LEGEND        = YES | |||||||
| # If the DOT_CLEANUP tag is set to YES, doxygen will remove the intermediate | # If the DOT_CLEANUP tag is set to YES, doxygen will remove the intermediate | ||||||
| # files that are used to generate the various graphs. | # files that are used to generate the various graphs. | ||||||
| # | # | ||||||
| # Note: This setting is not only used for dot files but also for msc and | # Note: This setting is not only used for dot files but also for msc temporary | ||||||
| # plantuml temporary files. | # files. | ||||||
| # The default value is: YES. | # The default value is: YES. | ||||||
|  |  | ||||||
| DOT_CLEANUP            = YES | DOT_CLEANUP            = YES | ||||||
|   | |||||||
		Reference in New Issue
	
	Block a user