Skip to content
Snippets Groups Projects
Doxyfile 104 KiB
Newer Older
  • Learn to ignore specific revisions
  • Campbell Barton's avatar
    Campbell Barton committed
    # 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.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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.
    
    #---------------------------------------------------------------------------
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Configuration options related to the alphabetical class index
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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.
    
    
    #---------------------------------------------------------------------------
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Configuration options related to the HTML output
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_HTML tag is set to YES, doxygen will generate HTML output
    # The default value is: YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a
    # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
    # it.
    # The default directory is: html.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The HTML_FILE_EXTENSION tag can be used to specify the file extension for each
    # generated HTML page (for example: .htm, .php, .asp).
    # The default value is: .html.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The HTML_HEADER tag can be used to specify a user-defined HTML header file for
    # each generated HTML page. If the tag is left blank doxygen will generate a
    # standard header.
    #
    # To get valid HTML the header file that includes any scripts and style sheets
    # that doxygen needs, which is dependent on the configuration options used (e.g.
    # the setting GENERATE_TREEVIEW). It is highly recommended to start with a
    # default header using
    # doxygen -w html new_header.html new_footer.html new_stylesheet.css
    # YourConfigFile
    # and then modify the file new_header.html. See also section "Doxygen usage"
    # for information on how to generate the default header that doxygen normally
    # uses.
    # Note: The header is subject to change so you typically have to regenerate the
    # default header when upgrading to a newer version of doxygen. For a description
    # of the possible markers and block names see the documentation.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each
    # generated HTML page. If the tag is left blank doxygen will generate a standard
    # footer. See HTML_HEADER for more information on how to generate a default
    # footer and what special commands can be used inside the footer. See also
    # section "Doxygen usage" for information on how to generate the default footer
    # that doxygen normally uses.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Nathan Letwory's avatar
    Nathan Letwory committed
    HTML_FOOTER            = footer.html
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The HTML_STYLESHEET tag can be used to specify a user-defined cascading style
    # sheet that is used by each HTML page. It can be used to fine-tune the look of
    # the HTML output. If left blank doxygen will generate a default style sheet.
    # See also section "Doxygen usage" for information on how to generate the style
    # sheet that doxygen normally uses.
    # Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as
    # it is more robust and this tag (HTML_STYLESHEET) will in the future become
    # obsolete.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined
    # cascading style sheets that are included after the standard style sheets
    # created by doxygen. Using this option one can overrule certain style aspects.
    # This is preferred over using HTML_STYLESHEET since it does not replace the
    # standard style sheet and is therefore more robust against future updates.
    # Doxygen will copy the style sheet files to the output directory.
    # Note: The order of the extra style sheet files is of importance (e.g. the last
    # style sheet in the list overrules the setting of the previous ones in the
    # list). For an example see the documentation.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    
    HTML_EXTRA_STYLESHEET  =
    
    # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
    # other source files which should be copied to the HTML output directory. Note
    # that these files will be copied to the base HTML output directory. Use the
    # $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these
    
    Campbell Barton's avatar
    Campbell Barton committed
    # files. In the HTML_STYLESHEET file, use the file name only. Also note that the
    # files will be copied as-is; there are no commands or markers available.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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
    # this color. Hue is specified as an angle on a colorwheel, see
    
    Aaron Carlisle's avatar
    Aaron Carlisle committed
    # https://en.wikipedia.org/wiki/Hue for more information. For instance the value
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300
    # purple, and 360 is red again.
    # Minimum value: 0, maximum value: 359, default value: 220.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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
    # value of 255 will produce the most vivid colors.
    # Minimum value: 0, maximum value: 255, default value: 100.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the
    # luminance component of the colors in the HTML output. Values below 100
    # gradually make the output lighter, whereas values above 100 make the output
    # darker. The value divided by 100 is the actual gamma applied, so 80 represents
    # a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not
    # change the gamma.
    # Minimum value: 40, maximum value: 240, default value: 80.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    HTML_COLORSTYLE_GAMMA  = 79
    
    # If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
    
    Campbell Barton's avatar
    Campbell Barton committed
    # page will contain the date and time when the page was generated. Setting this
    
    # to YES can help to show when doxygen was last run and thus if the
    # documentation is up to date.
    # The default value is: NO.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    # If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML
    # documentation will contain sections that can be hidden and shown after the
    # page has loaded.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries
    # shown in the various tree structured indices initially; the user can expand
    # and collapse entries dynamically later on. Doxygen will expand the tree to
    # such a level that at most the specified number of entries are visible (unless
    # a fully collapsed tree already exceeds this amount). So setting the number of
    # entries 1 will produce a full collapsed tree by default. 0 is a special value
    # representing an infinite number of entries and will result in a full expanded
    # tree by default.
    # Minimum value: 0, maximum value: 9999, default value: 100.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_DOCSET tag is set to YES, additional index files will be
    # generated that can be used as input for Apple's Xcode 3 integrated development
    # environment (see: http://developer.apple.com/tools/xcode/), introduced with
    # OSX 10.5 (Leopard). To create a documentation set, doxygen will generate a
    # Makefile in the HTML output directory. Running make will produce the docset in
    # that directory and running make install will install the docset in
    # ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at
    # startup. See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # This tag determines the name of the docset feed. A documentation feed provides
    # an umbrella under which multiple documentation sets from a single provider
    # (such as a company or product suite) can be grouped.
    # The default value is: Doxygen generated docs.
    # This tag requires that the tag GENERATE_DOCSET is set to YES.
    
    
    DOCSET_FEEDNAME        = "Doxygen generated docs"
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # This tag specifies a string that should uniquely identify the documentation
    # set bundle. This should be a reverse domain-name style string, e.g.
    # com.mycompany.MyDocSet. Doxygen will append .docset to the name.
    # The default value is: org.doxygen.Project.
    # This tag requires that the tag GENERATE_DOCSET is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify
    # the documentation publisher. This should be a reverse domain-name style
    # string, e.g. com.mycompany.MyDocSet.documentation.
    # The default value is: org.doxygen.Publisher.
    # This tag requires that the tag GENERATE_DOCSET is set to YES.
    
    
    DOCSET_PUBLISHER_ID    = org.doxygen.Publisher
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher.
    # The default value is: Publisher.
    # This tag requires that the tag GENERATE_DOCSET is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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
    # index.hhp is a project file that can be read by Microsoft's HTML Help Workshop
    # (see: http://www.microsoft.com/en-us/download/details.aspx?id=21138) on
    # Windows.
    #
    # 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
    # files are now used as the Windows 98 help format, and will replace the old
    # Windows help format (.hlp) on all Windows platforms in the future. Compressed
    # HTML files also contain an index, a table of contents, and you can search for
    # words in the documentation. The HTML workshop also contains a viewer for
    # compressed HTML files.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The CHM_FILE tag can be used to specify the file name of the resulting .chm
    # file. You can add a path in front of the file if the result should not be
    
    # written to the html output directory.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
    
    CHM_FILE               = blender.chm
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The HHC_LOCATION tag can be used to specify the location (absolute path
    # including file name) of the HTML help compiler (hhc.exe). If non-empty,
    # doxygen will try to run the HTML help compiler on the generated index.hhp.
    # The file has to be specified with full path.
    # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
    
    HHC_LOCATION           = "C:/Program Files (x86)/HTML Help Workshop/hhc.exe"
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The GENERATE_CHI flag controls if a separate .chi index file is generated
    # (YES) or that it should be included in the master .chm file (NO).
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The CHM_INDEX_ENCODING is used to encode HtmlHelp index (hhk), content (hhc)
    # and project file content.
    # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The BINARY_TOC flag controls whether a binary table of contents is generated
    # (YES) or a normal table of contents (NO) in the .chm file. Furthermore it
    # enables the Previous and Next buttons.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The TOC_EXPAND flag can be set to YES to add extra items for group members to
    # the table of contents of the HTML help documentation and to the tree view.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
    
    # If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and
    
    Campbell Barton's avatar
    Campbell Barton committed
    # QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that
    # can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help
    # (.qch) of the generated HTML documentation.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify
    # the file name of the resulting .qch file. The path specified is relative to
    # the HTML output folder.
    # This tag requires that the tag GENERATE_QHP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help
    # Project output. For more information please see Qt Help Project / Namespace
    # (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#namespace).
    # The default value is: org.doxygen.Project.
    # This tag requires that the tag GENERATE_QHP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt
    # Help Project output. For more information please see Qt Help Project / Virtual
    # Folders (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#virtual-
    # folders).
    # The default value is: doc.
    # This tag requires that the tag GENERATE_QHP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom
    # filter to add. For more information please see Qt Help Project / Custom
    # Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-
    # filters).
    # This tag requires that the tag GENERATE_QHP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the
    # custom filter to add. For more information please see Qt Help Project / Custom
    # Filters (see: http://qt-project.org/doc/qt-4.8/qthelpproject.html#custom-
    # filters).
    # This tag requires that the tag GENERATE_QHP is set to YES.
    
    # The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this
    
    Campbell Barton's avatar
    Campbell Barton committed
    # project's filter section matches. Qt Help Project / Filter Attributes (see:
    # http://qt-project.org/doc/qt-4.8/qthelpproject.html#filter-attributes).
    # This tag requires that the tag GENERATE_QHP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The QHG_LOCATION tag can be used to specify the location of Qt's
    # qhelpgenerator. If non-empty doxygen will try to run qhelpgenerator on the
    # generated .qhp file.
    # This tag requires that the tag GENERATE_QHP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be
    # generated, together with the HTML files, they form an Eclipse help plugin. To
    # install this plugin and make it available under the help contents menu in
    # Eclipse, the contents of the directory containing the HTML and XML files needs
    # to be copied into the plugins directory of eclipse. The name of the directory
    # within the plugins directory should be the same as the ECLIPSE_DOC_ID value.
    # After copying Eclipse needs to be restarted before the help appears.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # A unique identifier for the Eclipse help plugin. When installing the plugin
    # the directory name containing the HTML and XML files should also have this
    # name. Each documentation set should have its own identifier.
    # The default value is: org.doxygen.Project.
    # This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If you want full control over the layout of the generated HTML pages it might
    # be necessary to disable the index and replace it with your own. The
    # DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top
    # of each HTML page. A value of NO enables the index and the value YES disables
    # it. Since the tabs in the index contain the same information as the navigation
    # tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    # The GENERATE_TREEVIEW tag is used to specify whether a tree-like index
    
    Campbell Barton's avatar
    Campbell Barton committed
    # structure should be generated to display hierarchical information. If the tag
    # value is set to YES, a side panel will be generated containing a tree-like
    # index structure (just like the one that is generated for HTML Help). For this
    # 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
    # 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
    # sheet generated by doxygen has an example that shows how to put an image at
    # the root of the tree instead of the PROJECT_NAME. Since the tree basically has
    # the same information as the tab index, you could consider setting
    # DISABLE_INDEX to YES when enabling this option.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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.
    #
    # Note that a value of 0 will completely suppress the enum values from appearing
    # in the overview section.
    # Minimum value: 0, maximum value: 20, default value: 4.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used
    # to set the initial width (in pixels) of the frame in which the tree is shown.
    # Minimum value: 0, maximum value: 1500, default value: 250.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    TREEVIEW_WIDTH         = 246
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the EXT_LINKS_IN_WINDOW option is set to YES, doxygen will open links to
    # external symbols imported via tag files in a separate window.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Use this tag to change the font size of LaTeX formulas included as images in
    # the HTML documentation. When you change the font size after a successful
    # doxygen run you need to manually remove any form_*.png images from the HTML
    # output directory to force them to be regenerated.
    # Minimum value: 8, maximum value: 50, default value: 10.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    # Use the FORMULA_TRANPARENT tag to determine whether or not the images
    
    Campbell Barton's avatar
    Campbell Barton committed
    # generated for formulas are transparent PNGs. Transparent PNGs are not
    # supported properly for IE 6.0, but are supported on all modern browsers.
    #
    # Note that when changing this option you need to delete any form_*.png files in
    # the HTML output directory before the changes have effect.
    # The default value is: YES.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see
    # http://www.mathjax.org) which uses client side Javascript for the rendering
    # instead of using pre-rendered bitmaps. Use this if you do not have LaTeX
    # installed or if you want to formulas look prettier in the HTML output. When
    # enabled you may also need to install MathJax separately and configure the path
    # to it using the MATHJAX_RELPATH option.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    # When MathJax is enabled you can set the default output format to be used for
    
    Campbell Barton's avatar
    Campbell Barton committed
    # the MathJax output. See the MathJax site (see:
    # http://docs.mathjax.org/en/latest/output.html) for more details.
    # Possible values are: HTML-CSS (which is slower, but has the best
    # compatibility), NativeMML (i.e. MathML) and SVG.
    # The default value is: HTML-CSS.
    # This tag requires that the tag USE_MATHJAX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # When MathJax is enabled you need to specify the location relative to the HTML
    # output directory using the MATHJAX_RELPATH option. The destination directory
    # should contain the MathJax.js script. For instance, if the mathjax directory
    # is located at the same level as the HTML output directory, then
    # MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax
    # 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 from http://www.mathjax.org before deployment.
    # The default value is: http://cdn.mathjax.org/mathjax/latest.
    # This tag requires that the tag USE_MATHJAX is set to YES.
    
    
    MATHJAX_RELPATH        = http://www.mathjax.org/mathjax
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax
    # extension names that should be enabled during MathJax rendering. For example
    # MATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols
    # This tag requires that the tag USE_MATHJAX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces
    # of code that will be used on startup of the MathJax code. See the MathJax site
    # (see: http://docs.mathjax.org/en/latest/output.html) for more details. For an
    # example see the documentation.
    # This tag requires that the tag USE_MATHJAX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # When the SEARCHENGINE tag is enabled doxygen will generate a search box for
    # the HTML output. The underlying search engine uses javascript and DHTML and
    # should work on any modern browser. Note that when using HTML help
    # (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET)
    # there is already a search function so this one should typically be disabled.
    # For large projects the javascript based search engine can be slow, then
    # enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to
    # search using the keyboard; to jump to the search box use <access key> + S
    # (what the <access key> is depends on the OS and browser, but it is typically
    # <CTRL>, <ALT>/<option>, or both). Inside the search box use the <cursor down
    # key> to jump into the search results window, the results can be navigated
    # using the <cursor keys>. Press <Enter> to select an item or <escape> to cancel
    # the search. The filter options can be selected when the cursor is inside the
    # search box by pressing <Shift>+<cursor down>. Also here use the <cursor keys>
    # to select a filter and <Enter> or <escape> to activate or cancel the filter
    # option.
    # The default value is: YES.
    # This tag requires that the tag GENERATE_HTML is set to YES.
    
    # When the SERVER_BASED_SEARCH tag is enabled the search engine will be
    
    Campbell Barton's avatar
    Campbell Barton committed
    # implemented using a web server instead of a web client using Javascript. There
    # are two flavors of web server based searching depending on the EXTERNAL_SEARCH
    # setting. When disabled, doxygen will generate a PHP script for searching and
    # an index file used by the script. When EXTERNAL_SEARCH is enabled the indexing
    # and searching needs to be provided by external tools. See the section
    # "External Indexing and Searching" for details.
    # The default value is: NO.
    # This tag requires that the tag SEARCHENGINE is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP
    
    # script for searching. Instead the search results are written to an XML file
    # which needs to be processed by an external indexer. Doxygen will invoke an
    
    Campbell Barton's avatar
    Campbell Barton committed
    # external search engine pointed to by the SEARCHENGINE_URL option to obtain the
    # search results.
    #
    # Doxygen ships with an example indexer (doxyindexer) and search engine
    # (doxysearch.cgi) which are based on the open source search engine library
    # Xapian (see: http://xapian.org/).
    #
    # See the section "External Indexing and Searching" for details.
    # The default value is: NO.
    # This tag requires that the tag SEARCHENGINE is set to YES.
    
    
    EXTERNAL_SEARCH        = NO
    
    # The SEARCHENGINE_URL should point to a search engine hosted by a web server
    
    Campbell Barton's avatar
    Campbell Barton committed
    # which will return the search results when EXTERNAL_SEARCH is enabled.
    #
    # Doxygen ships with an example indexer (doxyindexer) and search engine
    # (doxysearch.cgi) which are based on the open source search engine library
    # Xapian (see: http://xapian.org/). See the section "External Indexing and
    # Searching" for details.
    # This tag requires that the tag SEARCHENGINE is set to YES.
    
    
    SEARCHENGINE_URL       =
    
    # When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the unindexed
    # search data is written to a file for indexing by an external tool. With the
    # SEARCHDATA_FILE tag the name of this file can be specified.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The default file is: searchdata.xml.
    # This tag requires that the tag SEARCHENGINE is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the
    
    # EXTERNAL_SEARCH_ID tag can be used as an identifier for the project. This is
    # useful in combination with EXTRA_SEARCH_MAPPINGS to search through multiple
    # projects and redirect the results back to the right project.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # This tag requires that the tag SEARCHENGINE is set to YES.
    
    
    EXTERNAL_SEARCH_ID     =
    
    # The EXTRA_SEARCH_MAPPINGS tag can be used to enable searching through doxygen
    # projects other than the one defined by this configuration file, but that are
    # all added to the same external search index. Each project needs to have a
    
    Campbell Barton's avatar
    Campbell Barton committed
    # unique id set via EXTERNAL_SEARCH_ID. The search mapping then maps the id of
    # to a relative location where the documentation can be found. The format is:
    # EXTRA_SEARCH_MAPPINGS = tagname1=loc1 tagname2=loc2 ...
    # This tag requires that the tag SEARCHENGINE is set to YES.
    
    #---------------------------------------------------------------------------
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Configuration options related to the LaTeX output
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.
    # The default value is: YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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
    # it.
    # The default directory is: latex.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    # The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
    
    Campbell Barton's avatar
    Campbell Barton committed
    # invoked.
    #
    # Note that when enabling USE_PDFLATEX this option is only used for generating
    # bitmaps for formulas in the HTML output, but not in the Makefile that is
    # written to the output directory.
    # The default file is: latex.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate
    # index for LaTeX.
    # The default file is: makeindex.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the COMPACT_LATEX tag is set to YES, doxygen generates more compact LaTeX
    # documents. This may be useful for small projects and may help to save some
    # trees in general.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The PAPER_TYPE tag can be used to set the paper type that is used by the
    # printer.
    # Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x
    # 14 inches) and executive (7.25 x 10.5 inches).
    # The default value is: a4.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
    
    # that should be included in the LaTeX output. The package can be specified just
    # by its name or with the correct syntax as to be used with the LaTeX
    # \usepackage command. To get the times font for instance you can specify :
    # EXTRA_PACKAGES=times or EXTRA_PACKAGES={times}
    # To use the option intlimits with the amsmath package you can specify:
    # EXTRA_PACKAGES=[intlimits]{amsmath}
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If left blank no extra packages will be included.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The LATEX_HEADER tag can be used to specify a personal LaTeX header for the
    # generated LaTeX document. The header should contain everything until the first
    # chapter. If it is left blank doxygen will generate a standard header. See
    # section "Doxygen usage" for information on how to let doxygen write the
    # default header to a separate file.
    #
    # Note: Only use a user-defined header if you know what you are doing! The
    # following commands have a special meaning inside the header: $title,
    # $datetime, $date, $doxygenversion, $projectname, $projectnumber,
    # $projectbrief, $projectlogo. Doxygen will replace $title with the empty
    # string, for the replacement values of the other commands the user is referred
    # to HTML_HEADER.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for the
    # generated LaTeX document. The footer should contain everything after the 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
    # special commands can be used inside the footer.
    #
    # 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.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The LATEX_EXTRA_STYLESHEET tag can be used to specify additional user-defined
    # LaTeX style sheets that are included after the standard style sheets created
    # by doxygen. Using this option one can overrule certain style aspects. Doxygen
    # will copy the style sheet files to the output directory.
    # Note: The order of the extra style sheet files is of importance (e.g. the last
    # style sheet in the list overrules the setting of the previous ones in the
    # list).
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_EXTRA_STYLESHEET =
    
    # The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or
    # other source files which should be copied to the LATEX_OUTPUT output
    # directory. Note that the files will be copied as-is; there are no commands or
    # markers available.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is
    # prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will
    # contain links (just like the HTML output) instead of page references. This
    # makes the output suitable for online browsing using a PDF viewer.
    # The default value is: YES.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the USE_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate
    # the PDF file directly from the LaTeX files. Set this option to YES, to get a
    
    # higher quality PDF documentation.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The default value is: YES.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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
    # if errors occur, instead of asking the user for help. This option is also used
    # when generating formulas in HTML.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the
    # index chapters (such as File Index, Compound Index, etc.) in the output.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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.
    
    # The LATEX_BIB_STYLE tag can be used to specify the style to use for the
    
    Campbell Barton's avatar
    Campbell Barton committed
    # bibliography, e.g. plainnat, or ieeetr. See
    
    Aaron Carlisle's avatar
    Aaron Carlisle committed
    # https://en.wikipedia.org/wiki/BibTeX and \cite for more info.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The default value is: plain.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    # If the LATEX_TIMESTAMP tag is set to YES then the footer of each generated
    # page will contain the date and time when the page was generated. Setting this
    # to NO can help when comparing the output of multiple runs.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_LATEX is set to YES.
    
    LATEX_TIMESTAMP        = NO
    
    
    #---------------------------------------------------------------------------
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Configuration options related to the RTF output
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_RTF tag is set to YES, doxygen will generate RTF output. The
    # RTF output is optimized for Word 97 and may not look too pretty with other RTF
    # readers/editors.
    # The default value is: NO.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a
    # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
    # it.
    # The default directory is: rtf.
    # This tag requires that the tag GENERATE_RTF is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the COMPACT_RTF tag is set to YES, doxygen generates more compact RTF
    # documents. This may be useful for small projects and may help to save some
    # trees in general.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_RTF is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will
    # contain hyperlink fields. The RTF file will contain links (just like the HTML
    # output) instead of page references. This makes the output suitable for online
    # browsing using Word or some other Word compatible readers that support those
    # fields.
    #
    # Note: WordPad (write) and others do not support links.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_RTF is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Load stylesheet definitions from file. Syntax is similar to doxygen's config
    # file, i.e. a series of assignments. You only have to provide replacements,
    # missing definitions are set to their default value.
    #
    # See also section "Doxygen usage" for information on how to generate the
    # default style sheet that doxygen normally uses.
    # This tag requires that the tag GENERATE_RTF is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Set optional variables used in the generation of an RTF document. Syntax is
    # similar to doxygen's config file. A template extensions file can be generated
    # using doxygen -e rtf extensionFile.
    # This tag requires that the tag GENERATE_RTF is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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
    
    
    #---------------------------------------------------------------------------
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Configuration options related to the man page output
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_MAN tag is set to YES, doxygen will generate man pages for
    # classes and files.
    # The default value is: NO.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The MAN_OUTPUT tag is used to specify where the man pages will be put. If a
    # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
    # it. A directory man3 will be created inside the directory specified by
    # MAN_OUTPUT.
    # The default directory is: man.
    # This tag requires that the tag GENERATE_MAN is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The MAN_EXTENSION tag determines the extension that is added to the generated
    # man pages. In case the manual section does not start with a number, the number
    # 3 is prepended. The dot (.) at the beginning of the MAN_EXTENSION tag is
    # optional.
    # The default value is: .3.
    # This tag requires that the tag GENERATE_MAN is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The MAN_SUBDIR tag determines the name of the directory created within
    # MAN_OUTPUT in which the man pages are placed. If defaults to man followed by
    # MAN_EXTENSION with the initial . removed.
    # This tag requires that the tag GENERATE_MAN is set to YES.
    
    MAN_SUBDIR             =
    
    # If the MAN_LINKS tag is set to YES and doxygen generates man output, then it
    # will generate one additional man file for each entity documented in the real
    # man page(s). These additional files only source the real man page, but without
    # them the man command would be unable to find the correct page.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_MAN is set to YES.
    
    
    MAN_LINKS              = NO
    
    #---------------------------------------------------------------------------
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Configuration options related to the XML output
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_XML tag is set to YES, doxygen will generate an XML file that
    # captures the structure of the code including all documentation.
    # The default value is: NO.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The XML_OUTPUT tag is used to specify where the XML pages will be put. If a
    # relative path is entered the value of OUTPUT_DIRECTORY will be put in front of
    # it.
    # The default directory is: xml.
    # This tag requires that the tag GENERATE_XML is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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.
    
    #---------------------------------------------------------------------------
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Configuration options related to the DOCBOOK output
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_DOCBOOK tag is set to YES, doxygen will generate Docbook files
    
    # that can be used to generate PDF.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The default value is: NO.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put.
    
    # If a relative path is entered the value of OUTPUT_DIRECTORY will be put in
    
    Campbell Barton's avatar
    Campbell Barton committed
    # front of it.
    # The default directory is: docbook.
    # This tag requires that the tag GENERATE_DOCBOOK is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # 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
    
    
    #---------------------------------------------------------------------------
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Configuration options for the AutoGen Definitions output
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_AUTOGEN_DEF tag is set to YES, doxygen will generate an
    # AutoGen Definitions (see http://autogen.sf.net) file that captures the
    # structure of the code including all documentation. Note that this feature is
    # still experimental and incomplete at the moment.
    # The default value is: NO.
    
    
    GENERATE_AUTOGEN_DEF   = NO
    
    #---------------------------------------------------------------------------
    
    Campbell Barton's avatar
    Campbell Barton committed
    # Configuration options related to the Perl module output
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the GENERATE_PERLMOD tag is set to YES, doxygen will generate a Perl module
    # file that captures the structure of the code including all documentation.
    #
    # Note that this feature is still experimental and incomplete at the moment.
    # The default value is: NO.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the PERLMOD_LATEX tag is set to YES, doxygen will generate the necessary
    # Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI
    # output from the Perl module output.
    # The default value is: NO.
    # This tag requires that the tag GENERATE_PERLMOD is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the PERLMOD_PRETTY tag is set to YES, the Perl module output will be nicely
    # formatted so it can be parsed by a human reader. This is useful if you want to
    # understand what is going on. On the other hand, if this tag is set to NO, the
    # size of the Perl module output will be much smaller and Perl will parse it
    # just the same.
    # The default value is: YES.
    # This tag requires that the tag GENERATE_PERLMOD is set to YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # The names of the make variables in the generated doxyrules.make file are
    # prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. This is useful
    # so different doxyrules.make files included by the same Makefile don't
    # overwrite each other's variables.
    # This tag requires that the tag GENERATE_PERLMOD is set to YES.
    
    
    #---------------------------------------------------------------------------
    # Configuration options related to the preprocessor
    
    #---------------------------------------------------------------------------
    
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the ENABLE_PREPROCESSING tag is set to YES, doxygen will evaluate all
    # C-preprocessor directives found in the sources and include files.
    # The default value is: YES.
    
    Campbell Barton's avatar
    Campbell Barton committed
    # If the MACRO_EXPANSION tag is set to YES, doxygen will expand all macro names
    # in the source code. If set to NO, only conditional compilation will be
    # performed. Macro expansion can be done in a controlled way by setting
    # EXPAND_ONLY_PREDEF to YES.
    # The default value is: NO.
    # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.