1*bf2c3715SXin Li# Doxyfile 1.8.1.1 2*bf2c3715SXin Li 3*bf2c3715SXin Li# This file describes the settings to be used by the documentation system 4*bf2c3715SXin Li# doxygen (www.doxygen.org) for a project. 5*bf2c3715SXin Li# 6*bf2c3715SXin Li# All text after a hash (#) is considered a comment and will be ignored. 7*bf2c3715SXin Li# The format is: 8*bf2c3715SXin Li# TAG = value [value, ...] 9*bf2c3715SXin Li# For lists items can also be appended using: 10*bf2c3715SXin Li# TAG += value [value, ...] 11*bf2c3715SXin Li# Values that contain spaces should be placed between quotes (" "). 12*bf2c3715SXin Li 13*bf2c3715SXin Li#--------------------------------------------------------------------------- 14*bf2c3715SXin Li# Project related configuration options 15*bf2c3715SXin Li#--------------------------------------------------------------------------- 16*bf2c3715SXin Li 17*bf2c3715SXin Li# This tag specifies the encoding used for all characters in the config file 18*bf2c3715SXin Li# that follow. The default is UTF-8 which is also the encoding used for all 19*bf2c3715SXin Li# text before the first occurrence of this tag. Doxygen uses libiconv (or the 20*bf2c3715SXin Li# iconv built into libc) for the transcoding. See 21*bf2c3715SXin Li# http://www.gnu.org/software/libiconv for the list of possible encodings. 22*bf2c3715SXin Li 23*bf2c3715SXin LiDOXYFILE_ENCODING = UTF-8 24*bf2c3715SXin Li 25*bf2c3715SXin Li# The PROJECT_NAME tag is a single word (or sequence of words) that should 26*bf2c3715SXin Li# identify the project. Note that if you do not use Doxywizard you need 27*bf2c3715SXin Li# to put quotes around the project name if it contains spaces. 28*bf2c3715SXin Li 29*bf2c3715SXin LiPROJECT_NAME = ${EIGEN_DOXY_PROJECT_NAME} 30*bf2c3715SXin Li 31*bf2c3715SXin Li# The PROJECT_NUMBER tag can be used to enter a project or revision number. 32*bf2c3715SXin Li# This could be handy for archiving the generated documentation or 33*bf2c3715SXin Li# if some version control system is used. 34*bf2c3715SXin Li 35*bf2c3715SXin Li# EIGEN_VERSION is set in the root CMakeLists.txt 36*bf2c3715SXin Li 37*bf2c3715SXin LiPROJECT_NUMBER = "${EIGEN_VERSION}" 38*bf2c3715SXin Li 39*bf2c3715SXin Li# Using the PROJECT_BRIEF tag one can provide an optional one line description 40*bf2c3715SXin Li# for a project that appears at the top of each page and should give viewer 41*bf2c3715SXin Li# a quick idea about the purpose of the project. Keep the description short. 42*bf2c3715SXin Li 43*bf2c3715SXin LiPROJECT_BRIEF = 44*bf2c3715SXin Li 45*bf2c3715SXin Li# With the PROJECT_LOGO tag one can specify an logo or icon that is 46*bf2c3715SXin Li# included in the documentation. The maximum height of the logo should not 47*bf2c3715SXin Li# exceed 55 pixels and the maximum width should not exceed 200 pixels. 48*bf2c3715SXin Li# Doxygen will copy the logo to the output directory. 49*bf2c3715SXin Li 50*bf2c3715SXin LiPROJECT_LOGO = "${Eigen_SOURCE_DIR}/doc/Eigen_Silly_Professor_64x64.png" 51*bf2c3715SXin Li 52*bf2c3715SXin Li# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) 53*bf2c3715SXin Li# base path where the generated documentation will be put. 54*bf2c3715SXin Li# If a relative path is entered, it will be relative to the location 55*bf2c3715SXin Li# where doxygen was started. If left blank the current directory will be used. 56*bf2c3715SXin Li 57*bf2c3715SXin LiOUTPUT_DIRECTORY = "${Eigen_BINARY_DIR}/doc${EIGEN_DOXY_OUTPUT_DIRECTORY_SUFFIX}" 58*bf2c3715SXin Li 59*bf2c3715SXin Li# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 60*bf2c3715SXin Li# 4096 sub-directories (in 2 levels) under the output directory of each output 61*bf2c3715SXin Li# format and will distribute the generated files over these directories. 62*bf2c3715SXin Li# Enabling this option can be useful when feeding doxygen a huge amount of 63*bf2c3715SXin Li# source files, where putting all generated files in the same directory would 64*bf2c3715SXin Li# otherwise cause performance problems for the file system. 65*bf2c3715SXin Li 66*bf2c3715SXin LiCREATE_SUBDIRS = NO 67*bf2c3715SXin Li 68*bf2c3715SXin Li# The OUTPUT_LANGUAGE tag is used to specify the language in which all 69*bf2c3715SXin Li# documentation generated by doxygen is written. Doxygen will use this 70*bf2c3715SXin Li# information to generate all constant output in the proper language. 71*bf2c3715SXin Li# The default language is English, other supported languages are: 72*bf2c3715SXin Li# Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional, 73*bf2c3715SXin Li# Croatian, Czech, Danish, Dutch, Esperanto, Farsi, Finnish, French, German, 74*bf2c3715SXin Li# Greek, Hungarian, Italian, Japanese, Japanese-en (Japanese with English 75*bf2c3715SXin Li# messages), Korean, Korean-en, Lithuanian, Norwegian, Macedonian, Persian, 76*bf2c3715SXin Li# Polish, Portuguese, Romanian, Russian, Serbian, Serbian-Cyrillic, Slovak, 77*bf2c3715SXin Li# Slovene, Spanish, Swedish, Ukrainian, and Vietnamese. 78*bf2c3715SXin Li 79*bf2c3715SXin LiOUTPUT_LANGUAGE = English 80*bf2c3715SXin Li 81*bf2c3715SXin Li# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will 82*bf2c3715SXin Li# include brief member descriptions after the members that are listed in 83*bf2c3715SXin Li# the file and class documentation (similar to JavaDoc). 84*bf2c3715SXin Li# Set to NO to disable this. 85*bf2c3715SXin Li 86*bf2c3715SXin LiBRIEF_MEMBER_DESC = YES 87*bf2c3715SXin Li 88*bf2c3715SXin Li# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend 89*bf2c3715SXin Li# the brief description of a member or function before the detailed description. 90*bf2c3715SXin Li# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the 91*bf2c3715SXin Li# brief descriptions will be completely suppressed. 92*bf2c3715SXin Li 93*bf2c3715SXin LiREPEAT_BRIEF = YES 94*bf2c3715SXin Li 95*bf2c3715SXin Li# This tag implements a quasi-intelligent brief description abbreviator 96*bf2c3715SXin Li# that is used to form the text in various listings. Each string 97*bf2c3715SXin Li# in this list, if found as the leading text of the brief description, will be 98*bf2c3715SXin Li# stripped from the text and the result after processing the whole list, is 99*bf2c3715SXin Li# used as the annotated text. Otherwise, the brief description is used as-is. 100*bf2c3715SXin Li# If left blank, the following values are used ("$name" is automatically 101*bf2c3715SXin Li# replaced with the name of the entity): "The $name class" "The $name widget" 102*bf2c3715SXin Li# "The $name file" "is" "provides" "specifies" "contains" 103*bf2c3715SXin Li# "represents" "a" "an" "the" 104*bf2c3715SXin Li 105*bf2c3715SXin LiABBREVIATE_BRIEF = "The $name class" \ 106*bf2c3715SXin Li "The $name widget" \ 107*bf2c3715SXin Li "The $name file" \ 108*bf2c3715SXin Li is \ 109*bf2c3715SXin Li provides \ 110*bf2c3715SXin Li specifies \ 111*bf2c3715SXin Li contains \ 112*bf2c3715SXin Li represents \ 113*bf2c3715SXin Li a \ 114*bf2c3715SXin Li an \ 115*bf2c3715SXin Li the 116*bf2c3715SXin Li 117*bf2c3715SXin Li# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then 118*bf2c3715SXin Li# Doxygen will generate a detailed section even if there is only a brief 119*bf2c3715SXin Li# description. 120*bf2c3715SXin Li 121*bf2c3715SXin LiALWAYS_DETAILED_SEC = NO 122*bf2c3715SXin Li 123*bf2c3715SXin Li# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all 124*bf2c3715SXin Li# inherited members of a class in the documentation of that class as if those 125*bf2c3715SXin Li# members were ordinary class members. Constructors, destructors and assignment 126*bf2c3715SXin Li# operators of the base classes will not be shown. 127*bf2c3715SXin Li 128*bf2c3715SXin LiINLINE_INHERITED_MEMB = NO 129*bf2c3715SXin Li 130*bf2c3715SXin Li# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full 131*bf2c3715SXin Li# path before files name in the file list and in the header files. If set 132*bf2c3715SXin Li# to NO the shortest path that makes the file name unique will be used. 133*bf2c3715SXin Li 134*bf2c3715SXin LiFULL_PATH_NAMES = NO 135*bf2c3715SXin Li 136*bf2c3715SXin Li# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag 137*bf2c3715SXin Li# can be used to strip a user-defined part of the path. Stripping is 138*bf2c3715SXin Li# only done if one of the specified strings matches the left-hand part of 139*bf2c3715SXin Li# the path. The tag can be used to show relative paths in the file list. 140*bf2c3715SXin Li# If left blank the directory from which doxygen is run is used as the 141*bf2c3715SXin Li# path to strip. 142*bf2c3715SXin Li 143*bf2c3715SXin LiSTRIP_FROM_PATH = 144*bf2c3715SXin Li 145*bf2c3715SXin Li# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of 146*bf2c3715SXin Li# the path mentioned in the documentation of a class, which tells 147*bf2c3715SXin Li# the reader which header file to include in order to use a class. 148*bf2c3715SXin Li# If left blank only the name of the header file containing the class 149*bf2c3715SXin Li# definition is used. Otherwise one should specify the include paths that 150*bf2c3715SXin Li# are normally passed to the compiler using the -I flag. 151*bf2c3715SXin Li 152*bf2c3715SXin LiSTRIP_FROM_INC_PATH = 153*bf2c3715SXin Li 154*bf2c3715SXin Li# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter 155*bf2c3715SXin Li# (but less readable) file names. This can be useful if your file system 156*bf2c3715SXin Li# doesn't support long names like on DOS, Mac, or CD-ROM. 157*bf2c3715SXin Li 158*bf2c3715SXin LiSHORT_NAMES = NO 159*bf2c3715SXin Li 160*bf2c3715SXin Li# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen 161*bf2c3715SXin Li# will interpret the first line (until the first dot) of a JavaDoc-style 162*bf2c3715SXin Li# comment as the brief description. If set to NO, the JavaDoc 163*bf2c3715SXin Li# comments will behave just like regular Qt-style comments 164*bf2c3715SXin Li# (thus requiring an explicit @brief command for a brief description.) 165*bf2c3715SXin Li 166*bf2c3715SXin LiJAVADOC_AUTOBRIEF = NO 167*bf2c3715SXin Li 168*bf2c3715SXin Li# If the QT_AUTOBRIEF tag is set to YES then Doxygen will 169*bf2c3715SXin Li# interpret the first line (until the first dot) of a Qt-style 170*bf2c3715SXin Li# comment as the brief description. If set to NO, the comments 171*bf2c3715SXin Li# will behave just like regular Qt-style comments (thus requiring 172*bf2c3715SXin Li# an explicit \brief command for a brief description.) 173*bf2c3715SXin Li 174*bf2c3715SXin LiQT_AUTOBRIEF = NO 175*bf2c3715SXin Li 176*bf2c3715SXin Li# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen 177*bf2c3715SXin Li# treat a multi-line C++ special comment block (i.e. a block of //! or /// 178*bf2c3715SXin Li# comments) as a brief description. This used to be the default behaviour. 179*bf2c3715SXin Li# The new default is to treat a multi-line C++ comment block as a detailed 180*bf2c3715SXin Li# description. Set this tag to YES if you prefer the old behaviour instead. 181*bf2c3715SXin Li 182*bf2c3715SXin LiMULTILINE_CPP_IS_BRIEF = NO 183*bf2c3715SXin Li 184*bf2c3715SXin Li# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented 185*bf2c3715SXin Li# member inherits the documentation from any documented member that it 186*bf2c3715SXin Li# re-implements. 187*bf2c3715SXin Li 188*bf2c3715SXin LiINHERIT_DOCS = YES 189*bf2c3715SXin Li 190*bf2c3715SXin Li# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce 191*bf2c3715SXin Li# a new page for each member. If set to NO, the documentation of a member will 192*bf2c3715SXin Li# be part of the file/class/namespace that contains it. 193*bf2c3715SXin Li 194*bf2c3715SXin LiSEPARATE_MEMBER_PAGES = NO 195*bf2c3715SXin Li 196*bf2c3715SXin Li# The TAB_SIZE tag can be used to set the number of spaces in a tab. 197*bf2c3715SXin Li# Doxygen uses this value to replace tabs by spaces in code fragments. 198*bf2c3715SXin Li 199*bf2c3715SXin LiTAB_SIZE = 8 200*bf2c3715SXin Li 201*bf2c3715SXin Li# This tag can be used to specify a number of aliases that acts 202*bf2c3715SXin Li# as commands in the documentation. An alias has the form "name=value". 203*bf2c3715SXin Li# For example adding "sideeffect=\par Side Effects:\n" will allow you to 204*bf2c3715SXin Li# put the command \sideeffect (or @sideeffect) in the documentation, which 205*bf2c3715SXin Li# will result in a user-defined paragraph with heading "Side Effects:". 206*bf2c3715SXin Li# You can put \n's in the value part of an alias to insert newlines. 207*bf2c3715SXin Li 208*bf2c3715SXin LiALIASES = "only_for_vectors=This is only for vectors (either row-vectors or column-vectors), i.e. matrices which are known at compile-time to have either one row or one column." \ 209*bf2c3715SXin Li "not_reentrant=\warning This function is not re-entrant." \ 210*bf2c3715SXin Li "array_module=This is defined in the %Array module. \code #include <Eigen/Array> \endcode" \ 211*bf2c3715SXin Li "cholesky_module=This is defined in the %Cholesky module. \code #include <Eigen/Cholesky> \endcode" \ 212*bf2c3715SXin Li "eigenvalues_module=This is defined in the %Eigenvalues module. \code #include <Eigen/Eigenvalues> \endcode" \ 213*bf2c3715SXin Li "geometry_module=This is defined in the %Geometry module. \code #include <Eigen/Geometry> \endcode" \ 214*bf2c3715SXin Li "householder_module=This is defined in the %Householder module. \code #include <Eigen/Householder> \endcode" \ 215*bf2c3715SXin Li "jacobi_module=This is defined in the %Jacobi module. \code #include <Eigen/Jacobi> \endcode" \ 216*bf2c3715SXin Li "lu_module=This is defined in the %LU module. \code #include <Eigen/LU> \endcode" \ 217*bf2c3715SXin Li "qr_module=This is defined in the %QR module. \code #include <Eigen/QR> \endcode" \ 218*bf2c3715SXin Li "svd_module=This is defined in the %SVD module. \code #include <Eigen/SVD> \endcode" \ 219*bf2c3715SXin Li "specialfunctions_module=This is defined in the \b unsupported SpecialFunctions module. \code #include <Eigen/SpecialFunctions> \endcode" \ 220*bf2c3715SXin Li "label=\bug" \ 221*bf2c3715SXin Li "matrixworld=<a href='#matrixonly' style='color:green;text-decoration: none;'>*</a>" \ 222*bf2c3715SXin Li "arrayworld=<a href='#arrayonly' style='color:blue;text-decoration: none;'>*</a>" \ 223*bf2c3715SXin Li "note_about_arbitrary_choice_of_solution=If there exists more than one solution, this method will arbitrarily choose one." \ 224*bf2c3715SXin Li "note_about_using_kernel_to_study_multiple_solutions=If you need a complete analysis of the space of solutions, take the one solution obtained by this method and add to it elements of the kernel, as determined by kernel()." \ 225*bf2c3715SXin Li "note_about_checking_solutions=This method just tries to find as good a solution as possible. If you want to check whether a solution exists or if it is accurate, just call this function to get a result and then compute the error of this result, or use MatrixBase::isApprox() directly, for instance like this: \code bool a_solution_exists = (A*result).isApprox(b, precision); \endcode This method avoids dividing by zero, so that the non-existence of a solution doesn't by itself mean that you'll get \c inf or \c nan values." \ 226*bf2c3715SXin Li "note_try_to_help_rvo=This function returns the result by value. In order to make that efficient, it is implemented as just a return statement using a special constructor, hopefully allowing the compiler to perform a RVO (return value optimization)." \ 227*bf2c3715SXin Li "nonstableyet=\warning This is not considered to be part of the stable public API yet. Changes may happen in future releases. See \ref Experimental \"Experimental parts of Eigen\"" \ 228*bf2c3715SXin Li "implsparsesolverconcept=This class follows the \link TutorialSparseSolverConcept sparse solver concept \endlink." \ 229*bf2c3715SXin Li "blank= " \ 230*bf2c3715SXin Li "cpp11=<span class='cpp11'>[c++11]</span>" \ 231*bf2c3715SXin Li "cpp14=<span class='cpp14'>[c++14]</span>" \ 232*bf2c3715SXin Li "cpp17=<span class='cpp17'>[c++17]</span>" \ 233*bf2c3715SXin Li "newin{1}=<span class='newin3x'>New in %Eigen \1.</span>" 234*bf2c3715SXin Li 235*bf2c3715SXin Li 236*bf2c3715SXin LiALIASES += "eigenAutoToc= " 237*bf2c3715SXin LiALIASES += "eigenManualPage=\defgroup" 238*bf2c3715SXin Li 239*bf2c3715SXin Li# This tag can be used to specify a number of word-keyword mappings (TCL only). 240*bf2c3715SXin Li# A mapping has the form "name=value". For example adding 241*bf2c3715SXin Li# "class=itcl::class" will allow you to use the command class in the 242*bf2c3715SXin Li# itcl::class meaning. 243*bf2c3715SXin Li 244*bf2c3715SXin LiTCL_SUBST = 245*bf2c3715SXin Li 246*bf2c3715SXin Li# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C 247*bf2c3715SXin Li# sources only. Doxygen will then generate output that is more tailored for C. 248*bf2c3715SXin Li# For instance, some of the names that are used will be different. The list 249*bf2c3715SXin Li# of all members will be omitted, etc. 250*bf2c3715SXin Li 251*bf2c3715SXin LiOPTIMIZE_OUTPUT_FOR_C = NO 252*bf2c3715SXin Li 253*bf2c3715SXin Li# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java 254*bf2c3715SXin Li# sources only. Doxygen will then generate output that is more tailored for 255*bf2c3715SXin Li# Java. For instance, namespaces will be presented as packages, qualified 256*bf2c3715SXin Li# scopes will look different, etc. 257*bf2c3715SXin Li 258*bf2c3715SXin LiOPTIMIZE_OUTPUT_JAVA = NO 259*bf2c3715SXin Li 260*bf2c3715SXin Li# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran 261*bf2c3715SXin Li# sources only. Doxygen will then generate output that is more tailored for 262*bf2c3715SXin Li# Fortran. 263*bf2c3715SXin Li 264*bf2c3715SXin LiOPTIMIZE_FOR_FORTRAN = NO 265*bf2c3715SXin Li 266*bf2c3715SXin Li# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL 267*bf2c3715SXin Li# sources. Doxygen will then generate output that is tailored for 268*bf2c3715SXin Li# VHDL. 269*bf2c3715SXin Li 270*bf2c3715SXin LiOPTIMIZE_OUTPUT_VHDL = NO 271*bf2c3715SXin Li 272*bf2c3715SXin Li# Doxygen selects the parser to use depending on the extension of the files it 273*bf2c3715SXin Li# parses. With this tag you can assign which parser to use for a given extension. 274*bf2c3715SXin Li# Doxygen has a built-in mapping, but you can override or extend it using this 275*bf2c3715SXin Li# tag. The format is ext=language, where ext is a file extension, and language 276*bf2c3715SXin Li# is one of the parsers supported by doxygen: IDL, Java, Javascript, CSharp, C, 277*bf2c3715SXin Li# C++, D, PHP, Objective-C, Python, Fortran, VHDL, C, C++. For instance to make 278*bf2c3715SXin Li# doxygen treat .inc files as Fortran files (default is PHP), and .f files as C 279*bf2c3715SXin Li# (default is Fortran), use: inc=Fortran f=C. Note that for custom extensions 280*bf2c3715SXin Li# you also need to set FILE_PATTERNS otherwise the files are not read by doxygen. 281*bf2c3715SXin Li 282*bf2c3715SXin LiEXTENSION_MAPPING = .h=C++ no_extension=C++ 283*bf2c3715SXin Li 284*bf2c3715SXin Li# If MARKDOWN_SUPPORT is enabled (the default) then doxygen pre-processes all 285*bf2c3715SXin Li# comments according to the Markdown format, which allows for more readable 286*bf2c3715SXin Li# documentation. See http://daringfireball.net/projects/markdown/ for details. 287*bf2c3715SXin Li# The output of markdown processing is further processed by doxygen, so you 288*bf2c3715SXin Li# can mix doxygen, HTML, and XML commands with Markdown formatting. 289*bf2c3715SXin Li# Disable only in case of backward compatibilities issues. 290*bf2c3715SXin Li 291*bf2c3715SXin LiMARKDOWN_SUPPORT = YES 292*bf2c3715SXin Li 293*bf2c3715SXin Li# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want 294*bf2c3715SXin Li# to include (a tag file for) the STL sources as input, then you should 295*bf2c3715SXin Li# set this tag to YES in order to let doxygen match functions declarations and 296*bf2c3715SXin Li# definitions whose arguments contain STL classes (e.g. func(std::string); v.s. 297*bf2c3715SXin Li# func(std::string) {}). This also makes the inheritance and collaboration 298*bf2c3715SXin Li# diagrams that involve STL classes more complete and accurate. 299*bf2c3715SXin Li 300*bf2c3715SXin LiBUILTIN_STL_SUPPORT = NO 301*bf2c3715SXin Li 302*bf2c3715SXin Li# If you use Microsoft's C++/CLI language, you should set this option to YES to 303*bf2c3715SXin Li# enable parsing support. 304*bf2c3715SXin Li 305*bf2c3715SXin LiCPP_CLI_SUPPORT = NO 306*bf2c3715SXin Li 307*bf2c3715SXin Li# Set the SIP_SUPPORT tag to YES if your project consists of sip sources only. 308*bf2c3715SXin Li# Doxygen will parse them like normal C++ but will assume all classes use public 309*bf2c3715SXin Li# instead of private inheritance when no explicit protection keyword is present. 310*bf2c3715SXin Li 311*bf2c3715SXin LiSIP_SUPPORT = NO 312*bf2c3715SXin Li 313*bf2c3715SXin Li# For Microsoft's IDL there are propget and propput attributes to indicate getter 314*bf2c3715SXin Li# and setter methods for a property. Setting this option to YES (the default) 315*bf2c3715SXin Li# will make doxygen replace the get and set methods by a property in the 316*bf2c3715SXin Li# documentation. This will only work if the methods are indeed getting or 317*bf2c3715SXin Li# setting a simple type. If this is not the case, or you want to show the 318*bf2c3715SXin Li# methods anyway, you should set this option to NO. 319*bf2c3715SXin Li 320*bf2c3715SXin LiIDL_PROPERTY_SUPPORT = YES 321*bf2c3715SXin Li 322*bf2c3715SXin Li# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC 323*bf2c3715SXin Li# tag is set to YES, then doxygen will reuse the documentation of the first 324*bf2c3715SXin Li# member in the group (if any) for the other members of the group. By default 325*bf2c3715SXin Li# all members of a group must be documented explicitly. 326*bf2c3715SXin Li 327*bf2c3715SXin LiDISTRIBUTE_GROUP_DOC = YES 328*bf2c3715SXin Li 329*bf2c3715SXin Li# Set the SUBGROUPING tag to YES (the default) to allow class member groups of 330*bf2c3715SXin Li# the same type (for instance a group of public functions) to be put as a 331*bf2c3715SXin Li# subgroup of that type (e.g. under the Public Functions section). Set it to 332*bf2c3715SXin Li# NO to prevent subgrouping. Alternatively, this can be done per class using 333*bf2c3715SXin Li# the \nosubgrouping command. 334*bf2c3715SXin Li 335*bf2c3715SXin LiSUBGROUPING = YES 336*bf2c3715SXin Li 337*bf2c3715SXin Li# When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and 338*bf2c3715SXin Li# unions are shown inside the group in which they are included (e.g. using 339*bf2c3715SXin Li# @ingroup) instead of on a separate page (for HTML and Man pages) or 340*bf2c3715SXin Li# section (for LaTeX and RTF). 341*bf2c3715SXin Li 342*bf2c3715SXin LiINLINE_GROUPED_CLASSES = NO 343*bf2c3715SXin Li 344*bf2c3715SXin Li# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and 345*bf2c3715SXin Li# unions with only public data fields will be shown inline in the documentation 346*bf2c3715SXin Li# of the scope in which they are defined (i.e. file, namespace, or group 347*bf2c3715SXin Li# documentation), provided this scope is documented. If set to NO (the default), 348*bf2c3715SXin Li# structs, classes, and unions are shown on a separate page (for HTML and Man 349*bf2c3715SXin Li# pages) or section (for LaTeX and RTF). 350*bf2c3715SXin Li 351*bf2c3715SXin LiINLINE_SIMPLE_STRUCTS = NO 352*bf2c3715SXin Li 353*bf2c3715SXin Li# When TYPEDEF_HIDES_STRUCT is enabled, a typedef of a struct, union, or enum 354*bf2c3715SXin Li# is documented as struct, union, or enum with the name of the typedef. So 355*bf2c3715SXin Li# typedef struct TypeS {} TypeT, will appear in the documentation as a struct 356*bf2c3715SXin Li# with name TypeT. When disabled the typedef will appear as a member of a file, 357*bf2c3715SXin Li# namespace, or class. And the struct will be named TypeS. This can typically 358*bf2c3715SXin Li# be useful for C code in case the coding convention dictates that all compound 359*bf2c3715SXin Li# types are typedef'ed and only the typedef is referenced, never the tag name. 360*bf2c3715SXin Li 361*bf2c3715SXin LiTYPEDEF_HIDES_STRUCT = NO 362*bf2c3715SXin Li 363*bf2c3715SXin Li# The SYMBOL_CACHE_SIZE determines the size of the internal cache use to 364*bf2c3715SXin Li# determine which symbols to keep in memory and which to flush to disk. 365*bf2c3715SXin Li# When the cache is full, less often used symbols will be written to disk. 366*bf2c3715SXin Li# For small to medium size projects (<1000 input files) the default value is 367*bf2c3715SXin Li# probably good enough. For larger projects a too small cache size can cause 368*bf2c3715SXin Li# doxygen to be busy swapping symbols to and from disk most of the time 369*bf2c3715SXin Li# causing a significant performance penalty. 370*bf2c3715SXin Li# If the system has enough physical memory increasing the cache will improve the 371*bf2c3715SXin Li# performance by keeping more symbols in memory. Note that the value works on 372*bf2c3715SXin Li# a logarithmic scale so increasing the size by one will roughly double the 373*bf2c3715SXin Li# memory usage. The cache size is given by this formula: 374*bf2c3715SXin Li# 2^(16+SYMBOL_CACHE_SIZE). The valid range is 0..9, the default is 0, 375*bf2c3715SXin Li# corresponding to a cache size of 2^16 = 65536 symbols. 376*bf2c3715SXin Li 377*bf2c3715SXin Li# SYMBOL_CACHE_SIZE = 0 378*bf2c3715SXin Li 379*bf2c3715SXin Li# Similar to the SYMBOL_CACHE_SIZE the size of the symbol lookup cache can be 380*bf2c3715SXin Li# set using LOOKUP_CACHE_SIZE. This cache is used to resolve symbols given 381*bf2c3715SXin Li# their name and scope. Since this can be an expensive process and often the 382*bf2c3715SXin Li# same symbol appear multiple times in the code, doxygen keeps a cache of 383*bf2c3715SXin Li# pre-resolved symbols. If the cache is too small doxygen will become slower. 384*bf2c3715SXin Li# If the cache is too large, memory is wasted. The cache size is given by this 385*bf2c3715SXin Li# formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range is 0..9, the default is 0, 386*bf2c3715SXin Li# corresponding to a cache size of 2^16 = 65536 symbols. 387*bf2c3715SXin Li 388*bf2c3715SXin LiLOOKUP_CACHE_SIZE = 0 389*bf2c3715SXin Li 390*bf2c3715SXin Li#--------------------------------------------------------------------------- 391*bf2c3715SXin Li# Build related configuration options 392*bf2c3715SXin Li#--------------------------------------------------------------------------- 393*bf2c3715SXin Li 394*bf2c3715SXin Li# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in 395*bf2c3715SXin Li# documentation are documented, even if no documentation was available. 396*bf2c3715SXin Li# Private class members and static file members will be hidden unless 397*bf2c3715SXin Li# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES 398*bf2c3715SXin Li 399*bf2c3715SXin LiEXTRACT_ALL = NO 400*bf2c3715SXin Li 401*bf2c3715SXin Li# If the EXTRACT_PRIVATE tag is set to YES all private members of a class 402*bf2c3715SXin Li# will be included in the documentation. 403*bf2c3715SXin Li 404*bf2c3715SXin LiEXTRACT_PRIVATE = NO 405*bf2c3715SXin Li 406*bf2c3715SXin Li# If the EXTRACT_PACKAGE tag is set to YES all members with package or internal scope will be included in the documentation. 407*bf2c3715SXin Li 408*bf2c3715SXin LiEXTRACT_PACKAGE = NO 409*bf2c3715SXin Li 410*bf2c3715SXin Li# If the EXTRACT_STATIC tag is set to YES all static members of a file 411*bf2c3715SXin Li# will be included in the documentation. 412*bf2c3715SXin Li 413*bf2c3715SXin LiEXTRACT_STATIC = YES 414*bf2c3715SXin Li 415*bf2c3715SXin Li# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) 416*bf2c3715SXin Li# defined locally in source files will be included in the documentation. 417*bf2c3715SXin Li# If set to NO only classes defined in header files are included. 418*bf2c3715SXin Li 419*bf2c3715SXin LiEXTRACT_LOCAL_CLASSES = NO 420*bf2c3715SXin Li 421*bf2c3715SXin Li# This flag is only useful for Objective-C code. When set to YES local 422*bf2c3715SXin Li# methods, which are defined in the implementation section but not in 423*bf2c3715SXin Li# the interface are included in the documentation. 424*bf2c3715SXin Li# If set to NO (the default) only methods in the interface are included. 425*bf2c3715SXin Li 426*bf2c3715SXin LiEXTRACT_LOCAL_METHODS = NO 427*bf2c3715SXin Li 428*bf2c3715SXin Li# If this flag is set to YES, the members of anonymous namespaces will be 429*bf2c3715SXin Li# extracted and appear in the documentation as a namespace called 430*bf2c3715SXin Li# 'anonymous_namespace{file}', where file will be replaced with the base 431*bf2c3715SXin Li# name of the file that contains the anonymous namespace. By default 432*bf2c3715SXin Li# anonymous namespaces are hidden. 433*bf2c3715SXin Li 434*bf2c3715SXin LiEXTRACT_ANON_NSPACES = NO 435*bf2c3715SXin Li 436*bf2c3715SXin Li# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all 437*bf2c3715SXin Li# undocumented members of documented classes, files or namespaces. 438*bf2c3715SXin Li# If set to NO (the default) these members will be included in the 439*bf2c3715SXin Li# various overviews, but no documentation section is generated. 440*bf2c3715SXin Li# This option has no effect if EXTRACT_ALL is enabled. 441*bf2c3715SXin Li 442*bf2c3715SXin LiHIDE_UNDOC_MEMBERS = YES 443*bf2c3715SXin Li 444*bf2c3715SXin Li# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all 445*bf2c3715SXin Li# undocumented classes that are normally visible in the class hierarchy. 446*bf2c3715SXin Li# If set to NO (the default) these classes will be included in the various 447*bf2c3715SXin Li# overviews. This option has no effect if EXTRACT_ALL is enabled. 448*bf2c3715SXin Li 449*bf2c3715SXin LiHIDE_UNDOC_CLASSES = YES 450*bf2c3715SXin Li 451*bf2c3715SXin Li# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all 452*bf2c3715SXin Li# friend (class|struct|union) declarations. 453*bf2c3715SXin Li# If set to NO (the default) these declarations will be included in the 454*bf2c3715SXin Li# documentation. 455*bf2c3715SXin Li 456*bf2c3715SXin LiHIDE_FRIEND_COMPOUNDS = YES 457*bf2c3715SXin Li 458*bf2c3715SXin Li# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any 459*bf2c3715SXin Li# documentation blocks found inside the body of a function. 460*bf2c3715SXin Li# If set to NO (the default) these blocks will be appended to the 461*bf2c3715SXin Li# function's detailed documentation block. 462*bf2c3715SXin Li 463*bf2c3715SXin LiHIDE_IN_BODY_DOCS = NO 464*bf2c3715SXin Li 465*bf2c3715SXin Li# The INTERNAL_DOCS tag determines if documentation 466*bf2c3715SXin Li# that is typed after a \internal command is included. If the tag is set 467*bf2c3715SXin Li# to NO (the default) then the documentation will be excluded. 468*bf2c3715SXin Li# Set it to YES to include the internal documentation. 469*bf2c3715SXin Li 470*bf2c3715SXin LiINTERNAL_DOCS = ${EIGEN_DOXY_INTERNAL} 471*bf2c3715SXin Li 472*bf2c3715SXin Li# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate 473*bf2c3715SXin Li# file names in lower-case letters. If set to YES upper-case letters are also 474*bf2c3715SXin Li# allowed. This is useful if you have classes or files whose names only differ 475*bf2c3715SXin Li# in case and if your file system supports case sensitive file names. Windows 476*bf2c3715SXin Li# and Mac users are advised to set this option to NO. 477*bf2c3715SXin Li 478*bf2c3715SXin LiCASE_SENSE_NAMES = YES 479*bf2c3715SXin Li 480*bf2c3715SXin Li# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen 481*bf2c3715SXin Li# will show members with their full class and namespace scopes in the 482*bf2c3715SXin Li# documentation. If set to YES the scope will be hidden. 483*bf2c3715SXin Li 484*bf2c3715SXin LiHIDE_SCOPE_NAMES = NO 485*bf2c3715SXin Li 486*bf2c3715SXin Li# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen 487*bf2c3715SXin Li# will put a list of the files that are included by a file in the documentation 488*bf2c3715SXin Li# of that file. 489*bf2c3715SXin Li 490*bf2c3715SXin LiSHOW_INCLUDE_FILES = ${EIGEN_DOXY_INTERNAL} 491*bf2c3715SXin Li 492*bf2c3715SXin Li# If the FORCE_LOCAL_INCLUDES tag is set to YES then Doxygen 493*bf2c3715SXin Li# will list include files with double quotes in the documentation 494*bf2c3715SXin Li# rather than with sharp brackets. 495*bf2c3715SXin Li 496*bf2c3715SXin LiFORCE_LOCAL_INCLUDES = NO 497*bf2c3715SXin Li 498*bf2c3715SXin Li# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] 499*bf2c3715SXin Li# is inserted in the documentation for inline members. 500*bf2c3715SXin Li 501*bf2c3715SXin LiINLINE_INFO = YES 502*bf2c3715SXin Li 503*bf2c3715SXin Li# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen 504*bf2c3715SXin Li# will sort the (detailed) documentation of file and class members 505*bf2c3715SXin Li# alphabetically by member name. If set to NO the members will appear in 506*bf2c3715SXin Li# declaration order. 507*bf2c3715SXin Li 508*bf2c3715SXin LiSORT_MEMBER_DOCS = YES 509*bf2c3715SXin Li 510*bf2c3715SXin Li# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the 511*bf2c3715SXin Li# brief documentation of file, namespace and class members alphabetically 512*bf2c3715SXin Li# by member name. If set to NO (the default) the members will appear in 513*bf2c3715SXin Li# declaration order. 514*bf2c3715SXin Li 515*bf2c3715SXin LiSORT_BRIEF_DOCS = YES 516*bf2c3715SXin Li 517*bf2c3715SXin Li# If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen 518*bf2c3715SXin Li# will sort the (brief and detailed) documentation of class members so that 519*bf2c3715SXin Li# constructors and destructors are listed first. If set to NO (the default) 520*bf2c3715SXin Li# the constructors will appear in the respective orders defined by 521*bf2c3715SXin Li# SORT_MEMBER_DOCS and SORT_BRIEF_DOCS. 522*bf2c3715SXin Li# This tag will be ignored for brief docs if SORT_BRIEF_DOCS is set to NO 523*bf2c3715SXin Li# and ignored for detailed docs if SORT_MEMBER_DOCS is set to NO. 524*bf2c3715SXin Li 525*bf2c3715SXin LiSORT_MEMBERS_CTORS_1ST = NO 526*bf2c3715SXin Li 527*bf2c3715SXin Li# If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the 528*bf2c3715SXin Li# hierarchy of group names into alphabetical order. If set to NO (the default) 529*bf2c3715SXin Li# the group names will appear in their defined order. 530*bf2c3715SXin Li 531*bf2c3715SXin LiSORT_GROUP_NAMES = NO 532*bf2c3715SXin Li 533*bf2c3715SXin Li# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be 534*bf2c3715SXin Li# sorted by fully-qualified names, including namespaces. If set to 535*bf2c3715SXin Li# NO (the default), the class list will be sorted only by class name, 536*bf2c3715SXin Li# not including the namespace part. 537*bf2c3715SXin Li# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. 538*bf2c3715SXin Li# Note: This option applies only to the class list, not to the 539*bf2c3715SXin Li# alphabetical list. 540*bf2c3715SXin Li 541*bf2c3715SXin LiSORT_BY_SCOPE_NAME = NO 542*bf2c3715SXin Li 543*bf2c3715SXin Li# If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to 544*bf2c3715SXin Li# do proper type resolution of all parameters of a function it will reject a 545*bf2c3715SXin Li# match between the prototype and the implementation of a member function even 546*bf2c3715SXin Li# if there is only one candidate or it is obvious which candidate to choose 547*bf2c3715SXin Li# by doing a simple string match. By disabling STRICT_PROTO_MATCHING doxygen 548*bf2c3715SXin Li# will still accept a match between prototype and implementation in such cases. 549*bf2c3715SXin Li 550*bf2c3715SXin LiSTRICT_PROTO_MATCHING = NO 551*bf2c3715SXin Li 552*bf2c3715SXin Li# The GENERATE_TODOLIST tag can be used to enable (YES) or 553*bf2c3715SXin Li# disable (NO) the todo list. This list is created by putting \todo 554*bf2c3715SXin Li# commands in the documentation. 555*bf2c3715SXin Li 556*bf2c3715SXin LiGENERATE_TODOLIST = ${EIGEN_DOXY_INTERNAL} 557*bf2c3715SXin Li 558*bf2c3715SXin Li# The GENERATE_TESTLIST tag can be used to enable (YES) or 559*bf2c3715SXin Li# disable (NO) the test list. This list is created by putting \test 560*bf2c3715SXin Li# commands in the documentation. 561*bf2c3715SXin Li 562*bf2c3715SXin LiGENERATE_TESTLIST = NO 563*bf2c3715SXin Li 564*bf2c3715SXin Li# The GENERATE_BUGLIST tag can be used to enable (YES) or 565*bf2c3715SXin Li# disable (NO) the bug list. This list is created by putting \bug 566*bf2c3715SXin Li# commands in the documentation. 567*bf2c3715SXin Li 568*bf2c3715SXin LiGENERATE_BUGLIST = ${EIGEN_DOXY_INTERNAL} 569*bf2c3715SXin Li 570*bf2c3715SXin Li# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or 571*bf2c3715SXin Li# disable (NO) the deprecated list. This list is created by putting 572*bf2c3715SXin Li# \deprecated commands in the documentation. 573*bf2c3715SXin Li 574*bf2c3715SXin LiGENERATE_DEPRECATEDLIST= YES 575*bf2c3715SXin Li 576*bf2c3715SXin Li# The ENABLED_SECTIONS tag can be used to enable conditional 577*bf2c3715SXin Li# documentation sections, marked by \if sectionname ... \endif. 578*bf2c3715SXin Li 579*bf2c3715SXin LiENABLED_SECTIONS = 580*bf2c3715SXin Li 581*bf2c3715SXin Li# The MAX_INITIALIZER_LINES tag determines the maximum number of lines 582*bf2c3715SXin Li# the initial value of a variable or macro consists of for it to appear in 583*bf2c3715SXin Li# the documentation. If the initializer consists of more lines than specified 584*bf2c3715SXin Li# here it will be hidden. Use a value of 0 to hide initializers completely. 585*bf2c3715SXin Li# The appearance of the initializer of individual variables and macros in the 586*bf2c3715SXin Li# documentation can be controlled using \showinitializer or \hideinitializer 587*bf2c3715SXin Li# command in the documentation regardless of this setting. 588*bf2c3715SXin Li 589*bf2c3715SXin LiMAX_INITIALIZER_LINES = 0 590*bf2c3715SXin Li 591*bf2c3715SXin Li# Set the SHOW_USED_FILES tag to NO to disable the list of files generated 592*bf2c3715SXin Li# at the bottom of the documentation of classes and structs. If set to YES the 593*bf2c3715SXin Li# list will mention the files that were used to generate the documentation. 594*bf2c3715SXin Li 595*bf2c3715SXin LiSHOW_USED_FILES = YES 596*bf2c3715SXin Li 597*bf2c3715SXin Li# Set the SHOW_FILES tag to NO to disable the generation of the Files page. 598*bf2c3715SXin Li# This will remove the Files entry from the Quick Index and from the 599*bf2c3715SXin Li# Folder Tree View (if specified). The default is YES. 600*bf2c3715SXin Li 601*bf2c3715SXin LiSHOW_FILES = YES 602*bf2c3715SXin Li 603*bf2c3715SXin Li# Set the SHOW_NAMESPACES tag to NO to disable the generation of the 604*bf2c3715SXin Li# Namespaces page. 605*bf2c3715SXin Li# This will remove the Namespaces entry from the Quick Index 606*bf2c3715SXin Li# and from the Folder Tree View (if specified). The default is YES. 607*bf2c3715SXin Li 608*bf2c3715SXin LiSHOW_NAMESPACES = NO 609*bf2c3715SXin Li 610*bf2c3715SXin Li# The FILE_VERSION_FILTER tag can be used to specify a program or script that 611*bf2c3715SXin Li# doxygen should invoke to get the current version for each file (typically from 612*bf2c3715SXin Li# the version control system). Doxygen will invoke the program by executing (via 613*bf2c3715SXin Li# popen()) the command <command> <input-file>, where <command> is the value of 614*bf2c3715SXin Li# the FILE_VERSION_FILTER tag, and <input-file> is the name of an input file 615*bf2c3715SXin Li# provided by doxygen. Whatever the program writes to standard output 616*bf2c3715SXin Li# is used as the file version. See the manual for examples. 617*bf2c3715SXin Li 618*bf2c3715SXin LiFILE_VERSION_FILTER = 619*bf2c3715SXin Li 620*bf2c3715SXin Li# The LAYOUT_FILE tag can be used to specify a layout file which will be parsed 621*bf2c3715SXin Li# by doxygen. The layout file controls the global structure of the generated 622*bf2c3715SXin Li# output files in an output format independent way. To create the layout file 623*bf2c3715SXin Li# that represents doxygen's defaults, run doxygen with the -l option. 624*bf2c3715SXin Li# You can optionally specify a file name after the option, if omitted 625*bf2c3715SXin Li# DoxygenLayout.xml will be used as the name of the layout file. 626*bf2c3715SXin Li 627*bf2c3715SXin LiLAYOUT_FILE = "${Eigen_BINARY_DIR}/doc${EIGEN_DOXY_OUTPUT_DIRECTORY_SUFFIX}/eigendoxy_layout.xml" 628*bf2c3715SXin Li 629*bf2c3715SXin Li# The CITE_BIB_FILES tag can be used to specify one or more bib files 630*bf2c3715SXin Li# containing the references data. This must be a list of .bib files. The 631*bf2c3715SXin Li# .bib extension is automatically appended if omitted. Using this command 632*bf2c3715SXin Li# requires the bibtex tool to be installed. See also 633*bf2c3715SXin Li# http://en.wikipedia.org/wiki/BibTeX for more info. For LaTeX the style 634*bf2c3715SXin Li# of the bibliography can be controlled using LATEX_BIB_STYLE. To use this 635*bf2c3715SXin Li# feature you need bibtex and perl available in the search path. 636*bf2c3715SXin Li 637*bf2c3715SXin LiCITE_BIB_FILES = 638*bf2c3715SXin Li 639*bf2c3715SXin Li#--------------------------------------------------------------------------- 640*bf2c3715SXin Li# configuration options related to warning and progress messages 641*bf2c3715SXin Li#--------------------------------------------------------------------------- 642*bf2c3715SXin Li 643*bf2c3715SXin Li# The QUIET tag can be used to turn on/off the messages that are generated 644*bf2c3715SXin Li# by doxygen. Possible values are YES and NO. If left blank NO is used. 645*bf2c3715SXin Li 646*bf2c3715SXin LiQUIET = NO 647*bf2c3715SXin Li 648*bf2c3715SXin Li# The WARNINGS tag can be used to turn on/off the warning messages that are 649*bf2c3715SXin Li# generated by doxygen. Possible values are YES and NO. If left blank 650*bf2c3715SXin Li# NO is used. 651*bf2c3715SXin Li 652*bf2c3715SXin LiWARNINGS = YES 653*bf2c3715SXin Li 654*bf2c3715SXin Li# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings 655*bf2c3715SXin Li# for undocumented members. If EXTRACT_ALL is set to YES then this flag will 656*bf2c3715SXin Li# automatically be disabled. 657*bf2c3715SXin Li 658*bf2c3715SXin LiWARN_IF_UNDOCUMENTED = NO 659*bf2c3715SXin Li 660*bf2c3715SXin Li# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for 661*bf2c3715SXin Li# potential errors in the documentation, such as not documenting some 662*bf2c3715SXin Li# parameters in a documented function, or documenting parameters that 663*bf2c3715SXin Li# don't exist or using markup commands wrongly. 664*bf2c3715SXin Li 665*bf2c3715SXin LiWARN_IF_DOC_ERROR = YES 666*bf2c3715SXin Li 667*bf2c3715SXin Li# The WARN_NO_PARAMDOC option can be enabled to get warnings for 668*bf2c3715SXin Li# functions that are documented, but have no documentation for their parameters 669*bf2c3715SXin Li# or return value. If set to NO (the default) doxygen will only warn about 670*bf2c3715SXin Li# wrong or incomplete parameter documentation, but not about the absence of 671*bf2c3715SXin Li# documentation. 672*bf2c3715SXin Li 673*bf2c3715SXin LiWARN_NO_PARAMDOC = NO 674*bf2c3715SXin Li 675*bf2c3715SXin Li# The WARN_FORMAT tag determines the format of the warning messages that 676*bf2c3715SXin Li# doxygen can produce. The string should contain the $file, $line, and $text 677*bf2c3715SXin Li# tags, which will be replaced by the file and line number from which the 678*bf2c3715SXin Li# warning originated and the warning text. Optionally the format may contain 679*bf2c3715SXin Li# $version, which will be replaced by the version of the file (if it could 680*bf2c3715SXin Li# be obtained via FILE_VERSION_FILTER) 681*bf2c3715SXin Li 682*bf2c3715SXin LiWARN_FORMAT = "$file:$line: $text" 683*bf2c3715SXin Li 684*bf2c3715SXin Li# The WARN_LOGFILE tag can be used to specify a file to which warning 685*bf2c3715SXin Li# and error messages should be written. If left blank the output is written 686*bf2c3715SXin Li# to stderr. 687*bf2c3715SXin Li 688*bf2c3715SXin LiWARN_LOGFILE = 689*bf2c3715SXin Li 690*bf2c3715SXin Li#--------------------------------------------------------------------------- 691*bf2c3715SXin Li# configuration options related to the input files 692*bf2c3715SXin Li#--------------------------------------------------------------------------- 693*bf2c3715SXin Li 694*bf2c3715SXin Li# The INPUT tag can be used to specify the files and/or directories that contain 695*bf2c3715SXin Li# documented source files. You may enter file names like "myfile.cpp" or 696*bf2c3715SXin Li# directories like "/usr/src/myproject". Separate the files or directories 697*bf2c3715SXin Li# with spaces. 698*bf2c3715SXin Li 699*bf2c3715SXin LiINPUT = ${EIGEN_DOXY_INPUT} 700*bf2c3715SXin Li 701*bf2c3715SXin Li# This tag can be used to specify the character encoding of the source files 702*bf2c3715SXin Li# that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is 703*bf2c3715SXin Li# also the default input encoding. Doxygen uses libiconv (or the iconv built 704*bf2c3715SXin Li# into libc) for the transcoding. See http://www.gnu.org/software/libiconv for 705*bf2c3715SXin Li# the list of possible encodings. 706*bf2c3715SXin Li 707*bf2c3715SXin LiINPUT_ENCODING = UTF-8 708*bf2c3715SXin Li 709*bf2c3715SXin Li# If the value of the INPUT tag contains directories, you can use the 710*bf2c3715SXin Li# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 711*bf2c3715SXin Li# and *.h) to filter out the source-files in the directories. If left 712*bf2c3715SXin Li# blank the following patterns are tested: 713*bf2c3715SXin Li# *.c *.cc *.cxx *.cpp *.c++ *.d *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh 714*bf2c3715SXin Li# *.hxx *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.dox *.py 715*bf2c3715SXin Li# *.f90 *.f *.for *.vhd *.vhdl 716*bf2c3715SXin Li 717*bf2c3715SXin LiFILE_PATTERNS = * 718*bf2c3715SXin Li 719*bf2c3715SXin Li# The RECURSIVE tag can be used to turn specify whether or not subdirectories 720*bf2c3715SXin Li# should be searched for input files as well. Possible values are YES and NO. 721*bf2c3715SXin Li# If left blank NO is used. 722*bf2c3715SXin Li 723*bf2c3715SXin LiRECURSIVE = YES 724*bf2c3715SXin Li 725*bf2c3715SXin Li# The EXCLUDE tag can be used to specify files and/or directories that should be 726*bf2c3715SXin Li# excluded from the INPUT source files. This way you can easily exclude a 727*bf2c3715SXin Li# subdirectory from a directory tree whose root is specified with the INPUT tag. 728*bf2c3715SXin Li# Note that relative paths are relative to the directory from which doxygen is 729*bf2c3715SXin Li# run. 730*bf2c3715SXin Li 731*bf2c3715SXin LiEXCLUDE = "${Eigen_SOURCE_DIR}/Eigen/src/Core/products" \ 732*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/Eigen/Eigen2Support" \ 733*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/Eigen/src/Eigen2Support" \ 734*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/doc/examples" \ 735*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/doc/special_examples" \ 736*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/doc/snippets" \ 737*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/unsupported/doc/examples" \ 738*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/unsupported/doc/snippets" 739*bf2c3715SXin Li 740*bf2c3715SXin Li# Forward declarations of class templates cause the title of the main page for 741*bf2c3715SXin Li# the class template to not contain the template signature. This only happens 742*bf2c3715SXin Li# when the \class command is used to document the class. Possibly caused 743*bf2c3715SXin Li# by https://github.com/doxygen/doxygen/issues/7698. Confirmed fixed by 744*bf2c3715SXin Li# doxygen release 1.8.19. 745*bf2c3715SXin Li 746*bf2c3715SXin LiEXCLUDE += "${Eigen_SOURCE_DIR}/Eigen/src/Core/util/ForwardDeclarations.h" 747*bf2c3715SXin Li 748*bf2c3715SXin Li# The EXCLUDE_SYMLINKS tag can be used to select whether or not files or 749*bf2c3715SXin Li# directories that are symbolic links (a Unix file system feature) are excluded 750*bf2c3715SXin Li# from the input. 751*bf2c3715SXin Li 752*bf2c3715SXin LiEXCLUDE_SYMLINKS = NO 753*bf2c3715SXin Li 754*bf2c3715SXin Li# If the value of the INPUT tag contains directories, you can use the 755*bf2c3715SXin Li# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude 756*bf2c3715SXin Li# certain files from those directories. Note that the wildcards are matched 757*bf2c3715SXin Li# against the file with absolute path, so to exclude all test directories 758*bf2c3715SXin Li# for example use the pattern */test/* 759*bf2c3715SXin Li 760*bf2c3715SXin LiEXCLUDE_PATTERNS = CMake* \ 761*bf2c3715SXin Li *.txt \ 762*bf2c3715SXin Li *.sh \ 763*bf2c3715SXin Li *.orig \ 764*bf2c3715SXin Li *.diff \ 765*bf2c3715SXin Li diff \ 766*bf2c3715SXin Li *~ \ 767*bf2c3715SXin Li *. \ 768*bf2c3715SXin Li *.sln \ 769*bf2c3715SXin Li *.sdf \ 770*bf2c3715SXin Li *.tmp \ 771*bf2c3715SXin Li *.vcxproj \ 772*bf2c3715SXin Li *.filters \ 773*bf2c3715SXin Li *.user \ 774*bf2c3715SXin Li *.suo 775*bf2c3715SXin Li 776*bf2c3715SXin Li# The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names 777*bf2c3715SXin Li# (namespaces, classes, functions, etc.) that should be excluded from the 778*bf2c3715SXin Li# output. The symbol name can be a fully qualified name, a word, or if the 779*bf2c3715SXin Li# wildcard * is used, a substring. Examples: ANamespace, AClass, 780*bf2c3715SXin Li# AClass::ANamespace, ANamespace::*Test 781*bf2c3715SXin Li 782*bf2c3715SXin LiEXCLUDE_SYMBOLS = internal::* \ 783*bf2c3715SXin Li Flagged* \ 784*bf2c3715SXin Li *InnerIterator* \ 785*bf2c3715SXin Li DenseStorage<* \ 786*bf2c3715SXin Li 787*bf2c3715SXin Li 788*bf2c3715SXin Li# The EXAMPLE_PATH tag can be used to specify one or more files or 789*bf2c3715SXin Li# directories that contain example code fragments that are included (see 790*bf2c3715SXin Li# the \include command). 791*bf2c3715SXin Li 792*bf2c3715SXin LiEXAMPLE_PATH = "${Eigen_SOURCE_DIR}/doc/snippets" \ 793*bf2c3715SXin Li "${Eigen_BINARY_DIR}/doc/snippets" \ 794*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/doc/examples" \ 795*bf2c3715SXin Li "${Eigen_BINARY_DIR}/doc/examples" \ 796*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/doc/special_examples" \ 797*bf2c3715SXin Li "${Eigen_BINARY_DIR}/doc/special_examples" \ 798*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/unsupported/doc/snippets" \ 799*bf2c3715SXin Li "${Eigen_BINARY_DIR}/unsupported/doc/snippets" \ 800*bf2c3715SXin Li "${Eigen_SOURCE_DIR}/unsupported/doc/examples" \ 801*bf2c3715SXin Li "${Eigen_BINARY_DIR}/unsupported/doc/examples" 802*bf2c3715SXin Li 803*bf2c3715SXin Li# If the value of the EXAMPLE_PATH tag contains directories, you can use the 804*bf2c3715SXin Li# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp 805*bf2c3715SXin Li# and *.h) to filter out the source-files in the directories. If left 806*bf2c3715SXin Li# blank all files are included. 807*bf2c3715SXin Li 808*bf2c3715SXin LiEXAMPLE_PATTERNS = * 809*bf2c3715SXin Li 810*bf2c3715SXin Li# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be 811*bf2c3715SXin Li# searched for input files to be used with the \include or \dontinclude 812*bf2c3715SXin Li# commands irrespective of the value of the RECURSIVE tag. 813*bf2c3715SXin Li# Possible values are YES and NO. If left blank NO is used. 814*bf2c3715SXin Li 815*bf2c3715SXin LiEXAMPLE_RECURSIVE = NO 816*bf2c3715SXin Li 817*bf2c3715SXin Li# The IMAGE_PATH tag can be used to specify one or more files or 818*bf2c3715SXin Li# directories that contain image that are included in the documentation (see 819*bf2c3715SXin Li# the \image command). 820*bf2c3715SXin Li 821*bf2c3715SXin LiIMAGE_PATH = ${Eigen_BINARY_DIR}/doc/html 822*bf2c3715SXin Li 823*bf2c3715SXin Li# The INPUT_FILTER tag can be used to specify a program that doxygen should 824*bf2c3715SXin Li# invoke to filter for each input file. Doxygen will invoke the filter program 825*bf2c3715SXin Li# by executing (via popen()) the command <filter> <input-file>, where <filter> 826*bf2c3715SXin Li# is the value of the INPUT_FILTER tag, and <input-file> is the name of an 827*bf2c3715SXin Li# input file. Doxygen will then use the output that the filter program writes 828*bf2c3715SXin Li# to standard output. 829*bf2c3715SXin Li# If FILTER_PATTERNS is specified, this tag will be 830*bf2c3715SXin Li# ignored. 831*bf2c3715SXin Li 832*bf2c3715SXin LiINPUT_FILTER = 833*bf2c3715SXin Li 834*bf2c3715SXin Li# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern 835*bf2c3715SXin Li# basis. 836*bf2c3715SXin Li# Doxygen will compare the file name with each pattern and apply the 837*bf2c3715SXin Li# filter if there is a match. 838*bf2c3715SXin Li# The filters are a list of the form: 839*bf2c3715SXin Li# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further 840*bf2c3715SXin Li# info on how filters are used. If FILTER_PATTERNS is empty or if 841*bf2c3715SXin Li# non of the patterns match the file name, INPUT_FILTER is applied. 842*bf2c3715SXin Li 843*bf2c3715SXin LiFILTER_PATTERNS = 844*bf2c3715SXin Li 845*bf2c3715SXin Li# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using 846*bf2c3715SXin Li# INPUT_FILTER) will be used to filter the input files when producing source 847*bf2c3715SXin Li# files to browse (i.e. when SOURCE_BROWSER is set to YES). 848*bf2c3715SXin Li 849*bf2c3715SXin LiFILTER_SOURCE_FILES = NO 850*bf2c3715SXin Li 851*bf2c3715SXin Li# The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file 852*bf2c3715SXin Li# pattern. A pattern will override the setting for FILTER_PATTERN (if any) 853*bf2c3715SXin Li# and it is also possible to disable source filtering for a specific pattern 854*bf2c3715SXin Li# using *.ext= (so without naming a filter). This option only has effect when 855*bf2c3715SXin Li# FILTER_SOURCE_FILES is enabled. 856*bf2c3715SXin Li 857*bf2c3715SXin LiFILTER_SOURCE_PATTERNS = 858*bf2c3715SXin Li 859*bf2c3715SXin Li#--------------------------------------------------------------------------- 860*bf2c3715SXin Li# configuration options related to source browsing 861*bf2c3715SXin Li#--------------------------------------------------------------------------- 862*bf2c3715SXin Li 863*bf2c3715SXin Li# If the SOURCE_BROWSER tag is set to YES then a list of source files will 864*bf2c3715SXin Li# be generated. Documented entities will be cross-referenced with these sources. 865*bf2c3715SXin Li# Note: To get rid of all source code in the generated output, make sure also 866*bf2c3715SXin Li# VERBATIM_HEADERS is set to NO. 867*bf2c3715SXin Li 868*bf2c3715SXin LiSOURCE_BROWSER = NO 869*bf2c3715SXin Li 870*bf2c3715SXin Li# Setting the INLINE_SOURCES tag to YES will include the body 871*bf2c3715SXin Li# of functions and classes directly in the documentation. 872*bf2c3715SXin Li 873*bf2c3715SXin LiINLINE_SOURCES = NO 874*bf2c3715SXin Li 875*bf2c3715SXin Li# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct 876*bf2c3715SXin Li# doxygen to hide any special comment blocks from generated source code 877*bf2c3715SXin Li# fragments. Normal C, C++ and Fortran comments will always remain visible. 878*bf2c3715SXin Li 879*bf2c3715SXin LiSTRIP_CODE_COMMENTS = YES 880*bf2c3715SXin Li 881*bf2c3715SXin Li# If the REFERENCED_BY_RELATION tag is set to YES 882*bf2c3715SXin Li# then for each documented function all documented 883*bf2c3715SXin Li# functions referencing it will be listed. 884*bf2c3715SXin Li 885*bf2c3715SXin LiREFERENCED_BY_RELATION = NO 886*bf2c3715SXin Li 887*bf2c3715SXin Li# If the REFERENCES_RELATION tag is set to YES 888*bf2c3715SXin Li# then for each documented function all documented entities 889*bf2c3715SXin Li# called/used by that function will be listed. 890*bf2c3715SXin Li 891*bf2c3715SXin LiREFERENCES_RELATION = NO 892*bf2c3715SXin Li 893*bf2c3715SXin Li# If the REFERENCES_LINK_SOURCE tag is set to YES (the default) 894*bf2c3715SXin Li# and SOURCE_BROWSER tag is set to YES, then the hyperlinks from 895*bf2c3715SXin Li# functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will 896*bf2c3715SXin Li# link to the source code. 897*bf2c3715SXin Li# Otherwise they will link to the documentation. 898*bf2c3715SXin Li 899*bf2c3715SXin LiREFERENCES_LINK_SOURCE = YES 900*bf2c3715SXin Li 901*bf2c3715SXin Li# If the USE_HTAGS tag is set to YES then the references to source code 902*bf2c3715SXin Li# will point to the HTML generated by the htags(1) tool instead of doxygen 903*bf2c3715SXin Li# built-in source browser. The htags tool is part of GNU's global source 904*bf2c3715SXin Li# tagging system (see http://www.gnu.org/software/global/global.html). You 905*bf2c3715SXin Li# will need version 4.8.6 or higher. 906*bf2c3715SXin Li 907*bf2c3715SXin LiUSE_HTAGS = NO 908*bf2c3715SXin Li 909*bf2c3715SXin Li# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen 910*bf2c3715SXin Li# will generate a verbatim copy of the header file for each class for 911*bf2c3715SXin Li# which an include is specified. Set to NO to disable this. 912*bf2c3715SXin Li 913*bf2c3715SXin LiVERBATIM_HEADERS = YES 914*bf2c3715SXin Li 915*bf2c3715SXin Li#--------------------------------------------------------------------------- 916*bf2c3715SXin Li# configuration options related to the alphabetical class index 917*bf2c3715SXin Li#--------------------------------------------------------------------------- 918*bf2c3715SXin Li 919*bf2c3715SXin Li# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index 920*bf2c3715SXin Li# of all compounds will be generated. Enable this if the project 921*bf2c3715SXin Li# contains a lot of classes, structs, unions or interfaces. 922*bf2c3715SXin Li 923*bf2c3715SXin LiALPHABETICAL_INDEX = NO 924*bf2c3715SXin Li 925*bf2c3715SXin Li# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then 926*bf2c3715SXin Li# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns 927*bf2c3715SXin Li# in which this list will be split (can be a number in the range [1..20]) 928*bf2c3715SXin Li 929*bf2c3715SXin LiCOLS_IN_ALPHA_INDEX = 5 930*bf2c3715SXin Li 931*bf2c3715SXin Li# In case all classes in a project start with a common prefix, all 932*bf2c3715SXin Li# classes will be put under the same header in the alphabetical index. 933*bf2c3715SXin Li# The IGNORE_PREFIX tag can be used to specify one or more prefixes that 934*bf2c3715SXin Li# should be ignored while generating the index headers. 935*bf2c3715SXin Li 936*bf2c3715SXin LiIGNORE_PREFIX = 937*bf2c3715SXin Li 938*bf2c3715SXin Li#--------------------------------------------------------------------------- 939*bf2c3715SXin Li# configuration options related to the HTML output 940*bf2c3715SXin Li#--------------------------------------------------------------------------- 941*bf2c3715SXin Li 942*bf2c3715SXin Li# If the GENERATE_HTML tag is set to YES (the default) Doxygen will 943*bf2c3715SXin Li# generate HTML output. 944*bf2c3715SXin Li 945*bf2c3715SXin LiGENERATE_HTML = YES 946*bf2c3715SXin Li 947*bf2c3715SXin Li# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. 948*bf2c3715SXin Li# If a relative path is entered the value of OUTPUT_DIRECTORY will be 949*bf2c3715SXin Li# put in front of it. If left blank `html' will be used as the default path. 950*bf2c3715SXin Li 951*bf2c3715SXin LiHTML_OUTPUT = "${Eigen_BINARY_DIR}/doc/html${EIGEN_DOXY_OUTPUT_DIRECTORY_SUFFIX}" 952*bf2c3715SXin Li 953*bf2c3715SXin Li# The HTML_FILE_EXTENSION tag can be used to specify the file extension for 954*bf2c3715SXin Li# each generated HTML page (for example: .htm,.php,.asp). If it is left blank 955*bf2c3715SXin Li# doxygen will generate files with .html extension. 956*bf2c3715SXin Li 957*bf2c3715SXin LiHTML_FILE_EXTENSION = .html 958*bf2c3715SXin Li 959*bf2c3715SXin Li# The HTML_HEADER tag can be used to specify a personal HTML header for 960*bf2c3715SXin Li# each generated HTML page. If it is left blank doxygen will generate a 961*bf2c3715SXin Li# standard header. Note that when using a custom header you are responsible 962*bf2c3715SXin Li# for the proper inclusion of any scripts and style sheets that doxygen 963*bf2c3715SXin Li# needs, which is dependent on the configuration options used. 964*bf2c3715SXin Li# It is advised to generate a default header using "doxygen -w html 965*bf2c3715SXin Li# header.html footer.html stylesheet.css YourConfigFile" and then modify 966*bf2c3715SXin Li# that header. Note that the header is subject to change so you typically 967*bf2c3715SXin Li# have to redo this when upgrading to a newer version of doxygen or when 968*bf2c3715SXin Li# changing the value of configuration settings such as GENERATE_TREEVIEW! 969*bf2c3715SXin Li 970*bf2c3715SXin LiHTML_HEADER = "${Eigen_BINARY_DIR}/doc/eigendoxy_header.html" 971*bf2c3715SXin Li 972*bf2c3715SXin Li# The HTML_FOOTER tag can be used to specify a personal HTML footer for 973*bf2c3715SXin Li# each generated HTML page. If it is left blank doxygen will generate a 974*bf2c3715SXin Li# standard footer. 975*bf2c3715SXin Li 976*bf2c3715SXin LiHTML_FOOTER = "${Eigen_BINARY_DIR}/doc/eigendoxy_footer.html" 977*bf2c3715SXin Li 978*bf2c3715SXin Li# The HTML_STYLESHEET tag can be used to specify a user-defined cascading 979*bf2c3715SXin Li# style sheet that is used by each HTML page. It can be used to 980*bf2c3715SXin Li# fine-tune the look of the HTML output. If the tag is left blank doxygen 981*bf2c3715SXin Li# will generate a default style sheet. Note that doxygen will try to copy 982*bf2c3715SXin Li# the style sheet file to the HTML output directory, so don't put your own 983*bf2c3715SXin Li# style sheet in the HTML output directory as well, or it will be erased! 984*bf2c3715SXin Li 985*bf2c3715SXin LiHTML_STYLESHEET = 986*bf2c3715SXin Li 987*bf2c3715SXin Li# The HTML_EXTRA_FILES tag can be used to specify one or more extra images or 988*bf2c3715SXin Li# other source files which should be copied to the HTML output directory. Note 989*bf2c3715SXin Li# that these files will be copied to the base HTML output directory. Use the 990*bf2c3715SXin Li# $relpath$ marker in the HTML_HEADER and/or HTML_FOOTER files to load these 991*bf2c3715SXin Li# files. In the HTML_STYLESHEET file, use the file name only. Also note that 992*bf2c3715SXin Li# the files will be copied as-is; there are no commands or markers available. 993*bf2c3715SXin Li 994*bf2c3715SXin LiHTML_EXTRA_FILES = "${Eigen_SOURCE_DIR}/doc/eigendoxy.css" 995*bf2c3715SXin Li 996*bf2c3715SXin Li# The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. 997*bf2c3715SXin Li# Doxygen will adjust the colors in the style sheet and background images 998*bf2c3715SXin Li# according to this color. Hue is specified as an angle on a colorwheel, 999*bf2c3715SXin Li# see http://en.wikipedia.org/wiki/Hue for more information. 1000*bf2c3715SXin Li# For instance the value 0 represents red, 60 is yellow, 120 is green, 1001*bf2c3715SXin Li# 180 is cyan, 240 is blue, 300 purple, and 360 is red again. 1002*bf2c3715SXin Li# The allowed range is 0 to 359. 1003*bf2c3715SXin Li# The default is 220. 1004*bf2c3715SXin Li 1005*bf2c3715SXin LiHTML_COLORSTYLE_HUE = ${EIGEN_DOXY_HTML_COLORSTYLE_HUE} 1006*bf2c3715SXin Li 1007*bf2c3715SXin Li# The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of 1008*bf2c3715SXin Li# the colors in the HTML output. For a value of 0 the output will use 1009*bf2c3715SXin Li# grayscales only. A value of 255 will produce the most vivid colors. 1010*bf2c3715SXin Li 1011*bf2c3715SXin LiHTML_COLORSTYLE_SAT = 100 1012*bf2c3715SXin Li 1013*bf2c3715SXin Li# The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to 1014*bf2c3715SXin Li# the luminance component of the colors in the HTML output. Values below 1015*bf2c3715SXin Li# 100 gradually make the output lighter, whereas values above 100 make 1016*bf2c3715SXin Li# the output darker. The value divided by 100 is the actual gamma applied, 1017*bf2c3715SXin Li# so 80 represents a gamma of 0.8, The value 220 represents a gamma of 2.2, 1018*bf2c3715SXin Li# and 100 does not change the gamma. 1019*bf2c3715SXin Li 1020*bf2c3715SXin LiHTML_COLORSTYLE_GAMMA = 80 1021*bf2c3715SXin Li 1022*bf2c3715SXin Li# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML 1023*bf2c3715SXin Li# page will contain the date and time when the page was generated. Setting 1024*bf2c3715SXin Li# this to NO can help when comparing the output of multiple runs. 1025*bf2c3715SXin Li 1026*bf2c3715SXin LiHTML_TIMESTAMP = YES 1027*bf2c3715SXin Li 1028*bf2c3715SXin Li# If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML 1029*bf2c3715SXin Li# documentation will contain sections that can be hidden and shown after the 1030*bf2c3715SXin Li# page has loaded. 1031*bf2c3715SXin Li 1032*bf2c3715SXin LiHTML_DYNAMIC_SECTIONS = YES 1033*bf2c3715SXin Li 1034*bf2c3715SXin Li# With HTML_INDEX_NUM_ENTRIES one can control the preferred number of 1035*bf2c3715SXin Li# entries shown in the various tree structured indices initially; the user 1036*bf2c3715SXin Li# can expand and collapse entries dynamically later on. Doxygen will expand 1037*bf2c3715SXin Li# the tree to such a level that at most the specified number of entries are 1038*bf2c3715SXin Li# visible (unless a fully collapsed tree already exceeds this amount). 1039*bf2c3715SXin Li# So setting the number of entries 1 will produce a full collapsed tree by 1040*bf2c3715SXin Li# default. 0 is a special value representing an infinite number of entries 1041*bf2c3715SXin Li# and will result in a full expanded tree by default. 1042*bf2c3715SXin Li 1043*bf2c3715SXin LiHTML_INDEX_NUM_ENTRIES = 100 1044*bf2c3715SXin Li 1045*bf2c3715SXin Li# If the GENERATE_DOCSET tag is set to YES, additional index files 1046*bf2c3715SXin Li# will be generated that can be used as input for Apple's Xcode 3 1047*bf2c3715SXin Li# integrated development environment, introduced with OSX 10.5 (Leopard). 1048*bf2c3715SXin Li# To create a documentation set, doxygen will generate a Makefile in the 1049*bf2c3715SXin Li# HTML output directory. Running make will produce the docset in that 1050*bf2c3715SXin Li# directory and running "make install" will install the docset in 1051*bf2c3715SXin Li# ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find 1052*bf2c3715SXin Li# it at startup. 1053*bf2c3715SXin Li# See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html 1054*bf2c3715SXin Li# for more information. 1055*bf2c3715SXin Li 1056*bf2c3715SXin LiGENERATE_DOCSET = NO 1057*bf2c3715SXin Li 1058*bf2c3715SXin Li# When GENERATE_DOCSET tag is set to YES, this tag determines the name of the 1059*bf2c3715SXin Li# feed. A documentation feed provides an umbrella under which multiple 1060*bf2c3715SXin Li# documentation sets from a single provider (such as a company or product suite) 1061*bf2c3715SXin Li# can be grouped. 1062*bf2c3715SXin Li 1063*bf2c3715SXin LiDOCSET_FEEDNAME = "Doxygen generated docs" 1064*bf2c3715SXin Li 1065*bf2c3715SXin Li# When GENERATE_DOCSET tag is set to YES, this tag specifies a string that 1066*bf2c3715SXin Li# should uniquely identify the documentation set bundle. This should be a 1067*bf2c3715SXin Li# reverse domain-name style string, e.g. com.mycompany.MyDocSet. Doxygen 1068*bf2c3715SXin Li# will append .docset to the name. 1069*bf2c3715SXin Li 1070*bf2c3715SXin LiDOCSET_BUNDLE_ID = org.doxygen.Project 1071*bf2c3715SXin Li 1072*bf2c3715SXin Li# When GENERATE_PUBLISHER_ID tag specifies a string that should uniquely identify 1073*bf2c3715SXin Li# the documentation publisher. This should be a reverse domain-name style 1074*bf2c3715SXin Li# string, e.g. com.mycompany.MyDocSet.documentation. 1075*bf2c3715SXin Li 1076*bf2c3715SXin LiDOCSET_PUBLISHER_ID = org.doxygen.Publisher 1077*bf2c3715SXin Li 1078*bf2c3715SXin Li# The GENERATE_PUBLISHER_NAME tag identifies the documentation publisher. 1079*bf2c3715SXin Li 1080*bf2c3715SXin LiDOCSET_PUBLISHER_NAME = Publisher 1081*bf2c3715SXin Li 1082*bf2c3715SXin Li# If the GENERATE_HTMLHELP tag is set to YES, additional index files 1083*bf2c3715SXin Li# will be generated that can be used as input for tools like the 1084*bf2c3715SXin Li# Microsoft HTML help workshop to generate a compiled HTML help file (.chm) 1085*bf2c3715SXin Li# of the generated HTML documentation. 1086*bf2c3715SXin Li 1087*bf2c3715SXin LiGENERATE_HTMLHELP = NO 1088*bf2c3715SXin Li 1089*bf2c3715SXin Li# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can 1090*bf2c3715SXin Li# be used to specify the file name of the resulting .chm file. You 1091*bf2c3715SXin Li# can add a path in front of the file if the result should not be 1092*bf2c3715SXin Li# written to the html output directory. 1093*bf2c3715SXin Li 1094*bf2c3715SXin LiCHM_FILE = 1095*bf2c3715SXin Li 1096*bf2c3715SXin Li# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can 1097*bf2c3715SXin Li# be used to specify the location (absolute path including file name) of 1098*bf2c3715SXin Li# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run 1099*bf2c3715SXin Li# the HTML help compiler on the generated index.hhp. 1100*bf2c3715SXin Li 1101*bf2c3715SXin LiHHC_LOCATION = 1102*bf2c3715SXin Li 1103*bf2c3715SXin Li# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag 1104*bf2c3715SXin Li# controls if a separate .chi index file is generated (YES) or that 1105*bf2c3715SXin Li# it should be included in the master .chm file (NO). 1106*bf2c3715SXin Li 1107*bf2c3715SXin LiGENERATE_CHI = NO 1108*bf2c3715SXin Li 1109*bf2c3715SXin Li# If the GENERATE_HTMLHELP tag is set to YES, the CHM_INDEX_ENCODING 1110*bf2c3715SXin Li# is used to encode HtmlHelp index (hhk), content (hhc) and project file 1111*bf2c3715SXin Li# content. 1112*bf2c3715SXin Li 1113*bf2c3715SXin LiCHM_INDEX_ENCODING = 1114*bf2c3715SXin Li 1115*bf2c3715SXin Li# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag 1116*bf2c3715SXin Li# controls whether a binary table of contents is generated (YES) or a 1117*bf2c3715SXin Li# normal table of contents (NO) in the .chm file. 1118*bf2c3715SXin Li 1119*bf2c3715SXin LiBINARY_TOC = NO 1120*bf2c3715SXin Li 1121*bf2c3715SXin Li# The TOC_EXPAND flag can be set to YES to add extra items for group members 1122*bf2c3715SXin Li# to the contents of the HTML help documentation and to the tree view. 1123*bf2c3715SXin Li 1124*bf2c3715SXin LiTOC_EXPAND = NO 1125*bf2c3715SXin Li 1126*bf2c3715SXin Li# If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and 1127*bf2c3715SXin Li# QHP_VIRTUAL_FOLDER are set, an additional index file will be generated 1128*bf2c3715SXin Li# that can be used as input for Qt's qhelpgenerator to generate a 1129*bf2c3715SXin Li# Qt Compressed Help (.qch) of the generated HTML documentation. 1130*bf2c3715SXin Li 1131*bf2c3715SXin LiGENERATE_QHP = NO 1132*bf2c3715SXin Li 1133*bf2c3715SXin Li# If the QHG_LOCATION tag is specified, the QCH_FILE tag can 1134*bf2c3715SXin Li# be used to specify the file name of the resulting .qch file. 1135*bf2c3715SXin Li# The path specified is relative to the HTML output folder. 1136*bf2c3715SXin Li 1137*bf2c3715SXin LiQCH_FILE = 1138*bf2c3715SXin Li 1139*bf2c3715SXin Li# The QHP_NAMESPACE tag specifies the namespace to use when generating 1140*bf2c3715SXin Li# Qt Help Project output. For more information please see 1141*bf2c3715SXin Li# http://doc.trolltech.com/qthelpproject.html#namespace 1142*bf2c3715SXin Li 1143*bf2c3715SXin LiQHP_NAMESPACE = org.doxygen.Project 1144*bf2c3715SXin Li 1145*bf2c3715SXin Li# The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating 1146*bf2c3715SXin Li# Qt Help Project output. For more information please see 1147*bf2c3715SXin Li# http://doc.trolltech.com/qthelpproject.html#virtual-folders 1148*bf2c3715SXin Li 1149*bf2c3715SXin LiQHP_VIRTUAL_FOLDER = doc 1150*bf2c3715SXin Li 1151*bf2c3715SXin Li# If QHP_CUST_FILTER_NAME is set, it specifies the name of a custom filter to 1152*bf2c3715SXin Li# add. For more information please see 1153*bf2c3715SXin Li# http://doc.trolltech.com/qthelpproject.html#custom-filters 1154*bf2c3715SXin Li 1155*bf2c3715SXin LiQHP_CUST_FILTER_NAME = 1156*bf2c3715SXin Li 1157*bf2c3715SXin Li# The QHP_CUST_FILT_ATTRS tag specifies the list of the attributes of the 1158*bf2c3715SXin Li# custom filter to add. For more information please see 1159*bf2c3715SXin Li# <a href="http://doc.trolltech.com/qthelpproject.html#custom-filters"> 1160*bf2c3715SXin Li# Qt Help Project / Custom Filters</a>. 1161*bf2c3715SXin Li 1162*bf2c3715SXin LiQHP_CUST_FILTER_ATTRS = 1163*bf2c3715SXin Li 1164*bf2c3715SXin Li# The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this 1165*bf2c3715SXin Li# project's 1166*bf2c3715SXin Li# filter section matches. 1167*bf2c3715SXin Li# <a href="http://doc.trolltech.com/qthelpproject.html#filter-attributes"> 1168*bf2c3715SXin Li# Qt Help Project / Filter Attributes</a>. 1169*bf2c3715SXin Li 1170*bf2c3715SXin LiQHP_SECT_FILTER_ATTRS = 1171*bf2c3715SXin Li 1172*bf2c3715SXin Li# If the GENERATE_QHP tag is set to YES, the QHG_LOCATION tag can 1173*bf2c3715SXin Li# be used to specify the location of Qt's qhelpgenerator. 1174*bf2c3715SXin Li# If non-empty doxygen will try to run qhelpgenerator on the generated 1175*bf2c3715SXin Li# .qhp file. 1176*bf2c3715SXin Li 1177*bf2c3715SXin LiQHG_LOCATION = 1178*bf2c3715SXin Li 1179*bf2c3715SXin Li# If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files 1180*bf2c3715SXin Li# will be generated, which together with the HTML files, form an Eclipse help 1181*bf2c3715SXin Li# plugin. To install this plugin and make it available under the help contents 1182*bf2c3715SXin Li# menu in Eclipse, the contents of the directory containing the HTML and XML 1183*bf2c3715SXin Li# files needs to be copied into the plugins directory of eclipse. The name of 1184*bf2c3715SXin Li# the directory within the plugins directory should be the same as 1185*bf2c3715SXin Li# the ECLIPSE_DOC_ID value. After copying Eclipse needs to be restarted before 1186*bf2c3715SXin Li# the help appears. 1187*bf2c3715SXin Li 1188*bf2c3715SXin LiGENERATE_ECLIPSEHELP = NO 1189*bf2c3715SXin Li 1190*bf2c3715SXin Li# A unique identifier for the eclipse help plugin. When installing the plugin 1191*bf2c3715SXin Li# the directory name containing the HTML and XML files should also have 1192*bf2c3715SXin Li# this name. 1193*bf2c3715SXin Li 1194*bf2c3715SXin LiECLIPSE_DOC_ID = org.doxygen.Project 1195*bf2c3715SXin Li 1196*bf2c3715SXin Li# The DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) 1197*bf2c3715SXin Li# at top of each HTML page. The value NO (the default) enables the index and 1198*bf2c3715SXin Li# the value YES disables it. Since the tabs have the same information as the 1199*bf2c3715SXin Li# navigation tree you can set this option to NO if you already set 1200*bf2c3715SXin Li# GENERATE_TREEVIEW to YES. 1201*bf2c3715SXin Li 1202*bf2c3715SXin LiDISABLE_INDEX = YES 1203*bf2c3715SXin Li 1204*bf2c3715SXin Li# The GENERATE_TREEVIEW tag is used to specify whether a tree-like index 1205*bf2c3715SXin Li# structure should be generated to display hierarchical information. 1206*bf2c3715SXin Li# If the tag value is set to YES, a side panel will be generated 1207*bf2c3715SXin Li# containing a tree-like index structure (just like the one that 1208*bf2c3715SXin Li# is generated for HTML Help). For this to work a browser that supports 1209*bf2c3715SXin Li# JavaScript, DHTML, CSS and frames is required (i.e. any modern browser). 1210*bf2c3715SXin Li# Windows users are probably better off using the HTML help feature. 1211*bf2c3715SXin Li# Since the tree basically has the same information as the tab index you 1212*bf2c3715SXin Li# could consider to set DISABLE_INDEX to NO when enabling this option. 1213*bf2c3715SXin Li 1214*bf2c3715SXin LiGENERATE_TREEVIEW = YES 1215*bf2c3715SXin Li 1216*bf2c3715SXin Li# The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values 1217*bf2c3715SXin Li# (range [0,1..20]) that doxygen will group on one line in the generated HTML 1218*bf2c3715SXin Li# documentation. Note that a value of 0 will completely suppress the enum 1219*bf2c3715SXin Li# values from appearing in the overview section. 1220*bf2c3715SXin Li 1221*bf2c3715SXin LiENUM_VALUES_PER_LINE = 1 1222*bf2c3715SXin Li 1223*bf2c3715SXin Li# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be 1224*bf2c3715SXin Li# used to set the initial width (in pixels) of the frame in which the tree 1225*bf2c3715SXin Li# is shown. 1226*bf2c3715SXin Li 1227*bf2c3715SXin LiTREEVIEW_WIDTH = 250 1228*bf2c3715SXin Li 1229*bf2c3715SXin Li# When the EXT_LINKS_IN_WINDOW option is set to YES doxygen will open 1230*bf2c3715SXin Li# links to external symbols imported via tag files in a separate window. 1231*bf2c3715SXin Li 1232*bf2c3715SXin LiEXT_LINKS_IN_WINDOW = NO 1233*bf2c3715SXin Li 1234*bf2c3715SXin Li# Use this tag to change the font size of Latex formulas included 1235*bf2c3715SXin Li# as images in the HTML documentation. The default is 10. Note that 1236*bf2c3715SXin Li# when you change the font size after a successful doxygen run you need 1237*bf2c3715SXin Li# to manually remove any form_*.png images from the HTML output directory 1238*bf2c3715SXin Li# to force them to be regenerated. 1239*bf2c3715SXin Li 1240*bf2c3715SXin LiFORMULA_FONTSIZE = 12 1241*bf2c3715SXin Li 1242*bf2c3715SXin Li# Use the FORMULA_TRANPARENT tag to determine whether or not the images 1243*bf2c3715SXin Li# generated for formulas are transparent PNGs. Transparent PNGs are 1244*bf2c3715SXin Li# not supported properly for IE 6.0, but are supported on all modern browsers. 1245*bf2c3715SXin Li# Note that when changing this option you need to delete any form_*.png files 1246*bf2c3715SXin Li# in the HTML output before the changes have effect. 1247*bf2c3715SXin Li 1248*bf2c3715SXin LiFORMULA_TRANSPARENT = YES 1249*bf2c3715SXin Li 1250*bf2c3715SXin Li# Enable the USE_MATHJAX option to render LaTeX formulas using MathJax 1251*bf2c3715SXin Li# (see http://www.mathjax.org) which uses client side Javascript for the 1252*bf2c3715SXin Li# rendering instead of using prerendered bitmaps. Use this if you do not 1253*bf2c3715SXin Li# have LaTeX installed or if you want to formulas look prettier in the HTML 1254*bf2c3715SXin Li# output. When enabled you may also need to install MathJax separately and 1255*bf2c3715SXin Li# configure the path to it using the MATHJAX_RELPATH option. 1256*bf2c3715SXin Li 1257*bf2c3715SXin LiUSE_MATHJAX = @EIGEN_DOXY_USE_MATHJAX@ 1258*bf2c3715SXin Li 1259*bf2c3715SXin Li# When MathJax is enabled you need to specify the location relative to the 1260*bf2c3715SXin Li# HTML output directory using the MATHJAX_RELPATH option. The destination 1261*bf2c3715SXin Li# directory should contain the MathJax.js script. For instance, if the mathjax 1262*bf2c3715SXin Li# directory is located at the same level as the HTML output directory, then 1263*bf2c3715SXin Li# MATHJAX_RELPATH should be ../mathjax. The default value points to 1264*bf2c3715SXin Li# the MathJax Content Delivery Network so you can quickly see the result without 1265*bf2c3715SXin Li# installing MathJax. 1266*bf2c3715SXin Li# However, it is strongly recommended to install a local 1267*bf2c3715SXin Li# copy of MathJax from http://www.mathjax.org before deployment. 1268*bf2c3715SXin Li 1269*bf2c3715SXin LiMATHJAX_RELPATH = https://cdn.mathjax.org/mathjax/latest 1270*bf2c3715SXin Li 1271*bf2c3715SXin Li# The MATHJAX_EXTENSIONS tag can be used to specify one or MathJax extension 1272*bf2c3715SXin Li# names that should be enabled during MathJax rendering. 1273*bf2c3715SXin Li 1274*bf2c3715SXin LiMATHJAX_EXTENSIONS = TeX/AMSmath TeX/AMSsymbols 1275*bf2c3715SXin Li 1276*bf2c3715SXin Li# When the SEARCHENGINE tag is enabled doxygen will generate a search box 1277*bf2c3715SXin Li# for the HTML output. The underlying search engine uses javascript 1278*bf2c3715SXin Li# and DHTML and should work on any modern browser. Note that when using 1279*bf2c3715SXin Li# HTML help (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets 1280*bf2c3715SXin Li# (GENERATE_DOCSET) there is already a search function so this one should 1281*bf2c3715SXin Li# typically be disabled. For large projects the javascript based search engine 1282*bf2c3715SXin Li# can be slow, then enabling SERVER_BASED_SEARCH may provide a better solution. 1283*bf2c3715SXin Li 1284*bf2c3715SXin LiSEARCHENGINE = YES 1285*bf2c3715SXin Li 1286*bf2c3715SXin Li# When the SERVER_BASED_SEARCH tag is enabled the search engine will be 1287*bf2c3715SXin Li# implemented using a PHP enabled web server instead of at the web client 1288*bf2c3715SXin Li# using Javascript. Doxygen will generate the search PHP script and index 1289*bf2c3715SXin Li# file to put on the web server. The advantage of the server 1290*bf2c3715SXin Li# based approach is that it scales better to large projects and allows 1291*bf2c3715SXin Li# full text search. The disadvantages are that it is more difficult to setup 1292*bf2c3715SXin Li# and does not have live searching capabilities. 1293*bf2c3715SXin Li 1294*bf2c3715SXin LiSERVER_BASED_SEARCH = NO 1295*bf2c3715SXin Li 1296*bf2c3715SXin Li#--------------------------------------------------------------------------- 1297*bf2c3715SXin Li# configuration options related to the LaTeX output 1298*bf2c3715SXin Li#--------------------------------------------------------------------------- 1299*bf2c3715SXin Li 1300*bf2c3715SXin Li# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will 1301*bf2c3715SXin Li# generate Latex output. 1302*bf2c3715SXin Li 1303*bf2c3715SXin LiGENERATE_LATEX = NO 1304*bf2c3715SXin Li 1305*bf2c3715SXin Li# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. 1306*bf2c3715SXin Li# If a relative path is entered the value of OUTPUT_DIRECTORY will be 1307*bf2c3715SXin Li# put in front of it. If left blank `latex' will be used as the default path. 1308*bf2c3715SXin Li 1309*bf2c3715SXin LiLATEX_OUTPUT = latex 1310*bf2c3715SXin Li 1311*bf2c3715SXin Li# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be 1312*bf2c3715SXin Li# invoked. If left blank `latex' will be used as the default command name. 1313*bf2c3715SXin Li# Note that when enabling USE_PDFLATEX this option is only used for 1314*bf2c3715SXin Li# generating bitmaps for formulas in the HTML output, but not in the 1315*bf2c3715SXin Li# Makefile that is written to the output directory. 1316*bf2c3715SXin Li 1317*bf2c3715SXin LiLATEX_CMD_NAME = latex 1318*bf2c3715SXin Li 1319*bf2c3715SXin Li# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to 1320*bf2c3715SXin Li# generate index for LaTeX. If left blank `makeindex' will be used as the 1321*bf2c3715SXin Li# default command name. 1322*bf2c3715SXin Li 1323*bf2c3715SXin LiMAKEINDEX_CMD_NAME = makeindex 1324*bf2c3715SXin Li 1325*bf2c3715SXin Li# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact 1326*bf2c3715SXin Li# LaTeX documents. This may be useful for small projects and may help to 1327*bf2c3715SXin Li# save some trees in general. 1328*bf2c3715SXin Li 1329*bf2c3715SXin LiCOMPACT_LATEX = NO 1330*bf2c3715SXin Li 1331*bf2c3715SXin Li# The PAPER_TYPE tag can be used to set the paper type that is used 1332*bf2c3715SXin Li# by the printer. Possible values are: a4, letter, legal and 1333*bf2c3715SXin Li# executive. If left blank a4wide will be used. 1334*bf2c3715SXin Li 1335*bf2c3715SXin LiPAPER_TYPE = a4wide 1336*bf2c3715SXin Li 1337*bf2c3715SXin Li# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX 1338*bf2c3715SXin Li# packages that should be included in the LaTeX output. 1339*bf2c3715SXin Li 1340*bf2c3715SXin LiEXTRA_PACKAGES = amssymb \ 1341*bf2c3715SXin Li amsmath 1342*bf2c3715SXin Li 1343*bf2c3715SXin Li# The LATEX_HEADER tag can be used to specify a personal LaTeX header for 1344*bf2c3715SXin Li# the generated latex document. The header should contain everything until 1345*bf2c3715SXin Li# the first chapter. If it is left blank doxygen will generate a 1346*bf2c3715SXin Li# standard header. Notice: only use this tag if you know what you are doing! 1347*bf2c3715SXin Li 1348*bf2c3715SXin LiLATEX_HEADER = 1349*bf2c3715SXin Li 1350*bf2c3715SXin Li# The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for 1351*bf2c3715SXin Li# the generated latex document. The footer should contain everything after 1352*bf2c3715SXin Li# the last chapter. If it is left blank doxygen will generate a 1353*bf2c3715SXin Li# standard footer. Notice: only use this tag if you know what you are doing! 1354*bf2c3715SXin Li 1355*bf2c3715SXin LiLATEX_FOOTER = 1356*bf2c3715SXin Li 1357*bf2c3715SXin Li# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated 1358*bf2c3715SXin Li# is prepared for conversion to pdf (using ps2pdf). The pdf file will 1359*bf2c3715SXin Li# contain links (just like the HTML output) instead of page references 1360*bf2c3715SXin Li# This makes the output suitable for online browsing using a pdf viewer. 1361*bf2c3715SXin Li 1362*bf2c3715SXin LiPDF_HYPERLINKS = NO 1363*bf2c3715SXin Li 1364*bf2c3715SXin Li# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of 1365*bf2c3715SXin Li# plain latex in the generated Makefile. Set this option to YES to get a 1366*bf2c3715SXin Li# higher quality PDF documentation. 1367*bf2c3715SXin Li 1368*bf2c3715SXin LiUSE_PDFLATEX = NO 1369*bf2c3715SXin Li 1370*bf2c3715SXin Li# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. 1371*bf2c3715SXin Li# command to the generated LaTeX files. This will instruct LaTeX to keep 1372*bf2c3715SXin Li# running if errors occur, instead of asking the user for help. 1373*bf2c3715SXin Li# This option is also used when generating formulas in HTML. 1374*bf2c3715SXin Li 1375*bf2c3715SXin LiLATEX_BATCHMODE = NO 1376*bf2c3715SXin Li 1377*bf2c3715SXin Li# If LATEX_HIDE_INDICES is set to YES then doxygen will not 1378*bf2c3715SXin Li# include the index chapters (such as File Index, Compound Index, etc.) 1379*bf2c3715SXin Li# in the output. 1380*bf2c3715SXin Li 1381*bf2c3715SXin LiLATEX_HIDE_INDICES = NO 1382*bf2c3715SXin Li 1383*bf2c3715SXin Li# If LATEX_SOURCE_CODE is set to YES then doxygen will include 1384*bf2c3715SXin Li# source code with syntax highlighting in the LaTeX output. 1385*bf2c3715SXin Li# Note that which sources are shown also depends on other settings 1386*bf2c3715SXin Li# such as SOURCE_BROWSER. 1387*bf2c3715SXin Li 1388*bf2c3715SXin LiLATEX_SOURCE_CODE = NO 1389*bf2c3715SXin Li 1390*bf2c3715SXin Li# The LATEX_BIB_STYLE tag can be used to specify the style to use for the 1391*bf2c3715SXin Li# bibliography, e.g. plainnat, or ieeetr. The default style is "plain". See 1392*bf2c3715SXin Li# http://en.wikipedia.org/wiki/BibTeX for more info. 1393*bf2c3715SXin Li 1394*bf2c3715SXin LiLATEX_BIB_STYLE = plain 1395*bf2c3715SXin Li 1396*bf2c3715SXin Li#--------------------------------------------------------------------------- 1397*bf2c3715SXin Li# configuration options related to the RTF output 1398*bf2c3715SXin Li#--------------------------------------------------------------------------- 1399*bf2c3715SXin Li 1400*bf2c3715SXin Li# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output 1401*bf2c3715SXin Li# The RTF output is optimized for Word 97 and may not look very pretty with 1402*bf2c3715SXin Li# other RTF readers or editors. 1403*bf2c3715SXin Li 1404*bf2c3715SXin LiGENERATE_RTF = NO 1405*bf2c3715SXin Li 1406*bf2c3715SXin Li# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. 1407*bf2c3715SXin Li# If a relative path is entered the value of OUTPUT_DIRECTORY will be 1408*bf2c3715SXin Li# put in front of it. If left blank `rtf' will be used as the default path. 1409*bf2c3715SXin Li 1410*bf2c3715SXin LiRTF_OUTPUT = rtf 1411*bf2c3715SXin Li 1412*bf2c3715SXin Li# If the COMPACT_RTF tag is set to YES Doxygen generates more compact 1413*bf2c3715SXin Li# RTF documents. This may be useful for small projects and may help to 1414*bf2c3715SXin Li# save some trees in general. 1415*bf2c3715SXin Li 1416*bf2c3715SXin LiCOMPACT_RTF = NO 1417*bf2c3715SXin Li 1418*bf2c3715SXin Li# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated 1419*bf2c3715SXin Li# will contain hyperlink fields. The RTF file will 1420*bf2c3715SXin Li# contain links (just like the HTML output) instead of page references. 1421*bf2c3715SXin Li# This makes the output suitable for online browsing using WORD or other 1422*bf2c3715SXin Li# programs which support those fields. 1423*bf2c3715SXin Li# Note: wordpad (write) and others do not support links. 1424*bf2c3715SXin Li 1425*bf2c3715SXin LiRTF_HYPERLINKS = NO 1426*bf2c3715SXin Li 1427*bf2c3715SXin Li# Load style sheet definitions from file. Syntax is similar to doxygen's 1428*bf2c3715SXin Li# config file, i.e. a series of assignments. You only have to provide 1429*bf2c3715SXin Li# replacements, missing definitions are set to their default value. 1430*bf2c3715SXin Li 1431*bf2c3715SXin LiRTF_STYLESHEET_FILE = 1432*bf2c3715SXin Li 1433*bf2c3715SXin Li# Set optional variables used in the generation of an rtf document. 1434*bf2c3715SXin Li# Syntax is similar to doxygen's config file. 1435*bf2c3715SXin Li 1436*bf2c3715SXin LiRTF_EXTENSIONS_FILE = 1437*bf2c3715SXin Li 1438*bf2c3715SXin Li#--------------------------------------------------------------------------- 1439*bf2c3715SXin Li# configuration options related to the man page output 1440*bf2c3715SXin Li#--------------------------------------------------------------------------- 1441*bf2c3715SXin Li 1442*bf2c3715SXin Li# If the GENERATE_MAN tag is set to YES (the default) Doxygen will 1443*bf2c3715SXin Li# generate man pages 1444*bf2c3715SXin Li 1445*bf2c3715SXin LiGENERATE_MAN = NO 1446*bf2c3715SXin Li 1447*bf2c3715SXin Li# The MAN_OUTPUT tag is used to specify where the man pages will be put. 1448*bf2c3715SXin Li# If a relative path is entered the value of OUTPUT_DIRECTORY will be 1449*bf2c3715SXin Li# put in front of it. If left blank `man' will be used as the default path. 1450*bf2c3715SXin Li 1451*bf2c3715SXin LiMAN_OUTPUT = man 1452*bf2c3715SXin Li 1453*bf2c3715SXin Li# The MAN_EXTENSION tag determines the extension that is added to 1454*bf2c3715SXin Li# the generated man pages (default is the subroutine's section .3) 1455*bf2c3715SXin Li 1456*bf2c3715SXin LiMAN_EXTENSION = .3 1457*bf2c3715SXin Li 1458*bf2c3715SXin Li# If the MAN_LINKS tag is set to YES and Doxygen generates man output, 1459*bf2c3715SXin Li# then it will generate one additional man file for each entity 1460*bf2c3715SXin Li# documented in the real man page(s). These additional files 1461*bf2c3715SXin Li# only source the real man page, but without them the man command 1462*bf2c3715SXin Li# would be unable to find the correct page. The default is NO. 1463*bf2c3715SXin Li 1464*bf2c3715SXin LiMAN_LINKS = NO 1465*bf2c3715SXin Li 1466*bf2c3715SXin Li#--------------------------------------------------------------------------- 1467*bf2c3715SXin Li# configuration options related to the XML output 1468*bf2c3715SXin Li#--------------------------------------------------------------------------- 1469*bf2c3715SXin Li 1470*bf2c3715SXin Li# If the GENERATE_XML tag is set to YES Doxygen will 1471*bf2c3715SXin Li# generate an XML file that captures the structure of 1472*bf2c3715SXin Li# the code including all documentation. 1473*bf2c3715SXin Li 1474*bf2c3715SXin LiGENERATE_XML = NO 1475*bf2c3715SXin Li 1476*bf2c3715SXin Li# The XML_OUTPUT tag is used to specify where the XML pages will be put. 1477*bf2c3715SXin Li# If a relative path is entered the value of OUTPUT_DIRECTORY will be 1478*bf2c3715SXin Li# put in front of it. If left blank `xml' will be used as the default path. 1479*bf2c3715SXin Li 1480*bf2c3715SXin LiXML_OUTPUT = xml 1481*bf2c3715SXin Li 1482*bf2c3715SXin Li# The XML_SCHEMA tag can be used to specify an XML schema, 1483*bf2c3715SXin Li# which can be used by a validating XML parser to check the 1484*bf2c3715SXin Li# syntax of the XML files. 1485*bf2c3715SXin Li 1486*bf2c3715SXin Li# XML_SCHEMA = 1487*bf2c3715SXin Li 1488*bf2c3715SXin Li# The XML_DTD tag can be used to specify an XML DTD, 1489*bf2c3715SXin Li# which can be used by a validating XML parser to check the 1490*bf2c3715SXin Li# syntax of the XML files. 1491*bf2c3715SXin Li 1492*bf2c3715SXin Li# XML_DTD = 1493*bf2c3715SXin Li 1494*bf2c3715SXin Li# If the XML_PROGRAMLISTING tag is set to YES Doxygen will 1495*bf2c3715SXin Li# dump the program listings (including syntax highlighting 1496*bf2c3715SXin Li# and cross-referencing information) to the XML output. Note that 1497*bf2c3715SXin Li# enabling this will significantly increase the size of the XML output. 1498*bf2c3715SXin Li 1499*bf2c3715SXin LiXML_PROGRAMLISTING = YES 1500*bf2c3715SXin Li 1501*bf2c3715SXin Li#--------------------------------------------------------------------------- 1502*bf2c3715SXin Li# configuration options for the AutoGen Definitions output 1503*bf2c3715SXin Li#--------------------------------------------------------------------------- 1504*bf2c3715SXin Li 1505*bf2c3715SXin Li# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will 1506*bf2c3715SXin Li# generate an AutoGen Definitions (see autogen.sf.net) file 1507*bf2c3715SXin Li# that captures the structure of the code including all 1508*bf2c3715SXin Li# documentation. Note that this feature is still experimental 1509*bf2c3715SXin Li# and incomplete at the moment. 1510*bf2c3715SXin Li 1511*bf2c3715SXin LiGENERATE_AUTOGEN_DEF = NO 1512*bf2c3715SXin Li 1513*bf2c3715SXin Li#--------------------------------------------------------------------------- 1514*bf2c3715SXin Li# configuration options related to the Perl module output 1515*bf2c3715SXin Li#--------------------------------------------------------------------------- 1516*bf2c3715SXin Li 1517*bf2c3715SXin Li# If the GENERATE_PERLMOD tag is set to YES Doxygen will 1518*bf2c3715SXin Li# generate a Perl module file that captures the structure of 1519*bf2c3715SXin Li# the code including all documentation. Note that this 1520*bf2c3715SXin Li# feature is still experimental and incomplete at the 1521*bf2c3715SXin Li# moment. 1522*bf2c3715SXin Li 1523*bf2c3715SXin LiGENERATE_PERLMOD = NO 1524*bf2c3715SXin Li 1525*bf2c3715SXin Li# If the PERLMOD_LATEX tag is set to YES Doxygen will generate 1526*bf2c3715SXin Li# the necessary Makefile rules, Perl scripts and LaTeX code to be able 1527*bf2c3715SXin Li# to generate PDF and DVI output from the Perl module output. 1528*bf2c3715SXin Li 1529*bf2c3715SXin LiPERLMOD_LATEX = NO 1530*bf2c3715SXin Li 1531*bf2c3715SXin Li# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be 1532*bf2c3715SXin Li# nicely formatted so it can be parsed by a human reader. 1533*bf2c3715SXin Li# This is useful 1534*bf2c3715SXin Li# if you want to understand what is going on. 1535*bf2c3715SXin Li# On the other hand, if this 1536*bf2c3715SXin Li# tag is set to NO the size of the Perl module output will be much smaller 1537*bf2c3715SXin Li# and Perl will parse it just the same. 1538*bf2c3715SXin Li 1539*bf2c3715SXin LiPERLMOD_PRETTY = YES 1540*bf2c3715SXin Li 1541*bf2c3715SXin Li# The names of the make variables in the generated doxyrules.make file 1542*bf2c3715SXin Li# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. 1543*bf2c3715SXin Li# This is useful so different doxyrules.make files included by the same 1544*bf2c3715SXin Li# Makefile don't overwrite each other's variables. 1545*bf2c3715SXin Li 1546*bf2c3715SXin LiPERLMOD_MAKEVAR_PREFIX = 1547*bf2c3715SXin Li 1548*bf2c3715SXin Li#--------------------------------------------------------------------------- 1549*bf2c3715SXin Li# Configuration options related to the preprocessor 1550*bf2c3715SXin Li#--------------------------------------------------------------------------- 1551*bf2c3715SXin Li 1552*bf2c3715SXin Li# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will 1553*bf2c3715SXin Li# evaluate all C-preprocessor directives found in the sources and include 1554*bf2c3715SXin Li# files. 1555*bf2c3715SXin Li 1556*bf2c3715SXin LiENABLE_PREPROCESSING = YES 1557*bf2c3715SXin Li 1558*bf2c3715SXin Li# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro 1559*bf2c3715SXin Li# names in the source code. If set to NO (the default) only conditional 1560*bf2c3715SXin Li# compilation will be performed. Macro expansion can be done in a controlled 1561*bf2c3715SXin Li# way by setting EXPAND_ONLY_PREDEF to YES. 1562*bf2c3715SXin Li 1563*bf2c3715SXin LiMACRO_EXPANSION = YES 1564*bf2c3715SXin Li 1565*bf2c3715SXin Li# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES 1566*bf2c3715SXin Li# then the macro expansion is limited to the macros specified with the 1567*bf2c3715SXin Li# PREDEFINED and EXPAND_AS_DEFINED tags. 1568*bf2c3715SXin Li 1569*bf2c3715SXin LiEXPAND_ONLY_PREDEF = YES 1570*bf2c3715SXin Li 1571*bf2c3715SXin Li# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files 1572*bf2c3715SXin Li# pointed to by INCLUDE_PATH will be searched when a #include is found. 1573*bf2c3715SXin Li 1574*bf2c3715SXin LiSEARCH_INCLUDES = YES 1575*bf2c3715SXin Li 1576*bf2c3715SXin Li# The INCLUDE_PATH tag can be used to specify one or more directories that 1577*bf2c3715SXin Li# contain include files that are not input files but should be processed by 1578*bf2c3715SXin Li# the preprocessor. 1579*bf2c3715SXin Li 1580*bf2c3715SXin LiINCLUDE_PATH = "${Eigen_SOURCE_DIR}/Eigen/src/plugins" 1581*bf2c3715SXin Li 1582*bf2c3715SXin Li# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard 1583*bf2c3715SXin Li# patterns (like *.h and *.hpp) to filter out the header-files in the 1584*bf2c3715SXin Li# directories. If left blank, the patterns specified with FILE_PATTERNS will 1585*bf2c3715SXin Li# be used. 1586*bf2c3715SXin Li 1587*bf2c3715SXin LiINCLUDE_FILE_PATTERNS = 1588*bf2c3715SXin Li 1589*bf2c3715SXin Li# The PREDEFINED tag can be used to specify one or more macro names that 1590*bf2c3715SXin Li# are defined before the preprocessor is started (similar to the -D option of 1591*bf2c3715SXin Li# gcc). The argument of the tag is a list of macros of the form: name 1592*bf2c3715SXin Li# or name=definition (no spaces). If the definition and the = are 1593*bf2c3715SXin Li# omitted =1 is assumed. To prevent a macro definition from being 1594*bf2c3715SXin Li# undefined via #undef or recursively expanded use the := operator 1595*bf2c3715SXin Li# instead of the = operator. 1596*bf2c3715SXin Li 1597*bf2c3715SXin LiPREDEFINED = EIGEN_EMPTY_STRUCT \ 1598*bf2c3715SXin Li EIGEN_PARSED_BY_DOXYGEN \ 1599*bf2c3715SXin Li EIGEN_VECTORIZE \ 1600*bf2c3715SXin Li EIGEN_QT_SUPPORT \ 1601*bf2c3715SXin Li EIGEN_STRONG_INLINE=inline \ 1602*bf2c3715SXin Li EIGEN_DEVICE_FUNC= \ 1603*bf2c3715SXin Li EIGEN_HAS_CXX11=1 \ 1604*bf2c3715SXin Li EIGEN_HAS_CXX11_MATH=1 \ 1605*bf2c3715SXin Li "EIGEN_MAKE_CWISE_BINARY_OP(METHOD,FUNCTOR)=template<typename OtherDerived> const CwiseBinaryOp<FUNCTOR<Scalar>, const Derived, const OtherDerived> METHOD(const EIGEN_CURRENT_STORAGE_BASE_CLASS<OtherDerived> &other) const;" \ 1606*bf2c3715SXin Li "EIGEN_CWISE_PRODUCT_RETURN_TYPE(LHS,RHS)=CwiseBinaryOp<internal::scalar_product_op<LHS::Scalar,RHS::Scalar>, const LHS, const RHS>"\ 1607*bf2c3715SXin Li "EIGEN_CAT2(a,b)= a ## b"\ 1608*bf2c3715SXin Li "EIGEN_CAT(a,b)=EIGEN_CAT2(a,b)"\ 1609*bf2c3715SXin Li "EIGEN_CWISE_BINARY_RETURN_TYPE(LHS,RHS,OPNAME)=CwiseBinaryOp<EIGEN_CAT(EIGEN_CAT(internal::scalar_,OPNAME),_op)<LHS::Scalar, RHS::Scalar>, const LHS, const RHS>"\ 1610*bf2c3715SXin Li "EIGEN_ALIGN_TO_BOUNDARY(x)="\ 1611*bf2c3715SXin Li DOXCOMMA=, 1612*bf2c3715SXin Li 1613*bf2c3715SXin Li 1614*bf2c3715SXin Li# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then 1615*bf2c3715SXin Li# this tag can be used to specify a list of macro names that should be expanded. 1616*bf2c3715SXin Li# The macro definition that is found in the sources will be used. 1617*bf2c3715SXin Li# Use the PREDEFINED tag if you want to use a different macro definition that 1618*bf2c3715SXin Li# overrules the definition found in the source code. 1619*bf2c3715SXin Li 1620*bf2c3715SXin LiEXPAND_AS_DEFINED = EIGEN_MAKE_TYPEDEFS \ 1621*bf2c3715SXin Li EIGEN_MAKE_FIXED_TYPEDEFS \ 1622*bf2c3715SXin Li EIGEN_MAKE_TYPEDEFS_ALL_SIZES \ 1623*bf2c3715SXin Li EIGEN_MAKE_ARRAY_TYPEDEFS \ 1624*bf2c3715SXin Li EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS \ 1625*bf2c3715SXin Li EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES \ 1626*bf2c3715SXin Li EIGEN_CWISE_UNOP_RETURN_TYPE \ 1627*bf2c3715SXin Li EIGEN_CWISE_BINOP_RETURN_TYPE \ 1628*bf2c3715SXin Li EIGEN_CURRENT_STORAGE_BASE_CLASS \ 1629*bf2c3715SXin Li EIGEN_MATHFUNC_IMPL \ 1630*bf2c3715SXin Li _EIGEN_GENERIC_PUBLIC_INTERFACE \ 1631*bf2c3715SXin Li EIGEN_ARRAY_DECLARE_GLOBAL_UNARY \ 1632*bf2c3715SXin Li EIGEN_EMPTY \ 1633*bf2c3715SXin Li EIGEN_EULER_ANGLES_TYPEDEFS \ 1634*bf2c3715SXin Li EIGEN_EULER_ANGLES_SINGLE_TYPEDEF \ 1635*bf2c3715SXin Li EIGEN_EULER_SYSTEM_TYPEDEF \ 1636*bf2c3715SXin Li EIGEN_AUTODIFF_DECLARE_GLOBAL_UNARY \ 1637*bf2c3715SXin Li EIGEN_MATRIX_FUNCTION \ 1638*bf2c3715SXin Li EIGEN_MATRIX_FUNCTION_1 \ 1639*bf2c3715SXin Li EIGEN_DOC_UNARY_ADDONS \ 1640*bf2c3715SXin Li EIGEN_DOC_BLOCK_ADDONS_NOT_INNER_PANEL \ 1641*bf2c3715SXin Li EIGEN_DOC_BLOCK_ADDONS_INNER_PANEL_IF 1642*bf2c3715SXin Li 1643*bf2c3715SXin Li 1644*bf2c3715SXin Li# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then 1645*bf2c3715SXin Li# doxygen's preprocessor will remove all references to function-like macros 1646*bf2c3715SXin Li# that are alone on a line, have an all uppercase name, and do not end with a 1647*bf2c3715SXin Li# semicolon, because these will confuse the parser if not removed. 1648*bf2c3715SXin Li 1649*bf2c3715SXin LiSKIP_FUNCTION_MACROS = YES 1650*bf2c3715SXin Li 1651*bf2c3715SXin Li#--------------------------------------------------------------------------- 1652*bf2c3715SXin Li# Configuration::additions related to external references 1653*bf2c3715SXin Li#--------------------------------------------------------------------------- 1654*bf2c3715SXin Li 1655*bf2c3715SXin Li# The TAGFILES option can be used to specify one or more tagfiles. For each 1656*bf2c3715SXin Li# tag file the location of the external documentation should be added. The 1657*bf2c3715SXin Li# format of a tag file without this location is as follows: 1658*bf2c3715SXin Li# 1659*bf2c3715SXin Li# TAGFILES = file1 file2 ... 1660*bf2c3715SXin Li# Adding location for the tag files is done as follows: 1661*bf2c3715SXin Li# 1662*bf2c3715SXin Li# TAGFILES = file1=loc1 "file2 = loc2" ... 1663*bf2c3715SXin Li# where "loc1" and "loc2" can be relative or absolute paths 1664*bf2c3715SXin Li# or URLs. Note that each tag file must have a unique name (where the name does 1665*bf2c3715SXin Li# NOT include the path). If a tag file is not located in the directory in which 1666*bf2c3715SXin Li# doxygen is run, you must also specify the path to the tagfile here. 1667*bf2c3715SXin Li 1668*bf2c3715SXin LiTAGFILES = ${EIGEN_DOXY_TAGFILES} 1669*bf2c3715SXin Li# "${Eigen_BINARY_DIR}/doc/eigen-unsupported.doxytags =unsupported" 1670*bf2c3715SXin Li 1671*bf2c3715SXin Li# When a file name is specified after GENERATE_TAGFILE, doxygen will create 1672*bf2c3715SXin Li# a tag file that is based on the input files it reads. 1673*bf2c3715SXin Li 1674*bf2c3715SXin LiGENERATE_TAGFILE = "${Eigen_BINARY_DIR}/doc/${EIGEN_DOXY_PROJECT_NAME}.doxytags" 1675*bf2c3715SXin Li 1676*bf2c3715SXin Li# If the ALLEXTERNALS tag is set to YES all external classes will be listed 1677*bf2c3715SXin Li# in the class index. If set to NO only the inherited external classes 1678*bf2c3715SXin Li# will be listed. 1679*bf2c3715SXin Li 1680*bf2c3715SXin LiALLEXTERNALS = NO 1681*bf2c3715SXin Li 1682*bf2c3715SXin Li# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed 1683*bf2c3715SXin Li# in the modules index. If set to NO, only the current project's groups will 1684*bf2c3715SXin Li# be listed. 1685*bf2c3715SXin Li 1686*bf2c3715SXin LiEXTERNAL_GROUPS = NO 1687*bf2c3715SXin Li 1688*bf2c3715SXin Li# The PERL_PATH should be the absolute path and name of the perl script 1689*bf2c3715SXin Li# interpreter (i.e. the result of `which perl'). 1690*bf2c3715SXin Li 1691*bf2c3715SXin LiPERL_PATH = /usr/bin/perl 1692*bf2c3715SXin Li 1693*bf2c3715SXin Li#--------------------------------------------------------------------------- 1694*bf2c3715SXin Li# Configuration options related to the dot tool 1695*bf2c3715SXin Li#--------------------------------------------------------------------------- 1696*bf2c3715SXin Li 1697*bf2c3715SXin Li# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will 1698*bf2c3715SXin Li# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base 1699*bf2c3715SXin Li# or super classes. Setting the tag to NO turns the diagrams off. Note that 1700*bf2c3715SXin Li# this option also works with HAVE_DOT disabled, but it is recommended to 1701*bf2c3715SXin Li# install and use dot, since it yields more powerful graphs. 1702*bf2c3715SXin Li 1703*bf2c3715SXin LiCLASS_DIAGRAMS = YES 1704*bf2c3715SXin Li 1705*bf2c3715SXin Li# You can define message sequence charts within doxygen comments using the \msc 1706*bf2c3715SXin Li# command. Doxygen will then run the mscgen tool (see 1707*bf2c3715SXin Li# http://www.mcternan.me.uk/mscgen/) to produce the chart and insert it in the 1708*bf2c3715SXin Li# documentation. The MSCGEN_PATH tag allows you to specify the directory where 1709*bf2c3715SXin Li# the mscgen tool resides. If left empty the tool is assumed to be found in the 1710*bf2c3715SXin Li# default search path. 1711*bf2c3715SXin Li 1712*bf2c3715SXin LiMSCGEN_PATH = 1713*bf2c3715SXin Li 1714*bf2c3715SXin Li# If set to YES, the inheritance and collaboration graphs will hide 1715*bf2c3715SXin Li# inheritance and usage relations if the target is undocumented 1716*bf2c3715SXin Li# or is not a class. 1717*bf2c3715SXin Li 1718*bf2c3715SXin LiHIDE_UNDOC_RELATIONS = NO 1719*bf2c3715SXin Li 1720*bf2c3715SXin Li# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is 1721*bf2c3715SXin Li# available from the path. This tool is part of Graphviz, a graph visualization 1722*bf2c3715SXin Li# toolkit from AT&T and Lucent Bell Labs. The other options in this section 1723*bf2c3715SXin Li# have no effect if this option is set to NO (the default) 1724*bf2c3715SXin Li 1725*bf2c3715SXin LiHAVE_DOT = YES 1726*bf2c3715SXin Li 1727*bf2c3715SXin Li# The DOT_NUM_THREADS specifies the number of dot invocations doxygen is 1728*bf2c3715SXin Li# allowed to run in parallel. When set to 0 (the default) doxygen will 1729*bf2c3715SXin Li# base this on the number of processors available in the system. You can set it 1730*bf2c3715SXin Li# explicitly to a value larger than 0 to get control over the balance 1731*bf2c3715SXin Li# between CPU load and processing speed. 1732*bf2c3715SXin Li 1733*bf2c3715SXin LiDOT_NUM_THREADS = 0 1734*bf2c3715SXin Li 1735*bf2c3715SXin Li# By default doxygen will use the Helvetica font for all dot files that 1736*bf2c3715SXin Li# doxygen generates. When you want a differently looking font you can specify 1737*bf2c3715SXin Li# the font name using DOT_FONTNAME. You need to make sure dot is able to find 1738*bf2c3715SXin Li# the font, which can be done by putting it in a standard location or by setting 1739*bf2c3715SXin Li# the DOTFONTPATH environment variable or by setting DOT_FONTPATH to the 1740*bf2c3715SXin Li# directory containing the font. 1741*bf2c3715SXin Li 1742*bf2c3715SXin LiDOT_FONTNAME = 1743*bf2c3715SXin Li 1744*bf2c3715SXin Li# The DOT_FONTSIZE tag can be used to set the size of the font of dot graphs. 1745*bf2c3715SXin Li# The default size is 10pt. 1746*bf2c3715SXin Li 1747*bf2c3715SXin LiDOT_FONTSIZE = 10 1748*bf2c3715SXin Li 1749*bf2c3715SXin Li# By default doxygen will tell dot to use the Helvetica font. 1750*bf2c3715SXin Li# If you specify a different font using DOT_FONTNAME you can use DOT_FONTPATH to 1751*bf2c3715SXin Li# set the path where dot can find it. 1752*bf2c3715SXin Li 1753*bf2c3715SXin LiDOT_FONTPATH = 1754*bf2c3715SXin Li 1755*bf2c3715SXin Li# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen 1756*bf2c3715SXin Li# will generate a graph for each documented class showing the direct and 1757*bf2c3715SXin Li# indirect inheritance relations. Setting this tag to YES will force the 1758*bf2c3715SXin Li# CLASS_DIAGRAMS tag to NO. 1759*bf2c3715SXin Li 1760*bf2c3715SXin LiCLASS_GRAPH = YES 1761*bf2c3715SXin Li 1762*bf2c3715SXin Li# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen 1763*bf2c3715SXin Li# will generate a graph for each documented class showing the direct and 1764*bf2c3715SXin Li# indirect implementation dependencies (inheritance, containment, and 1765*bf2c3715SXin Li# class references variables) of the class with other documented classes. 1766*bf2c3715SXin Li 1767*bf2c3715SXin LiCOLLABORATION_GRAPH = NO 1768*bf2c3715SXin Li 1769*bf2c3715SXin Li# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen 1770*bf2c3715SXin Li# will generate a graph for groups, showing the direct groups dependencies 1771*bf2c3715SXin Li 1772*bf2c3715SXin LiGROUP_GRAPHS = NO 1773*bf2c3715SXin Li 1774*bf2c3715SXin Li# If the UML_LOOK tag is set to YES doxygen will generate inheritance and 1775*bf2c3715SXin Li# collaboration diagrams in a style similar to the OMG's Unified Modeling 1776*bf2c3715SXin Li# Language. 1777*bf2c3715SXin Li 1778*bf2c3715SXin LiUML_LOOK = YES 1779*bf2c3715SXin Li 1780*bf2c3715SXin Li# If the UML_LOOK tag is enabled, the fields and methods are shown inside 1781*bf2c3715SXin Li# the class node. If there are many fields or methods and many nodes the 1782*bf2c3715SXin Li# graph may become too big to be useful. The UML_LIMIT_NUM_FIELDS 1783*bf2c3715SXin Li# threshold limits the number of items for each type to make the size more 1784*bf2c3715SXin Li# manageable. Set this to 0 for no limit. Note that the threshold may be 1785*bf2c3715SXin Li# exceeded by 50% before the limit is enforced. 1786*bf2c3715SXin Li 1787*bf2c3715SXin LiUML_LIMIT_NUM_FIELDS = 10 1788*bf2c3715SXin Li 1789*bf2c3715SXin Li# If set to YES, the inheritance and collaboration graphs will show the 1790*bf2c3715SXin Li# relations between templates and their instances. 1791*bf2c3715SXin Li 1792*bf2c3715SXin LiTEMPLATE_RELATIONS = NO 1793*bf2c3715SXin Li 1794*bf2c3715SXin Li# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT 1795*bf2c3715SXin Li# tags are set to YES then doxygen will generate a graph for each documented 1796*bf2c3715SXin Li# file showing the direct and indirect include dependencies of the file with 1797*bf2c3715SXin Li# other documented files. 1798*bf2c3715SXin Li 1799*bf2c3715SXin LiINCLUDE_GRAPH = NO 1800*bf2c3715SXin Li 1801*bf2c3715SXin Li# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and 1802*bf2c3715SXin Li# HAVE_DOT tags are set to YES then doxygen will generate a graph for each 1803*bf2c3715SXin Li# documented header file showing the documented files that directly or 1804*bf2c3715SXin Li# indirectly include this file. 1805*bf2c3715SXin Li 1806*bf2c3715SXin LiINCLUDED_BY_GRAPH = NO 1807*bf2c3715SXin Li 1808*bf2c3715SXin Li# If the CALL_GRAPH and HAVE_DOT options are set to YES then 1809*bf2c3715SXin Li# doxygen will generate a call dependency graph for every global function 1810*bf2c3715SXin Li# or class method. Note that enabling this option will significantly increase 1811*bf2c3715SXin Li# the time of a run. So in most cases it will be better to enable call graphs 1812*bf2c3715SXin Li# for selected functions only using the \callgraph command. 1813*bf2c3715SXin Li 1814*bf2c3715SXin LiCALL_GRAPH = NO 1815*bf2c3715SXin Li 1816*bf2c3715SXin Li# If the CALLER_GRAPH and HAVE_DOT tags are set to YES then 1817*bf2c3715SXin Li# doxygen will generate a caller dependency graph for every global function 1818*bf2c3715SXin Li# or class method. Note that enabling this option will significantly increase 1819*bf2c3715SXin Li# the time of a run. So in most cases it will be better to enable caller 1820*bf2c3715SXin Li# graphs for selected functions only using the \callergraph command. 1821*bf2c3715SXin Li 1822*bf2c3715SXin LiCALLER_GRAPH = NO 1823*bf2c3715SXin Li 1824*bf2c3715SXin Li# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen 1825*bf2c3715SXin Li# will generate a graphical hierarchy of all classes instead of a textual one. 1826*bf2c3715SXin Li 1827*bf2c3715SXin LiGRAPHICAL_HIERARCHY = NO 1828*bf2c3715SXin Li 1829*bf2c3715SXin Li# If the DIRECTORY_GRAPH and HAVE_DOT tags are set to YES 1830*bf2c3715SXin Li# then doxygen will show the dependencies a directory has on other directories 1831*bf2c3715SXin Li# in a graphical way. The dependency relations are determined by the #include 1832*bf2c3715SXin Li# relations between the files in the directories. 1833*bf2c3715SXin Li 1834*bf2c3715SXin LiDIRECTORY_GRAPH = NO 1835*bf2c3715SXin Li 1836*bf2c3715SXin Li# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images 1837*bf2c3715SXin Li# generated by dot. Possible values are svg, png, jpg, or gif. 1838*bf2c3715SXin Li# If left blank png will be used. If you choose svg you need to set 1839*bf2c3715SXin Li# HTML_FILE_EXTENSION to xhtml in order to make the SVG files 1840*bf2c3715SXin Li# visible in IE 9+ (other browsers do not have this requirement). 1841*bf2c3715SXin Li 1842*bf2c3715SXin LiDOT_IMAGE_FORMAT = png 1843*bf2c3715SXin Li 1844*bf2c3715SXin Li# If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to 1845*bf2c3715SXin Li# enable generation of interactive SVG images that allow zooming and panning. 1846*bf2c3715SXin Li# Note that this requires a modern browser other than Internet Explorer. 1847*bf2c3715SXin Li# Tested and working are Firefox, Chrome, Safari, and Opera. For IE 9+ you 1848*bf2c3715SXin Li# need to set HTML_FILE_EXTENSION to xhtml in order to make the SVG files 1849*bf2c3715SXin Li# visible. Older versions of IE do not have SVG support. 1850*bf2c3715SXin Li 1851*bf2c3715SXin LiINTERACTIVE_SVG = NO 1852*bf2c3715SXin Li 1853*bf2c3715SXin Li# The tag DOT_PATH can be used to specify the path where the dot tool can be 1854*bf2c3715SXin Li# found. If left blank, it is assumed the dot tool can be found in the path. 1855*bf2c3715SXin Li 1856*bf2c3715SXin LiDOT_PATH = 1857*bf2c3715SXin Li 1858*bf2c3715SXin Li# The DOTFILE_DIRS tag can be used to specify one or more directories that 1859*bf2c3715SXin Li# contain dot files that are included in the documentation (see the 1860*bf2c3715SXin Li# \dotfile command). 1861*bf2c3715SXin Li 1862*bf2c3715SXin LiDOTFILE_DIRS = 1863*bf2c3715SXin Li 1864*bf2c3715SXin Li# The MSCFILE_DIRS tag can be used to specify one or more directories that 1865*bf2c3715SXin Li# contain msc files that are included in the documentation (see the 1866*bf2c3715SXin Li# \mscfile command). 1867*bf2c3715SXin Li 1868*bf2c3715SXin LiMSCFILE_DIRS = 1869*bf2c3715SXin Li 1870*bf2c3715SXin Li# The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of 1871*bf2c3715SXin Li# nodes that will be shown in the graph. If the number of nodes in a graph 1872*bf2c3715SXin Li# becomes larger than this value, doxygen will truncate the graph, which is 1873*bf2c3715SXin Li# visualized by representing a node as a red box. Note that doxygen if the 1874*bf2c3715SXin Li# number of direct children of the root node in a graph is already larger than 1875*bf2c3715SXin Li# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note 1876*bf2c3715SXin Li# that the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH. 1877*bf2c3715SXin Li 1878*bf2c3715SXin LiDOT_GRAPH_MAX_NODES = 50 1879*bf2c3715SXin Li 1880*bf2c3715SXin Li# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the 1881*bf2c3715SXin Li# graphs generated by dot. A depth value of 3 means that only nodes reachable 1882*bf2c3715SXin Li# from the root by following a path via at most 3 edges will be shown. Nodes 1883*bf2c3715SXin Li# that lay further from the root node will be omitted. Note that setting this 1884*bf2c3715SXin Li# option to 1 or 2 may greatly reduce the computation time needed for large 1885*bf2c3715SXin Li# code bases. Also note that the size of a graph can be further restricted by 1886*bf2c3715SXin Li# DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction. 1887*bf2c3715SXin Li 1888*bf2c3715SXin LiMAX_DOT_GRAPH_DEPTH = 0 1889*bf2c3715SXin Li 1890*bf2c3715SXin Li# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent 1891*bf2c3715SXin Li# background. This is disabled by default, because dot on Windows does not 1892*bf2c3715SXin Li# seem to support this out of the box. Warning: Depending on the platform used, 1893*bf2c3715SXin Li# enabling this option may lead to badly anti-aliased labels on the edges of 1894*bf2c3715SXin Li# a graph (i.e. they become hard to read). 1895*bf2c3715SXin Li 1896*bf2c3715SXin LiDOT_TRANSPARENT = NO 1897*bf2c3715SXin Li 1898*bf2c3715SXin Li# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output 1899*bf2c3715SXin Li# files in one run (i.e. multiple -o and -T options on the command line). This 1900*bf2c3715SXin Li# makes dot run faster, but since only newer versions of dot (>1.8.10) 1901*bf2c3715SXin Li# support this, this feature is disabled by default. 1902*bf2c3715SXin Li 1903*bf2c3715SXin LiDOT_MULTI_TARGETS = NO 1904*bf2c3715SXin Li 1905*bf2c3715SXin Li# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will 1906*bf2c3715SXin Li# generate a legend page explaining the meaning of the various boxes and 1907*bf2c3715SXin Li# arrows in the dot generated graphs. 1908*bf2c3715SXin Li 1909*bf2c3715SXin LiGENERATE_LEGEND = YES 1910*bf2c3715SXin Li 1911*bf2c3715SXin Li# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will 1912*bf2c3715SXin Li# remove the intermediate dot files that are used to generate 1913*bf2c3715SXin Li# the various graphs. 1914*bf2c3715SXin Li 1915*bf2c3715SXin LiDOT_CLEANUP = YES 1916