<divclass="line"><aname="l00003"></a><spanclass="lineno"> 3</span> <spanclass="preprocessor"># This file describes the settings to be used by the documentation system</span></div>
<divclass="line"><aname="l00004"></a><spanclass="lineno"> 4</span> <spanclass="preprocessor"># doxygen (www.doxygen.org) for a project.</span></div>
<divclass="line"><aname="l00006"></a><spanclass="lineno"> 6</span> <spanclass="preprocessor"># All text after a double hash (##) is considered a comment and is placed in</span></div>
<divclass="line"><aname="l00007"></a><spanclass="lineno"> 7</span> <spanclass="preprocessor"># front of the TAG it is preceding.</span></div>
<divclass="line"><aname="l00009"></a><spanclass="lineno"> 9</span> <spanclass="preprocessor"># All text after a single hash (#) is considered a comment and will be ignored.</span></div>
<divclass="line"><aname="l00010"></a><spanclass="lineno"> 10</span> <spanclass="preprocessor"># The format is:</span></div>
<divclass="line"><aname="l00011"></a><spanclass="lineno"> 11</span> <spanclass="preprocessor"># TAG = value [value, ...]</span></div>
<divclass="line"><aname="l00012"></a><spanclass="lineno"> 12</span> <spanclass="preprocessor"># For lists, items can also be appended using:</span></div>
<divclass="line"><aname="l00013"></a><spanclass="lineno"> 13</span> <spanclass="preprocessor"># TAG += value [value, ...]</span></div>
<divclass="line"><aname="l00014"></a><spanclass="lineno"> 14</span> <spanclass="preprocessor"># Values that contain spaces should be placed between quotes (\" \").</span></div>
<divclass="line"><aname="l00020"></a><spanclass="lineno"> 20</span> <spanclass="preprocessor"># This tag specifies the encoding used for all characters in the config file</span></div>
<divclass="line"><aname="l00021"></a><spanclass="lineno"> 21</span> <spanclass="preprocessor"># that follow. The default is UTF-8 which is also the encoding used for all text</span></div>
<divclass="line"><aname="l00022"></a><spanclass="lineno"> 22</span> <spanclass="preprocessor"># before the first occurrence of this tag. Doxygen uses libiconv (or the iconv</span></div>
<divclass="line"><aname="l00023"></a><spanclass="lineno"> 23</span> <spanclass="preprocessor"># built into libc) for the transcoding. See http://www.gnu.org/software/libiconv</span></div>
<divclass="line"><aname="l00024"></a><spanclass="lineno"> 24</span> <spanclass="preprocessor"># for the list of possible encodings.</span></div>
<divclass="line"><aname="l00025"></a><spanclass="lineno"> 25</span> <spanclass="preprocessor"># The default value is: UTF-8.</span></div>
<divclass="line"><aname="l00029"></a><spanclass="lineno"> 29</span> <spanclass="preprocessor"># The PROJECT_NAME tag is a single word (or a sequence of words surrounded by</span></div>
<divclass="line"><aname="l00030"></a><spanclass="lineno"> 30</span> <spanclass="preprocessor"># double-quotes, unless you are using Doxywizard) that should identify the</span></div>
<divclass="line"><aname="l00031"></a><spanclass="lineno"> 31</span> <spanclass="preprocessor"># project for which the documentation is generated. This name is used in the</span></div>
<divclass="line"><aname="l00032"></a><spanclass="lineno"> 32</span> <spanclass="preprocessor"># title of most generated pages and in a few other places.</span></div>
<divclass="line"><aname="l00033"></a><spanclass="lineno"> 33</span> <spanclass="preprocessor"># The default value is: My Project.</span></div>
<divclass="line"><aname="l00037"></a><spanclass="lineno"> 37</span> <spanclass="preprocessor"># The PROJECT_NUMBER tag can be used to enter a project or revision number. This</span></div>
<divclass="line"><aname="l00038"></a><spanclass="lineno"> 38</span> <spanclass="preprocessor"># could be handy for archiving the generated documentation or if some version</span></div>
<divclass="line"><aname="l00039"></a><spanclass="lineno"> 39</span> <spanclass="preprocessor"># control system is used.</span></div>
<divclass="line"><aname="l00043"></a><spanclass="lineno"> 43</span> <spanclass="preprocessor"># Using the PROJECT_BRIEF tag one can provide an optional one line description</span></div>
<divclass="line"><aname="l00044"></a><spanclass="lineno"> 44</span> <spanclass="preprocessor"># for a project that appears at the top of each page and should give viewer a</span></div>
<divclass="line"><aname="l00045"></a><spanclass="lineno"> 45</span> <spanclass="preprocessor"># quick idea about the purpose of the project. Keep the description short.</span></div>
<divclass="line"><aname="l00049"></a><spanclass="lineno"> 49</span> <spanclass="preprocessor"># With the PROJECT_LOGO tag one can specify a logo or an icon that is included</span></div>
<divclass="line"><aname="l00050"></a><spanclass="lineno"> 50</span> <spanclass="preprocessor"># in the documentation. The maximum height of the logo should not exceed 55</span></div>
<divclass="line"><aname="l00051"></a><spanclass="lineno"> 51</span> <spanclass="preprocessor"># pixels and the maximum width should not exceed 200 pixels. Doxygen will copy</span></div>
<divclass="line"><aname="l00052"></a><spanclass="lineno"> 52</span> <spanclass="preprocessor"># the logo to the output directory.</span></div>
<divclass="line"><aname="l00056"></a><spanclass="lineno"> 56</span> <spanclass="preprocessor"># The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path</span></div>
<divclass="line"><aname="l00057"></a><spanclass="lineno"> 57</span> <spanclass="preprocessor"># into which the generated documentation will be written. If a relative path is</span></div>
<divclass="line"><aname="l00058"></a><spanclass="lineno"> 58</span> <spanclass="preprocessor"># entered, it will be relative to the location where doxygen was started. If</span></div>
<divclass="line"><aname="l00059"></a><spanclass="lineno"> 59</span> <spanclass="preprocessor"># left blank the current directory will be used.</span></div>
<divclass="line"><aname="l00063"></a><spanclass="lineno"> 63</span> # If the CREATE_SUBDIRS tag is set to YES then doxygen will create 4096 sub-</div>
<divclass="line"><aname="l00064"></a><spanclass="lineno"> 64</span> <spanclass="preprocessor"># directories (in 2 levels) under the output directory of each output format and</span></div>
<divclass="line"><aname="l00065"></a><spanclass="lineno"> 65</span> <spanclass="preprocessor"># will distribute the generated files over these directories. Enabling this</span></div>
<divclass="line"><aname="l00066"></a><spanclass="lineno"> 66</span> <spanclass="preprocessor"># option can be useful when feeding doxygen a huge amount of source files, where</span></div>
<divclass="line"><aname="l00067"></a><spanclass="lineno"> 67</span> <spanclass="preprocessor"># putting all generated files in the same directory would otherwise causes</span></div>
<divclass="line"><aname="l00068"></a><spanclass="lineno"> 68</span> <spanclass="preprocessor"># performance problems for the file system.</span></div>
<divclass="line"><aname="l00069"></a><spanclass="lineno"> 69</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00073"></a><spanclass="lineno"> 73</span> <spanclass="preprocessor"># If the ALLOW_UNICODE_NAMES tag is set to YES, doxygen will allow non-ASCII</span></div>
<divclass="line"><aname="l00074"></a><spanclass="lineno"> 74</span> <spanclass="preprocessor"># characters to appear in the names of generated files. If set to NO, non-ASCII</span></div>
<divclass="line"><aname="l00075"></a><spanclass="lineno"> 75</span> <spanclass="preprocessor"># characters will be escaped, for example _xE3_x81_x84 will be used for Unicode</span></div>
<divclass="line"><aname="l00081"></a><spanclass="lineno"> 81</span> <spanclass="preprocessor"># The OUTPUT_LANGUAGE tag is used to specify the language in which all</span></div>
<divclass="line"><aname="l00082"></a><spanclass="lineno"> 82</span> <spanclass="preprocessor"># documentation generated by doxygen is written. Doxygen will use this</span></div>
<divclass="line"><aname="l00083"></a><spanclass="lineno"> 83</span> <spanclass="preprocessor"># information to generate all constant output in the proper language.</span></div>
<divclass="line"><aname="l00087"></a><spanclass="lineno"> 87</span> <spanclass="preprocessor"># Indonesian, Italian, Japanese, Japanese-en (Japanese with English messages),</span></div>
<divclass="line"><aname="l00088"></a><spanclass="lineno"> 88</span> <spanclass="preprocessor"># Korean, Korean-en (Korean with English messages), Latvian, Lithuanian,</span></div>
<divclass="line"><aname="l00089"></a><spanclass="lineno"> 89</span> <spanclass="preprocessor"># Macedonian, Norwegian, Persian (Farsi), Polish, Portuguese, Romanian, Russian,</span></div>
<divclass="line"><aname="l00096"></a><spanclass="lineno"> 96</span> <spanclass="preprocessor"># If the BRIEF_MEMBER_DESC tag is set to YES, doxygen will include brief member</span></div>
<divclass="line"><aname="l00097"></a><spanclass="lineno"> 97</span> <spanclass="preprocessor"># descriptions after the members that are listed in the file and class</span></div>
<divclass="line"><aname="l00098"></a><spanclass="lineno"> 98</span> <spanclass="preprocessor"># documentation (similar to Javadoc). Set to NO to disable this.</span></div>
<divclass="line"><aname="l00099"></a><spanclass="lineno"> 99</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00103"></a><spanclass="lineno"> 103</span> <spanclass="preprocessor"># If the REPEAT_BRIEF tag is set to YES, doxygen will prepend the brief</span></div>
<divclass="line"><aname="l00104"></a><spanclass="lineno"> 104</span> <spanclass="preprocessor"># description of a member or function before the detailed description</span></div>
<divclass="line"><aname="l00106"></a><spanclass="lineno"> 106</span> <spanclass="preprocessor"># Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the</span></div>
<divclass="line"><aname="l00107"></a><spanclass="lineno"> 107</span> <spanclass="preprocessor"># brief descriptions will be completely suppressed.</span></div>
<divclass="line"><aname="l00108"></a><spanclass="lineno"> 108</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00112"></a><spanclass="lineno"> 112</span> <spanclass="preprocessor"># This tag implements a quasi-intelligent brief description abbreviator that is</span></div>
<divclass="line"><aname="l00113"></a><spanclass="lineno"> 113</span> <spanclass="preprocessor"># used to form the text in various listings. Each string in this list, if found</span></div>
<divclass="line"><aname="l00114"></a><spanclass="lineno"> 114</span> <spanclass="preprocessor"># as the leading text of the brief description, will be stripped from the text</span></div>
<divclass="line"><aname="l00115"></a><spanclass="lineno"> 115</span> <spanclass="preprocessor"># and the result, after processing the whole list, is used as the annotated</span></div>
<divclass="line"><aname="l00116"></a><spanclass="lineno"> 116</span> <spanclass="preprocessor"># text. Otherwise, the brief description is used as-is. If left blank, the</span></div>
<divclass="line"><aname="l00117"></a><spanclass="lineno"> 117</span> <spanclass="preprocessor"># following values are used ($name is automatically replaced with the name of</span></div>
<divclass="line"><aname="l00118"></a><spanclass="lineno"> 118</span> <spanclass="preprocessor"># the entity):The $name class, The $name widget, The $name file, is, provides,</span></div>
<divclass="line"><aname="l00119"></a><spanclass="lineno"> 119</span> <spanclass="preprocessor"># specifies, contains, represents, a, an and the.</span></div>
<divclass="line"><aname="l00133"></a><spanclass="lineno"> 133</span> <spanclass="preprocessor"># If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then</span></div>
<divclass="line"><aname="l00134"></a><spanclass="lineno"> 134</span> <spanclass="preprocessor"># doxygen will generate a detailed section even if there is only a brief</span></div>
<divclass="line"><aname="l00140"></a><spanclass="lineno"> 140</span> <spanclass="preprocessor"># If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all</span></div>
<divclass="line"><aname="l00141"></a><spanclass="lineno"> 141</span> <spanclass="preprocessor"># inherited members of a class in the documentation of that class as if those</span></div>
<divclass="line"><aname="l00142"></a><spanclass="lineno"> 142</span> <spanclass="preprocessor"># members were ordinary class members. Constructors, destructors and assignment</span></div>
<divclass="line"><aname="l00143"></a><spanclass="lineno"> 143</span> <spanclass="preprocessor"># operators of the base classes will not be shown.</span></div>
<divclass="line"><aname="l00144"></a><spanclass="lineno"> 144</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00148"></a><spanclass="lineno"> 148</span> <spanclass="preprocessor"># If the FULL_PATH_NAMES tag is set to YES, doxygen will prepend the full path</span></div>
<divclass="line"><aname="l00149"></a><spanclass="lineno"> 149</span> <spanclass="preprocessor"># before files name in the file list and in the header files. If set to NO the</span></div>
<divclass="line"><aname="l00150"></a><spanclass="lineno"> 150</span> <spanclass="preprocessor"># shortest path that makes the file name unique will be used</span></div>
<divclass="line"><aname="l00151"></a><spanclass="lineno"> 151</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00155"></a><spanclass="lineno"> 155</span> <spanclass="preprocessor"># The STRIP_FROM_PATH tag can be used to strip a user-defined part of the path.</span></div>
<divclass="line"><aname="l00156"></a><spanclass="lineno"> 156</span> <spanclass="preprocessor"># Stripping is only done if one of the specified strings matches the left-hand</span></div>
<divclass="line"><aname="l00157"></a><spanclass="lineno"> 157</span> <spanclass="preprocessor"># part of the path. The tag can be used to show relative paths in the file list.</span></div>
<divclass="line"><aname="l00158"></a><spanclass="lineno"> 158</span> <spanclass="preprocessor"># If left blank the directory from which doxygen is run is used as the path to</span></div>
<divclass="line"><aname="l00161"></a><spanclass="lineno"> 161</span> <spanclass="preprocessor"># Note that you can specify absolute paths here, but also relative paths, which</span></div>
<divclass="line"><aname="l00162"></a><spanclass="lineno"> 162</span> <spanclass="preprocessor"># will be relative from the directory where doxygen is started.</span></div>
<divclass="line"><aname="l00163"></a><spanclass="lineno"> 163</span> <spanclass="preprocessor"># This tag requires that the tag FULL_PATH_NAMES is set to YES.</span></div>
<divclass="line"><aname="l00167"></a><spanclass="lineno"> 167</span> <spanclass="preprocessor"># The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of the</span></div>
<divclass="line"><aname="l00168"></a><spanclass="lineno"> 168</span> <spanclass="preprocessor"># path mentioned in the documentation of a class, which tells the reader which</span></div>
<divclass="line"><aname="l00169"></a><spanclass="lineno"> 169</span> <spanclass="preprocessor"># header file to include in order to use a class. If left blank only the name of</span></div>
<divclass="line"><aname="l00170"></a><spanclass="lineno"> 170</span> <spanclass="preprocessor"># the header file containing the class definition is used. Otherwise one should</span></div>
<divclass="line"><aname="l00171"></a><spanclass="lineno"> 171</span> <spanclass="preprocessor"># specify the list of include paths that are normally passed to the compiler</span></div>
<divclass="line"><aname="l00172"></a><spanclass="lineno"> 172</span> <spanclass="preprocessor"># using the -I flag.</span></div>
<divclass="line"><aname="l00176"></a><spanclass="lineno"> 176</span> <spanclass="preprocessor"># If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter (but</span></div>
<divclass="line"><aname="l00177"></a><spanclass="lineno"> 177</span> <spanclass="preprocessor"># less readable) file names. This can be useful is your file systems doesn't</span></div>
<divclass="line"><aname="l00178"></a><spanclass="lineno"> 178</span> <spanclass="preprocessor"># support long names like on DOS, Mac, or CD-ROM.</span></div>
<divclass="line"><aname="l00179"></a><spanclass="lineno"> 179</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00183"></a><spanclass="lineno"> 183</span> <spanclass="preprocessor"># If the JAVADOC_AUTOBRIEF tag is set to YES then doxygen will interpret the</span></div>
<divclass="line"><aname="l00184"></a><spanclass="lineno"> 184</span> <spanclass="preprocessor"># first line (until the first dot) of a Javadoc-style comment as the brief</span></div>
<divclass="line"><aname="l00185"></a><spanclass="lineno"> 185</span> <spanclass="preprocessor"># description. If set to NO, the Javadoc-style will behave just like regular Qt-</span></div>
<divclass="line"><aname="l00186"></a><spanclass="lineno"> 186</span> <spanclass="preprocessor"># style comments (thus requiring an explicit @brief command for a brief</span></div>
<divclass="line"><aname="l00192"></a><spanclass="lineno"> 192</span> <spanclass="preprocessor"># If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first</span></div>
<divclass="line"><aname="l00193"></a><spanclass="lineno"> 193</span> <spanclass="preprocessor"># line (until the first dot) of a Qt-style comment as the brief description. If</span></div>
<divclass="line"><aname="l00194"></a><spanclass="lineno"> 194</span> <spanclass="preprocessor"># set to NO, the Qt-style will behave just like regular Qt-style comments (thus</span></div>
<divclass="line"><aname="l00195"></a><spanclass="lineno"> 195</span> <spanclass="preprocessor"># requiring an explicit \brief command for a brief description.)</span></div>
<divclass="line"><aname="l00196"></a><spanclass="lineno"> 196</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00200"></a><spanclass="lineno"> 200</span> <spanclass="preprocessor"># The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make doxygen treat a</span></div>
<divclass="line"><aname="l00201"></a><spanclass="lineno"> 201</span> <spanclass="preprocessor"># multi-line C++ special comment block (i.e. a block of </span></div>
<divclass="line"><aname="l00202"></a><spanclass="lineno"> 202</span> <spanclass="preprocessor"># a brief description. This used to be the default behavior. The new default is</span></div>
<divclass="line"><aname="l00203"></a><spanclass="lineno"> 203</span> <spanclass="preprocessor"># to treat a multi-line C++ comment block as a detailed description. Set this</span></div>
<divclass="line"><aname="l00204"></a><spanclass="lineno"> 204</span> <spanclass="preprocessor"># tag to YES if you prefer the old behavior instead.</span></div>
<divclass="line"><aname="l00206"></a><spanclass="lineno"> 206</span> <spanclass="preprocessor"># Note that setting this tag to YES also means that rational rose comments are</span></div>
<divclass="line"><aname="l00207"></a><spanclass="lineno"> 207</span> <spanclass="preprocessor"># not recognized any more.</span></div>
<divclass="line"><aname="l00208"></a><spanclass="lineno"> 208</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00212"></a><spanclass="lineno"> 212</span> <spanclass="preprocessor"># If the INHERIT_DOCS tag is set to YES then an undocumented member inherits the</span></div>
<divclass="line"><aname="l00213"></a><spanclass="lineno"> 213</span> <spanclass="preprocessor"># documentation from any documented member that it re-implements.</span></div>
<divclass="line"><aname="l00214"></a><spanclass="lineno"> 214</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00218"></a><spanclass="lineno"> 218</span> <spanclass="preprocessor"># If the SEPARATE_MEMBER_PAGES tag is set to YES then doxygen will produce a new</span></div>
<divclass="line"><aname="l00219"></a><spanclass="lineno"> 219</span> <spanclass="preprocessor"># page for each member. If set to NO, the documentation of a member will be part</span></div>
<divclass="line"><aname="l00220"></a><spanclass="lineno"> 220</span> <spanclass="preprocessor"># of the file/class/namespace that contains it.</span></div>
<divclass="line"><aname="l00221"></a><spanclass="lineno"> 221</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00225"></a><spanclass="lineno"> 225</span> <spanclass="preprocessor"># The TAB_SIZE tag can be used to set the number of spaces in a tab. Doxygen</span></div>
<divclass="line"><aname="l00226"></a><spanclass="lineno"> 226</span> <spanclass="preprocessor"># uses this value to replace tabs by spaces in code fragments.</span></div>
<divclass="line"><aname="l00231"></a><spanclass="lineno"> 231</span> <spanclass="preprocessor"># This tag can be used to specify a number of aliases that act as commands in</span></div>
<divclass="line"><aname="l00232"></a><spanclass="lineno"> 232</span> <spanclass="preprocessor"># the documentation. An alias has the form:</span></div>
<divclass="line"><aname="l00234"></a><spanclass="lineno"> 234</span> <spanclass="preprocessor"># For example adding</span></div>
<divclass="line"><aname="l00235"></a><spanclass="lineno"> 235</span> <spanclass="preprocessor"># "sideeffect=@par Side Effects:\n"</span></div>
<divclass="line"><aname="l00236"></a><spanclass="lineno"> 236</span> <spanclass="preprocessor"># will allow you to put the command \sideeffect (or @sideeffect) in the</span></div>
<divclass="line"><aname="l00237"></a><spanclass="lineno"> 237</span> <spanclass="preprocessor"># documentation, which will result in a user-defined paragraph with heading</span></div>
<divclass="line"><aname="l00238"></a><spanclass="lineno"> 238</span> <spanclass="preprocessor"># "Side Effects:". You can put \n's in the value part of an alias to insert</span></div>
<divclass="line"><aname="l00243"></a><spanclass="lineno"> 243</span> <spanclass="preprocessor"># This tag can be used to specify a number of word-keyword mappings (TCL only).</span></div>
<divclass="line"><aname="l00244"></a><spanclass="lineno"> 244</span> <spanclass="preprocessor"># A mapping has the form "name=value". For example adding "class=itcl::class"</span></div>
<divclass="line"><aname="l00245"></a><spanclass="lineno"> 245</span> <spanclass="preprocessor"># will allow you to use the command class in the itcl::class meaning.</span></div>
<divclass="line"><aname="l00249"></a><spanclass="lineno"> 249</span> <spanclass="preprocessor"># Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C sources</span></div>
<divclass="line"><aname="l00250"></a><spanclass="lineno"> 250</span> <spanclass="preprocessor"># only. Doxygen will then generate output that is more tailored for C. For</span></div>
<divclass="line"><aname="l00251"></a><spanclass="lineno"> 251</span> <spanclass="preprocessor"># instance, some of the names that are used will be different. The list of all</span></div>
<divclass="line"><aname="l00252"></a><spanclass="lineno"> 252</span> <spanclass="preprocessor"># members will be omitted, etc.</span></div>
<divclass="line"><aname="l00253"></a><spanclass="lineno"> 253</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00257"></a><spanclass="lineno"> 257</span> <spanclass="preprocessor"># Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java or</span></div>
<divclass="line"><aname="l00258"></a><spanclass="lineno"> 258</span> <spanclass="preprocessor"># Python sources only. Doxygen will then generate output that is more tailored</span></div>
<divclass="line"><aname="l00259"></a><spanclass="lineno"> 259</span> <spanclass="preprocessor"># for that language. For instance, namespaces will be presented as packages,</span></div>
<divclass="line"><aname="l00260"></a><spanclass="lineno"> 260</span> <spanclass="preprocessor"># qualified scopes will look different, etc.</span></div>
<divclass="line"><aname="l00261"></a><spanclass="lineno"> 261</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00265"></a><spanclass="lineno"> 265</span> <spanclass="preprocessor"># Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran</span></div>
<divclass="line"><aname="l00266"></a><spanclass="lineno"> 266</span> <spanclass="preprocessor"># sources. Doxygen will then generate output that is tailored for Fortran.</span></div>
<divclass="line"><aname="l00267"></a><spanclass="lineno"> 267</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00271"></a><spanclass="lineno"> 271</span> <spanclass="preprocessor"># Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL</span></div>
<divclass="line"><aname="l00272"></a><spanclass="lineno"> 272</span> <spanclass="preprocessor"># sources. Doxygen will then generate output that is tailored for VHDL.</span></div>
<divclass="line"><aname="l00273"></a><spanclass="lineno"> 273</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00277"></a><spanclass="lineno"> 277</span> <spanclass="preprocessor"># Doxygen selects the parser to use depending on the extension of the files it</span></div>
<divclass="line"><aname="l00278"></a><spanclass="lineno"> 278</span> <spanclass="preprocessor"># parses. With this tag you can assign which parser to use for a given</span></div>
<divclass="line"><aname="l00279"></a><spanclass="lineno"> 279</span> <spanclass="preprocessor"># extension. Doxygen has a built-in mapping, but you can override or extend it</span></div>
<divclass="line"><aname="l00280"></a><spanclass="lineno"> 280</span> <spanclass="preprocessor"># using this tag. The format is ext=language, where ext is a file extension, and</span></div>
<divclass="line"><aname="l00281"></a><spanclass="lineno"> 281</span> <spanclass="preprocessor"># language is one of the parsers supported by doxygen: IDL, Java, Javascript,</span></div>
<divclass="line"><aname="l00284"></a><spanclass="lineno"> 284</span> <spanclass="preprocessor"># Fortran. In the later case the parser tries to guess whether the code is fixed</span></div>
<divclass="line"><aname="l00285"></a><spanclass="lineno"> 285</span> <spanclass="preprocessor"># or free formatted code, this is the default for Fortran type files), VHDL. For</span></div>
<divclass="line"><aname="l00286"></a><spanclass="lineno"> 286</span> <spanclass="preprocessor"># instance to make doxygen treat .inc files as Fortran files (default is PHP),</span></div>
<divclass="line"><aname="l00287"></a><spanclass="lineno"> 287</span> <spanclass="preprocessor"># and .f files as C (default is Fortran), use: inc=Fortran f=C.</span></div>
<divclass="line"><aname="l00289"></a><spanclass="lineno"> 289</span> <spanclass="preprocessor"># Note: For files without extension you can use no_extension as a placeholder.</span></div>
<divclass="line"><aname="l00291"></a><spanclass="lineno"> 291</span> <spanclass="preprocessor"># Note that for custom extensions you also need to set FILE_PATTERNS otherwise</span></div>
<divclass="line"><aname="l00292"></a><spanclass="lineno"> 292</span> <spanclass="preprocessor"># the files are not read by doxygen.</span></div>
<divclass="line"><aname="l00296"></a><spanclass="lineno"> 296</span> <spanclass="preprocessor"># If the MARKDOWN_SUPPORT tag is enabled then doxygen pre-processes all comments</span></div>
<divclass="line"><aname="l00297"></a><spanclass="lineno"> 297</span> <spanclass="preprocessor"># according to the Markdown format, which allows for more readable</span></div>
<divclass="line"><aname="l00298"></a><spanclass="lineno"> 298</span> <spanclass="preprocessor"># documentation. See http://daringfireball.net/projects/markdown/ for details.</span></div>
<divclass="line"><aname="l00299"></a><spanclass="lineno"> 299</span> <spanclass="preprocessor"># The output of markdown processing is further processed by doxygen, so you can</span></div>
<divclass="line"><aname="l00300"></a><spanclass="lineno"> 300</span> <spanclass="preprocessor"># mix doxygen, HTML, and XML commands with Markdown formatting. Disable only in</span></div>
<divclass="line"><aname="l00301"></a><spanclass="lineno"> 301</span> <spanclass="preprocessor"># case of backward compatibilities issues.</span></div>
<divclass="line"><aname="l00302"></a><spanclass="lineno"> 302</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00306"></a><spanclass="lineno"> 306</span> <spanclass="preprocessor"># When enabled doxygen tries to link words that correspond to documented</span></div>
<divclass="line"><aname="l00307"></a><spanclass="lineno"> 307</span> <spanclass="preprocessor"># classes, or namespaces to their corresponding documentation. Such a link can</span></div>
<divclass="line"><aname="l00308"></a><spanclass="lineno"> 308</span> <spanclass="preprocessor"># be prevented in individual cases by putting a % sign in front of the word or</span></div>
<divclass="line"><aname="l00309"></a><spanclass="lineno"> 309</span> <spanclass="preprocessor"># globally by setting AUTOLINK_SUPPORT to NO.</span></div>
<divclass="line"><aname="l00310"></a><spanclass="lineno"> 310</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00314"></a><spanclass="lineno"> 314</span> <spanclass="preprocessor"># If you use STL classes (i.e. std::string, std::vector, etc.) but do not want</span></div>
<divclass="line"><aname="l00315"></a><spanclass="lineno"> 315</span> <spanclass="preprocessor"># to include (a tag file for) the STL sources as input, then you should set this</span></div>
<divclass="line"><aname="l00316"></a><spanclass="lineno"> 316</span> <spanclass="preprocessor"># tag to YES in order to let doxygen match functions declarations and</span></div>
<divclass="line"><aname="l00318"></a><spanclass="lineno"> 318</span> <spanclass="preprocessor"># versus func(std::string) {}). This also make the inheritance and collaboration</span></div>
<divclass="line"><aname="l00319"></a><spanclass="lineno"> 319</span> <spanclass="preprocessor"># diagrams that involve STL classes more complete and accurate.</span></div>
<divclass="line"><aname="l00320"></a><spanclass="lineno"> 320</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00324"></a><spanclass="lineno"> 324</span> <spanclass="preprocessor"># If you use Microsoft's C++/CLI language, you should set this option to YES to</span></div>
<divclass="line"><aname="l00330"></a><spanclass="lineno"> 330</span> <spanclass="preprocessor"># Set the SIP_SUPPORT tag to YES if your project consists of sip (see:</span></div>
<divclass="line"><aname="l00332"></a><spanclass="lineno"> 332</span> <spanclass="preprocessor"># will parse them like normal C++ but will assume all classes use public instead</span></div>
<divclass="line"><aname="l00333"></a><spanclass="lineno"> 333</span> <spanclass="preprocessor"># of private inheritance when no explicit protection keyword is present.</span></div>
<divclass="line"><aname="l00334"></a><spanclass="lineno"> 334</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00338"></a><spanclass="lineno"> 338</span> <spanclass="preprocessor"># For Microsoft's IDL there are propget and propput attributes to indicate</span></div>
<divclass="line"><aname="l00339"></a><spanclass="lineno"> 339</span> <spanclass="preprocessor"># getter and setter methods for a property. Setting this option to YES will make</span></div>
<divclass="line"><aname="l00340"></a><spanclass="lineno"> 340</span> <spanclass="preprocessor"># doxygen to replace the get and set methods by a property in the documentation.</span></div>
<divclass="line"><aname="l00341"></a><spanclass="lineno"> 341</span> <spanclass="preprocessor"># This will only work if the methods are indeed getting or setting a simple</span></div>
<divclass="line"><aname="l00342"></a><spanclass="lineno"> 342</span> <spanclass="preprocessor"># type. If this is not the case, or you want to show the methods anyway, you</span></div>
<divclass="line"><aname="l00343"></a><spanclass="lineno"> 343</span> <spanclass="preprocessor"># should set this option to NO.</span></div>
<divclass="line"><aname="l00344"></a><spanclass="lineno"> 344</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00348"></a><spanclass="lineno"> 348</span> <spanclass="preprocessor"># If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC</span></div>
<divclass="line"><aname="l00349"></a><spanclass="lineno"> 349</span> <spanclass="preprocessor"># tag is set to YES then doxygen will reuse the documentation of the first</span></div>
<divclass="line"><aname="l00350"></a><spanclass="lineno"> 350</span> <spanclass="preprocessor"># member in the group (if any) for the other members of the group. By default</span></div>
<divclass="line"><aname="l00351"></a><spanclass="lineno"> 351</span> <spanclass="preprocessor"># all members of a group must be documented explicitly.</span></div>
<divclass="line"><aname="l00352"></a><spanclass="lineno"> 352</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00356"></a><spanclass="lineno"> 356</span> <spanclass="preprocessor"># If one adds a struct or class to a group and this option is enabled, then also</span></div>
<divclass="line"><aname="l00357"></a><spanclass="lineno"> 357</span> <spanclass="preprocessor"># any nested class or struct is added to the same group. By default this option</span></div>
<divclass="line"><aname="l00358"></a><spanclass="lineno"> 358</span> <spanclass="preprocessor"># is disabled and one has to add nested compounds explicitly via \ingroup.</span></div>
<divclass="line"><aname="l00359"></a><spanclass="lineno"> 359</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00363"></a><spanclass="lineno"> 363</span> <spanclass="preprocessor"># Set the SUBGROUPING tag to YES to allow class member groups of the same type</span></div>
<divclass="line"><aname="l00364"></a><spanclass="lineno"> 364</span> <spanclass="preprocessor"># (for instance a group of public functions) to be put as a subgroup of that</span></div>
<divclass="line"><aname="l00365"></a><spanclass="lineno"> 365</span> <spanclass="preprocessor"># type (e.g. under the Public Functions section). Set it to NO to prevent</span></div>
<divclass="line"><aname="l00366"></a><spanclass="lineno"> 366</span> <spanclass="preprocessor"># subgrouping. Alternatively, this can be done per class using the</span></div>
<divclass="line"><aname="l00372"></a><spanclass="lineno"> 372</span> <spanclass="preprocessor"># When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and unions</span></div>
<divclass="line"><aname="l00373"></a><spanclass="lineno"> 373</span> <spanclass="preprocessor"># are shown inside the group in which they are included (e.g. using \ingroup)</span></div>
<divclass="line"><aname="l00374"></a><spanclass="lineno"> 374</span> <spanclass="preprocessor"># instead of on a separate page (for HTML and Man pages) or section (for LaTeX</span></div>
<divclass="line"><aname="l00375"></a><spanclass="lineno"> 375</span> <spanclass="preprocessor"># and RTF).</span></div>
<divclass="line"><aname="l00377"></a><spanclass="lineno"> 377</span> <spanclass="preprocessor"># Note that this feature does not work in combination with</span></div>
<divclass="line"><aname="l00383"></a><spanclass="lineno"> 383</span> <spanclass="preprocessor"># When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and unions</span></div>
<divclass="line"><aname="l00384"></a><spanclass="lineno"> 384</span> <spanclass="preprocessor"># with only public data fields or simple typedef fields will be shown inline in</span></div>
<divclass="line"><aname="l00385"></a><spanclass="lineno"> 385</span> <spanclass="preprocessor"># the documentation of the scope in which they are defined (i.e. file,</span></div>
<divclass="line"><aname="l00386"></a><spanclass="lineno"> 386</span> <spanclass="preprocessor"># namespace, or group documentation), provided this scope is documented. If set</span></div>
<divclass="line"><aname="l00387"></a><spanclass="lineno"> 387</span> <spanclass="preprocessor"># to NO, structs, classes, and unions are shown on a separate page (for HTML and</span></div>
<divclass="line"><aname="l00388"></a><spanclass="lineno"> 388</span> <spanclass="preprocessor"># Man pages) or section (for LaTeX and RTF).</span></div>
<divclass="line"><aname="l00389"></a><spanclass="lineno"> 389</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00393"></a><spanclass="lineno"> 393</span> <spanclass="preprocessor"># When TYPEDEF_HIDES_STRUCT tag is enabled, a typedef of a struct, union, or</span></div>
<divclass="line"><aname="l00394"></a><spanclass="lineno"> 394</span> <spanclass="preprocessor"># enum is documented as struct, union, or enum with the name of the typedef. So</span></div>
<divclass="line"><aname="l00395"></a><spanclass="lineno"> 395</span> <spanclass="preprocessor"># typedef struct TypeS {} TypeT, will appear in the documentation as a struct</span></div>
<divclass="line"><aname="l00396"></a><spanclass="lineno"> 396</span> <spanclass="preprocessor"># with name TypeT. When disabled the typedef will appear as a member of a file,</span></div>
<divclass="line"><aname="l00397"></a><spanclass="lineno"> 397</span> <spanclass="preprocessor"># namespace, or class. And the struct will be named TypeS. This can typically be</span></div>
<divclass="line"><aname="l00398"></a><spanclass="lineno"> 398</span> <spanclass="preprocessor"># useful for C code in case the coding convention dictates that all compound</span></div>
<divclass="line"><aname="l00399"></a><spanclass="lineno"> 399</span> <spanclass="preprocessor"># types are typedef'ed and only the typedef is referenced, never the tag name.</span></div>
<divclass="line"><aname="l00400"></a><spanclass="lineno"> 400</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00404"></a><spanclass="lineno"> 404</span> <spanclass="preprocessor"># The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This</span></div>
<divclass="line"><aname="l00405"></a><spanclass="lineno"> 405</span> <spanclass="preprocessor"># cache is used to resolve symbols given their name and scope. Since this can be</span></div>
<divclass="line"><aname="l00406"></a><spanclass="lineno"> 406</span> <spanclass="preprocessor"># an expensive process and often the same symbol appears multiple times in the</span></div>
<divclass="line"><aname="l00407"></a><spanclass="lineno"> 407</span> <spanclass="preprocessor"># code, doxygen keeps a cache of pre-resolved symbols. If the cache is too small</span></div>
<divclass="line"><aname="l00408"></a><spanclass="lineno"> 408</span> <spanclass="preprocessor"># doxygen will become slower. If the cache is too large, memory is wasted. The</span></div>
<divclass="line"><aname="l00409"></a><spanclass="lineno"> 409</span> <spanclass="preprocessor"># cache size is given by this formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range</span></div>
<divclass="line"><aname="l00410"></a><spanclass="lineno"> 410</span> <spanclass="preprocessor"># is 0..9, the default is 0, corresponding to a cache size of 2^16=65536</span></div>
<divclass="line"><aname="l00411"></a><spanclass="lineno"> 411</span> <spanclass="preprocessor"># symbols. At the end of a run doxygen will report the cache usage and suggest</span></div>
<divclass="line"><aname="l00412"></a><spanclass="lineno"> 412</span> <spanclass="preprocessor"># the optimal cache size from a speed point of view.</span></div>
<divclass="line"><aname="l00421"></a><spanclass="lineno"> 421</span> <spanclass="preprocessor"># If the EXTRACT_ALL tag is set to YES, doxygen will assume all entities in</span></div>
<divclass="line"><aname="l00422"></a><spanclass="lineno"> 422</span> <spanclass="preprocessor"># documentation are documented, even if no documentation was available. Private</span></div>
<divclass="line"><aname="l00423"></a><spanclass="lineno"> 423</span> <spanclass="preprocessor"># class members and static file members will be hidden unless the</span></div>
<divclass="line"><aname="l00424"></a><spanclass="lineno"> 424</span> <spanclass="preprocessor"># EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES.</span></div>
<divclass="line"><aname="l00425"></a><spanclass="lineno"> 425</span> <spanclass="preprocessor"># Note: This will also disable the warnings about undocumented members that are</span></div>
<divclass="line"><aname="l00426"></a><spanclass="lineno"> 426</span> <spanclass="preprocessor"># normally produced when WARNINGS is set to YES.</span></div>
<divclass="line"><aname="l00427"></a><spanclass="lineno"> 427</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00431"></a><spanclass="lineno"> 431</span> <spanclass="preprocessor"># If the EXTRACT_PRIVATE tag is set to YES, all private members of a class will</span></div>
<divclass="line"><aname="l00432"></a><spanclass="lineno"> 432</span> <spanclass="preprocessor"># be included in the documentation.</span></div>
<divclass="line"><aname="l00433"></a><spanclass="lineno"> 433</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00437"></a><spanclass="lineno"> 437</span> <spanclass="preprocessor"># If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal</span></div>
<divclass="line"><aname="l00438"></a><spanclass="lineno"> 438</span> <spanclass="preprocessor"># scope will be included in the documentation.</span></div>
<divclass="line"><aname="l00439"></a><spanclass="lineno"> 439</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00443"></a><spanclass="lineno"> 443</span> <spanclass="preprocessor"># If the EXTRACT_STATIC tag is set to YES, all static members of a file will be</span></div>
<divclass="line"><aname="l00444"></a><spanclass="lineno"> 444</span> <spanclass="preprocessor"># included in the documentation.</span></div>
<divclass="line"><aname="l00445"></a><spanclass="lineno"> 445</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00449"></a><spanclass="lineno"> 449</span> <spanclass="preprocessor"># If the EXTRACT_LOCAL_CLASSES tag is set to YES, classes (and structs) defined</span></div>
<divclass="line"><aname="l00450"></a><spanclass="lineno"> 450</span> <spanclass="preprocessor"># locally in source files will be included in the documentation. If set to NO,</span></div>
<divclass="line"><aname="l00451"></a><spanclass="lineno"> 451</span> <spanclass="preprocessor"># only classes defined in header files are included. Does not have any effect</span></div>
<divclass="line"><aname="l00452"></a><spanclass="lineno"> 452</span> <spanclass="preprocessor"># for Java sources.</span></div>
<divclass="line"><aname="l00453"></a><spanclass="lineno"> 453</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00457"></a><spanclass="lineno"> 457</span> <spanclass="preprocessor"># This flag is only useful for Objective-C code. If set to YES, local methods,</span></div>
<divclass="line"><aname="l00458"></a><spanclass="lineno"> 458</span> <spanclass="preprocessor"># which are defined in the implementation section but not in the interface are</span></div>
<divclass="line"><aname="l00459"></a><spanclass="lineno"> 459</span> <spanclass="preprocessor"># included in the documentation. If set to NO, only methods in the interface are</span></div>
<divclass="line"><aname="l00465"></a><spanclass="lineno"> 465</span> <spanclass="preprocessor"># If this flag is set to YES, the members of anonymous namespaces will be</span></div>
<divclass="line"><aname="l00466"></a><spanclass="lineno"> 466</span> <spanclass="preprocessor"># extracted and appear in the documentation as a namespace called</span></div>
<divclass="line"><aname="l00467"></a><spanclass="lineno"> 467</span> <spanclass="preprocessor"># 'anonymous_namespace{file}', where file will be replaced with the base name of</span></div>
<divclass="line"><aname="l00468"></a><spanclass="lineno"> 468</span> <spanclass="preprocessor"># the file that contains the anonymous namespace. By default anonymous namespace</span></div>
<divclass="line"><aname="l00469"></a><spanclass="lineno"> 469</span> <spanclass="preprocessor"># are hidden.</span></div>
<divclass="line"><aname="l00470"></a><spanclass="lineno"> 470</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00474"></a><spanclass="lineno"> 474</span> <spanclass="preprocessor"># If the HIDE_UNDOC_MEMBERS tag is set to YES, doxygen will hide all</span></div>
<divclass="line"><aname="l00475"></a><spanclass="lineno"> 475</span> <spanclass="preprocessor"># undocumented members inside documented classes or files. If set to NO these</span></div>
<divclass="line"><aname="l00476"></a><spanclass="lineno"> 476</span> <spanclass="preprocessor"># members will be included in the various overviews, but no documentation</span></div>
<divclass="line"><aname="l00477"></a><spanclass="lineno"> 477</span> <spanclass="preprocessor"># section is generated. This option has no effect if EXTRACT_ALL is enabled.</span></div>
<divclass="line"><aname="l00478"></a><spanclass="lineno"> 478</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00482"></a><spanclass="lineno"> 482</span> <spanclass="preprocessor"># If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all</span></div>
<divclass="line"><aname="l00483"></a><spanclass="lineno"> 483</span> <spanclass="preprocessor"># undocumented classes that are normally visible in the class hierarchy. If set</span></div>
<divclass="line"><aname="l00484"></a><spanclass="lineno"> 484</span> <spanclass="preprocessor"># to NO, these classes will be included in the various overviews. This option</span></div>
<divclass="line"><aname="l00485"></a><spanclass="lineno"> 485</span> <spanclass="preprocessor"># has no effect if EXTRACT_ALL is enabled.</span></div>
<divclass="line"><aname="l00486"></a><spanclass="lineno"> 486</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00490"></a><spanclass="lineno"> 490</span> <spanclass="preprocessor"># If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend</span></div>
<divclass="line"><aname="l00491"></a><spanclass="lineno"> 491</span> <spanclass="preprocessor"># (class|struct|union) declarations. If set to NO, these declarations will be</span></div>
<divclass="line"><aname="l00492"></a><spanclass="lineno"> 492</span> <spanclass="preprocessor"># included in the documentation.</span></div>
<divclass="line"><aname="l00493"></a><spanclass="lineno"> 493</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00497"></a><spanclass="lineno"> 497</span> <spanclass="preprocessor"># If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any</span></div>
<divclass="line"><aname="l00498"></a><spanclass="lineno"> 498</span> <spanclass="preprocessor"># documentation blocks found inside the body of a function. If set to NO, these</span></div>
<divclass="line"><aname="l00499"></a><spanclass="lineno"> 499</span> <spanclass="preprocessor"># blocks will be appended to the function's detailed documentation block.</span></div>
<divclass="line"><aname="l00500"></a><spanclass="lineno"> 500</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00504"></a><spanclass="lineno"> 504</span> <spanclass="preprocessor"># The INTERNAL_DOCS tag determines if documentation that is typed after a</span></div>
<divclass="line"><aname="l00505"></a><spanclass="lineno"> 505</span> <spanclass="preprocessor"># \internal command is included. If the tag is set to NO then the documentation</span></div>
<divclass="line"><aname="l00506"></a><spanclass="lineno"> 506</span> <spanclass="preprocessor"># will be excluded. Set it to YES to include the internal documentation.</span></div>
<divclass="line"><aname="l00507"></a><spanclass="lineno"> 507</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00511"></a><spanclass="lineno"> 511</span> <spanclass="preprocessor"># If the CASE_SENSE_NAMES tag is set to NO then doxygen will only generate file</span></div>
<divclass="line"><aname="l00512"></a><spanclass="lineno"> 512</span> <spanclass="preprocessor"># names in lower-case letters. If set to YES, upper-case letters are also</span></div>
<divclass="line"><aname="l00513"></a><spanclass="lineno"> 513</span> <spanclass="preprocessor"># allowed. This is useful if you have classes or files whose names only differ</span></div>
<divclass="line"><aname="l00514"></a><spanclass="lineno"> 514</span> <spanclass="preprocessor"># in case and if your file system supports case sensitive file names. Windows</span></div>
<divclass="line"><aname="l00515"></a><spanclass="lineno"> 515</span> <spanclass="preprocessor"># and Mac users are advised to set this option to NO.</span></div>
<divclass="line"><aname="l00516"></a><spanclass="lineno"> 516</span> <spanclass="preprocessor"># The default value is: system dependent.</span></div>
<divclass="line"><aname="l00520"></a><spanclass="lineno"> 520</span> <spanclass="preprocessor"># If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with</span></div>
<divclass="line"><aname="l00521"></a><spanclass="lineno"> 521</span> <spanclass="preprocessor"># their full class and namespace scopes in the documentation. If set to YES, the</span></div>
<divclass="line"><aname="l00522"></a><spanclass="lineno"> 522</span> <spanclass="preprocessor"># scope will be hidden.</span></div>
<divclass="line"><aname="l00523"></a><spanclass="lineno"> 523</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00527"></a><spanclass="lineno"> 527</span> <spanclass="preprocessor"># If the HIDE_COMPOUND_REFERENCE tag is set to NO (default) then doxygen will</span></div>
<divclass="line"><aname="l00528"></a><spanclass="lineno"> 528</span> <spanclass="preprocessor"># append additional text to a page's title, such as Class Reference. If set to</span></div>
<divclass="line"><aname="l00529"></a><spanclass="lineno"> 529</span> <spanclass="preprocessor"># YES the compound reference will be hidden.</span></div>
<divclass="line"><aname="l00530"></a><spanclass="lineno"> 530</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00534"></a><spanclass="lineno"> 534</span> <spanclass="preprocessor"># If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of</span></div>
<divclass="line"><aname="l00535"></a><spanclass="lineno"> 535</span> <spanclass="preprocessor"># the files that are included by a file in the documentation of that file.</span></div>
<divclass="line"><aname="l00536"></a><spanclass="lineno"> 536</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00540"></a><spanclass="lineno"> 540</span> <spanclass="preprocessor"># If the SHOW_GROUPED_MEMB_INC tag is set to YES then Doxygen will add for each</span></div>
<divclass="line"><aname="l00541"></a><spanclass="lineno"> 541</span> <spanclass="preprocessor"># grouped member an include statement to the documentation, telling the reader</span></div>
<divclass="line"><aname="l00542"></a><spanclass="lineno"> 542</span> <spanclass="preprocessor"># which file to include in order to use the member.</span></div>
<divclass="line"><aname="l00543"></a><spanclass="lineno"> 543</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00547"></a><spanclass="lineno"> 547</span> <spanclass="preprocessor"># If the FORCE_LOCAL_INCLUDES tag is set to YES then doxygen will list include</span></div>
<divclass="line"><aname="l00548"></a><spanclass="lineno"> 548</span> <spanclass="preprocessor"># files with double quotes in the documentation rather than with sharp brackets.</span></div>
<divclass="line"><aname="l00549"></a><spanclass="lineno"> 549</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00553"></a><spanclass="lineno"> 553</span> <spanclass="preprocessor"># If the INLINE_INFO tag is set to YES then a tag [inline] is inserted in the</span></div>
<divclass="line"><aname="l00554"></a><spanclass="lineno"> 554</span> <spanclass="preprocessor"># documentation for inline members.</span></div>
<divclass="line"><aname="l00555"></a><spanclass="lineno"> 555</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00559"></a><spanclass="lineno"> 559</span> <spanclass="preprocessor"># If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the</span></div>
<divclass="line"><aname="l00560"></a><spanclass="lineno"> 560</span> <spanclass="preprocessor"># (detailed) documentation of file and class members alphabetically by member</span></div>
<divclass="line"><aname="l00561"></a><spanclass="lineno"> 561</span> <spanclass="preprocessor"># name. If set to NO, the members will appear in declaration order.</span></div>
<divclass="line"><aname="l00562"></a><spanclass="lineno"> 562</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00566"></a><spanclass="lineno"> 566</span> <spanclass="preprocessor"># If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief</span></div>
<divclass="line"><aname="l00567"></a><spanclass="lineno"> 567</span> <spanclass="preprocessor"># descriptions of file, namespace and class members alphabetically by member</span></div>
<divclass="line"><aname="l00568"></a><spanclass="lineno"> 568</span> <spanclass="preprocessor"># name. If set to NO, the members will appear in declaration order. Note that</span></div>
<divclass="line"><aname="l00569"></a><spanclass="lineno"> 569</span> <spanclass="preprocessor"># this will also influence the order of the classes in the class list.</span></div>
<divclass="line"><aname="l00570"></a><spanclass="lineno"> 570</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00574"></a><spanclass="lineno"> 574</span> <spanclass="preprocessor"># If the SORT_MEMBERS_CTORS_1ST tag is set to YES then doxygen will sort the</span></div>
<divclass="line"><aname="l00575"></a><spanclass="lineno"> 575</span> <spanclass="preprocessor"># (brief and detailed) documentation of class members so that constructors and</span></div>
<divclass="line"><aname="l00576"></a><spanclass="lineno"> 576</span> <spanclass="preprocessor"># destructors are listed first. If set to NO the constructors will appear in the</span></div>
<divclass="line"><aname="l00577"></a><spanclass="lineno"> 577</span> <spanclass="preprocessor"># respective orders defined by SORT_BRIEF_DOCS and SORT_MEMBER_DOCS.</span></div>
<divclass="line"><aname="l00578"></a><spanclass="lineno"> 578</span> <spanclass="preprocessor"># Note: If SORT_BRIEF_DOCS is set to NO this option is ignored for sorting brief</span></div>
<divclass="line"><aname="l00579"></a><spanclass="lineno"> 579</span> <spanclass="preprocessor"># member documentation.</span></div>
<divclass="line"><aname="l00580"></a><spanclass="lineno"> 580</span> <spanclass="preprocessor"># Note: If SORT_MEMBER_DOCS is set to NO this option is ignored for sorting</span></div>
<divclass="line"><aname="l00581"></a><spanclass="lineno"> 581</span> <spanclass="preprocessor"># detailed member documentation.</span></div>
<divclass="line"><aname="l00582"></a><spanclass="lineno"> 582</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00586"></a><spanclass="lineno"> 586</span> <spanclass="preprocessor"># If the SORT_GROUP_NAMES tag is set to YES then doxygen will sort the hierarchy</span></div>
<divclass="line"><aname="l00587"></a><spanclass="lineno"> 587</span> <spanclass="preprocessor"># of group names into alphabetical order. If set to NO the group names will</span></div>
<divclass="line"><aname="l00588"></a><spanclass="lineno"> 588</span> <spanclass="preprocessor"># appear in their defined order.</span></div>
<divclass="line"><aname="l00589"></a><spanclass="lineno"> 589</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00593"></a><spanclass="lineno"> 593</span> <spanclass="preprocessor"># If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be sorted by</span></div>
<divclass="line"><aname="l00594"></a><spanclass="lineno"> 594</span> <spanclass="preprocessor"># fully-qualified names, including namespaces. If set to NO, the class list will</span></div>
<divclass="line"><aname="l00595"></a><spanclass="lineno"> 595</span> <spanclass="preprocessor"># be sorted only by class name, not including the namespace part.</span></div>
<divclass="line"><aname="l00596"></a><spanclass="lineno"> 596</span> <spanclass="preprocessor"># Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.</span></div>
<divclass="line"><aname="l00597"></a><spanclass="lineno"> 597</span> <spanclass="preprocessor"># Note: This option applies only to the class list, not to the alphabetical</span></div>
<divclass="line"><aname="l00603"></a><spanclass="lineno"> 603</span> <spanclass="preprocessor"># If the STRICT_PROTO_MATCHING option is enabled and doxygen fails to do proper</span></div>
<divclass="line"><aname="l00604"></a><spanclass="lineno"> 604</span> <spanclass="preprocessor"># type resolution of all parameters of a function it will reject a match between</span></div>
<divclass="line"><aname="l00605"></a><spanclass="lineno"> 605</span> <spanclass="preprocessor"># the prototype and the implementation of a member function even if there is</span></div>
<divclass="line"><aname="l00606"></a><spanclass="lineno"> 606</span> <spanclass="preprocessor"># only one candidate or it is obvious which candidate to choose by doing a</span></div>
<divclass="line"><aname="l00607"></a><spanclass="lineno"> 607</span> <spanclass="preprocessor"># simple string match. By disabling STRICT_PROTO_MATCHING doxygen will still</span></div>
<divclass="line"><aname="l00608"></a><spanclass="lineno"> 608</span> <spanclass="preprocessor"># accept a match between prototype and implementation in such cases.</span></div>
<divclass="line"><aname="l00609"></a><spanclass="lineno"> 609</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00613"></a><spanclass="lineno"> 613</span> <spanclass="preprocessor"># The GENERATE_TODOLIST tag can be used to enable (YES) or disable (NO) the todo</span></div>
<divclass="line"><aname="l00614"></a><spanclass="lineno"> 614</span> <spanclass="preprocessor"># list. This list is created by putting \todo commands in the documentation.</span></div>
<divclass="line"><aname="l00615"></a><spanclass="lineno"> 615</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00619"></a><spanclass="lineno"> 619</span> <spanclass="preprocessor"># The GENERATE_TESTLIST tag can be used to enable (YES) or disable (NO) the test</span></div>
<divclass="line"><aname="l00620"></a><spanclass="lineno"> 620</span> <spanclass="preprocessor"># list. This list is created by putting \test commands in the documentation.</span></div>
<divclass="line"><aname="l00621"></a><spanclass="lineno"> 621</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00625"></a><spanclass="lineno"> 625</span> <spanclass="preprocessor"># The GENERATE_BUGLIST tag can be used to enable (YES) or disable (NO) the bug</span></div>
<divclass="line"><aname="l00626"></a><spanclass="lineno"> 626</span> <spanclass="preprocessor"># list. This list is created by putting \bug commands in the documentation.</span></div>
<divclass="line"><aname="l00627"></a><spanclass="lineno"> 627</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00631"></a><spanclass="lineno"> 631</span> <spanclass="preprocessor"># The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or disable (NO)</span></div>
<divclass="line"><aname="l00632"></a><spanclass="lineno"> 632</span> <spanclass="preprocessor"># the deprecated list. This list is created by putting \deprecated commands in</span></div>
<divclass="line"><aname="l00633"></a><spanclass="lineno"> 633</span> <spanclass="preprocessor"># the documentation.</span></div>
<divclass="line"><aname="l00634"></a><spanclass="lineno"> 634</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00638"></a><spanclass="lineno"> 638</span> <spanclass="preprocessor"># The ENABLED_SECTIONS tag can be used to enable conditional documentation</span></div>
<divclass="line"><aname="l00639"></a><spanclass="lineno"> 639</span> <spanclass="preprocessor"># sections, marked by \if <section_label> ... \endif and \cond <section_label></span></div>
<divclass="line"><aname="l00644"></a><spanclass="lineno"> 644</span> <spanclass="preprocessor"># The MAX_INITIALIZER_LINES tag determines the maximum number of lines that the</span></div>
<divclass="line"><aname="l00645"></a><spanclass="lineno"> 645</span> <spanclass="preprocessor"># initial value of a variable or macro / define can have for it to appear in the</span></div>
<divclass="line"><aname="l00646"></a><spanclass="lineno"> 646</span> <spanclass="preprocessor"># documentation. If the initializer consists of more lines than specified here</span></div>
<divclass="line"><aname="l00647"></a><spanclass="lineno"> 647</span> <spanclass="preprocessor"># it will be hidden. Use a value of 0 to hide initializers completely. The</span></div>
<divclass="line"><aname="l00648"></a><spanclass="lineno"> 648</span> <spanclass="preprocessor"># appearance of the value of individual variables and macros / defines can be</span></div>
<divclass="line"><aname="l00649"></a><spanclass="lineno"> 649</span> <spanclass="preprocessor"># controlled using \showinitializer or \hideinitializer command in the</span></div>
<divclass="line"><aname="l00650"></a><spanclass="lineno"> 650</span> <spanclass="preprocessor"># documentation regardless of this setting.</span></div>
<divclass="line"><aname="l00655"></a><spanclass="lineno"> 655</span> <spanclass="preprocessor"># Set the SHOW_USED_FILES tag to NO to disable the list of files generated at</span></div>
<divclass="line"><aname="l00656"></a><spanclass="lineno"> 656</span> <spanclass="preprocessor"># the bottom of the documentation of classes and structs. If set to YES, the</span></div>
<divclass="line"><aname="l00657"></a><spanclass="lineno"> 657</span> <spanclass="preprocessor"># list will mention the files that were used to generate the documentation.</span></div>
<divclass="line"><aname="l00658"></a><spanclass="lineno"> 658</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00662"></a><spanclass="lineno"> 662</span> <spanclass="preprocessor"># Set the SHOW_FILES tag to NO to disable the generation of the Files page. This</span></div>
<divclass="line"><aname="l00663"></a><spanclass="lineno"> 663</span> <spanclass="preprocessor"># will remove the Files entry from the Quick Index and from the Folder Tree View</span></div>
<divclass="line"><aname="l00669"></a><spanclass="lineno"> 669</span> <spanclass="preprocessor"># Set the SHOW_NAMESPACES tag to NO to disable the generation of the Namespaces</span></div>
<divclass="line"><aname="l00670"></a><spanclass="lineno"> 670</span> <spanclass="preprocessor"># page. This will remove the Namespaces entry from the Quick Index and from the</span></div>
<divclass="line"><aname="l00671"></a><spanclass="lineno"> 671</span> <spanclass="preprocessor"># Folder Tree View (if specified).</span></div>
<divclass="line"><aname="l00672"></a><spanclass="lineno"> 672</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00676"></a><spanclass="lineno"> 676</span> <spanclass="preprocessor"># The FILE_VERSION_FILTER tag can be used to specify a program or script that</span></div>
<divclass="line"><aname="l00677"></a><spanclass="lineno"> 677</span> <spanclass="preprocessor"># doxygen should invoke to get the current version for each file (typically from</span></div>
<divclass="line"><aname="l00678"></a><spanclass="lineno"> 678</span> <spanclass="preprocessor"># the version control system). Doxygen will invoke the program by executing (via</span></div>
<divclass="line"><aname="l00679"></a><spanclass="lineno"> 679</span> <spanclass="preprocessor"># popen()) the command command input-file, where command is the value of the</span></div>
<divclass="line"><aname="l00680"></a><spanclass="lineno"> 680</span> <spanclass="preprocessor"># FILE_VERSION_FILTER tag, and input-file is the name of an input file provided</span></div>
<divclass="line"><aname="l00681"></a><spanclass="lineno"> 681</span> <spanclass="preprocessor"># by doxygen. Whatever the program writes to standard output is used as the file</span></div>
<divclass="line"><aname="l00682"></a><spanclass="lineno"> 682</span> <spanclass="preprocessor"># version. For an example see the documentation.</span></div>
<divclass="line"><aname="l00686"></a><spanclass="lineno"> 686</span> <spanclass="preprocessor"># The LAYOUT_FILE tag can be used to specify a layout file which will be parsed</span></div>
<divclass="line"><aname="l00687"></a><spanclass="lineno"> 687</span> <spanclass="preprocessor"># by doxygen. The layout file controls the global structure of the generated</span></div>
<divclass="line"><aname="l00688"></a><spanclass="lineno"> 688</span> <spanclass="preprocessor"># output files in an output format independent way. To create the layout file</span></div>
<divclass="line"><aname="l00689"></a><spanclass="lineno"> 689</span> <spanclass="preprocessor"># that represents doxygen's defaults, run doxygen with the -l option. You can</span></div>
<divclass="line"><aname="l00690"></a><spanclass="lineno"> 690</span> <spanclass="preprocessor"># optionally specify a file name after the option, if omitted DoxygenLayout.xml</span></div>
<divclass="line"><aname="l00691"></a><spanclass="lineno"> 691</span> <spanclass="preprocessor"># will be used as the name of the layout file.</span></div>
<divclass="line"><aname="l00693"></a><spanclass="lineno"> 693</span> <spanclass="preprocessor"># Note that if you run doxygen from a directory containing a file called</span></div>
<divclass="line"><aname="l00694"></a><spanclass="lineno"> 694</span> <spanclass="preprocessor"># DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE</span></div>
<divclass="line"><aname="l00695"></a><spanclass="lineno"> 695</span> <spanclass="preprocessor"># tag is left empty.</span></div>
<divclass="line"><aname="l00699"></a><spanclass="lineno"> 699</span> <spanclass="preprocessor"># The CITE_BIB_FILES tag can be used to specify one or more bib files containing</span></div>
<divclass="line"><aname="l00700"></a><spanclass="lineno"> 700</span> <spanclass="preprocessor"># the reference definitions. This must be a list of .bib files. The .bib</span></div>
<divclass="line"><aname="l00701"></a><spanclass="lineno"> 701</span> <spanclass="preprocessor"># extension is automatically appended if omitted. This requires the bibtex tool</span></div>
<divclass="line"><aname="l00702"></a><spanclass="lineno"> 702</span> <spanclass="preprocessor"># to be installed. See also http://en.wikipedia.org/wiki/BibTeX for more info.</span></div>
<divclass="line"><aname="l00703"></a><spanclass="lineno"> 703</span> <spanclass="preprocessor"># For LaTeX the style of the bibliography can be controlled using</span></div>
<divclass="line"><aname="l00704"></a><spanclass="lineno"> 704</span> <spanclass="preprocessor"># LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the</span></div>
<divclass="line"><aname="l00705"></a><spanclass="lineno"> 705</span> <spanclass="preprocessor"># search path. See also \cite for info how to create references.</span></div>
<divclass="line"><aname="l00710"></a><spanclass="lineno"> 710</span> <spanclass="preprocessor"># Configuration options related to warning and progress messages</span></div>
<divclass="line"><aname="l00713"></a><spanclass="lineno"> 713</span> <spanclass="preprocessor"># The QUIET tag can be used to turn on/off the messages that are generated to</span></div>
<divclass="line"><aname="l00714"></a><spanclass="lineno"> 714</span> <spanclass="preprocessor"># standard output by doxygen. If QUIET is set to YES this implies that the</span></div>
<divclass="line"><aname="l00715"></a><spanclass="lineno"> 715</span> <spanclass="preprocessor"># messages are off.</span></div>
<divclass="line"><aname="l00716"></a><spanclass="lineno"> 716</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00720"></a><spanclass="lineno"> 720</span> <spanclass="preprocessor"># The WARNINGS tag can be used to turn on/off the warning messages that are</span></div>
<divclass="line"><aname="l00721"></a><spanclass="lineno"> 721</span> <spanclass="preprocessor"># generated to standard error (stderr) by doxygen. If WARNINGS is set to YES</span></div>
<divclass="line"><aname="l00722"></a><spanclass="lineno"> 722</span> <spanclass="preprocessor"># this implies that the warnings are on.</span></div>
<divclass="line"><aname="l00724"></a><spanclass="lineno"> 724</span> <spanclass="preprocessor"># Tip: Turn warnings on while writing the documentation.</span></div>
<divclass="line"><aname="l00725"></a><spanclass="lineno"> 725</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00729"></a><spanclass="lineno"> 729</span> <spanclass="preprocessor"># If the WARN_IF_UNDOCUMENTED tag is set to YES then doxygen will generate</span></div>
<divclass="line"><aname="l00730"></a><spanclass="lineno"> 730</span> <spanclass="preprocessor"># warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag</span></div>
<divclass="line"><aname="l00731"></a><spanclass="lineno"> 731</span> <spanclass="preprocessor"># will automatically be disabled.</span></div>
<divclass="line"><aname="l00732"></a><spanclass="lineno"> 732</span> <spanclass="preprocessor"># The default value is: YES.</span></div>
<divclass="line"><aname="l00736"></a><spanclass="lineno"> 736</span> <spanclass="preprocessor"># If the WARN_IF_DOC_ERROR tag is set to YES, doxygen will generate warnings for</span></div>
<divclass="line"><aname="l00737"></a><spanclass="lineno"> 737</span> <spanclass="preprocessor"># potential errors in the documentation, such as not documenting some parameters</span></div>
<divclass="line"><aname="l00738"></a><spanclass="lineno"> 738</span> <spanclass="preprocessor"># in a documented function, or documenting parameters that don't exist or using</span></div>
<divclass="line"><aname="l00744"></a><spanclass="lineno"> 744</span> <spanclass="preprocessor"># This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that</span></div>
<divclass="line"><aname="l00745"></a><spanclass="lineno"> 745</span> <spanclass="preprocessor"># are documented, but have no documentation for their parameters or return</span></div>
<divclass="line"><aname="l00746"></a><spanclass="lineno"> 746</span> <spanclass="preprocessor"># value. If set to NO, doxygen will only warn about wrong or incomplete</span></div>
<divclass="line"><aname="l00747"></a><spanclass="lineno"> 747</span> <spanclass="preprocessor"># parameter documentation, but not about the absence of documentation.</span></div>
<divclass="line"><aname="l00748"></a><spanclass="lineno"> 748</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00752"></a><spanclass="lineno"> 752</span> <spanclass="preprocessor"># The WARN_FORMAT tag determines the format of the warning messages that doxygen</span></div>
<divclass="line"><aname="l00753"></a><spanclass="lineno"> 753</span> <spanclass="preprocessor"># can produce. The string should contain the $file, $line, and $text tags, which</span></div>
<divclass="line"><aname="l00754"></a><spanclass="lineno"> 754</span> <spanclass="preprocessor"># will be replaced by the file and line number from which the warning originated</span></div>
<divclass="line"><aname="l00755"></a><spanclass="lineno"> 755</span> <spanclass="preprocessor"># and the warning text. Optionally the format may contain $version, which will</span></div>
<divclass="line"><aname="l00756"></a><spanclass="lineno"> 756</span> <spanclass="preprocessor"># be replaced by the version of the file (if it could be obtained via</span></div>
<divclass="line"><aname="l00758"></a><spanclass="lineno"> 758</span> <spanclass="preprocessor"># The default value is: $file:$line: $text.</span></div>
<divclass="line"><aname="l00762"></a><spanclass="lineno"> 762</span> <spanclass="preprocessor"># The WARN_LOGFILE tag can be used to specify a file to which warning and error</span></div>
<divclass="line"><aname="l00763"></a><spanclass="lineno"> 763</span> <spanclass="preprocessor"># messages should be written. If left blank the output is written to standard</span></div>
<divclass="line"><aname="l00769"></a><spanclass="lineno"> 769</span> <spanclass="preprocessor"># Configuration options related to the input files</span></div>
<divclass="line"><aname="l00772"></a><spanclass="lineno"> 772</span> <spanclass="preprocessor"># The INPUT tag is used to specify the files and/or directories that contain</span></div>
<divclass="line"><aname="l00773"></a><spanclass="lineno"> 773</span> <spanclass="preprocessor"># documented source files. You may enter file names like myfile.cpp or</span></div>
<divclass="line"><aname="l00774"></a><spanclass="lineno"> 774</span> <spanclass="preprocessor"># directories like /usr/src/myproject. Separate the files or directories with</span></div>
<divclass="line"><aname="l00775"></a><spanclass="lineno"> 775</span> <spanclass="preprocessor"># spaces. See also FILE_PATTERNS and EXTENSION_MAPPING</span></div>
<divclass="line"><aname="l00776"></a><spanclass="lineno"> 776</span> <spanclass="preprocessor"># Note: If this tag is empty the current directory is searched.</span></div>
<divclass="line"><aname="l00781"></a><spanclass="lineno"> 781</span> # This tag can be used to specify the character encoding of the source files</div>
<divclass="line"><aname="l00782"></a><spanclass="lineno"> 782</span> <spanclass="preprocessor"># that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses</span></div>
<divclass="line"><aname="l00783"></a><spanclass="lineno"> 783</span> <spanclass="preprocessor"># libiconv (or the iconv built into libc) for the transcoding. See the libiconv</span></div>
<divclass="line"><aname="l00784"></a><spanclass="lineno"> 784</span> <spanclass="preprocessor"># documentation (see: http://www.gnu.org/software/libiconv) for the list of</span></div>
<divclass="line"><aname="l00785"></a><spanclass="lineno"> 785</span> <spanclass="preprocessor"># possible encodings.</span></div>
<divclass="line"><aname="l00786"></a><spanclass="lineno"> 786</span> <spanclass="preprocessor"># The default value is: UTF-8.</span></div>
<divclass="line"><aname="l00790"></a><spanclass="lineno"> 790</span> <spanclass="preprocessor"># If the value of the INPUT tag contains directories, you can use the</span></div>
<divclass="line"><aname="l00791"></a><spanclass="lineno"> 791</span> <spanclass="preprocessor"># FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and</span></div>
<divclass="line"><aname="l00792"></a><spanclass="lineno"> 792</span> <spanclass="preprocessor"># *.h) to filter out the source-files in the directories.</span></div>
<divclass="line"><aname="l00794"></a><spanclass="lineno"> 794</span> <spanclass="preprocessor"># Note that for custom extensions or not directly supported extensions you also</span></div>
<divclass="line"><aname="l00795"></a><spanclass="lineno"> 795</span> <spanclass="preprocessor"># need to set EXTENSION_MAPPING for the extension otherwise the files are not</span></div>
<divclass="line"><aname="l00796"></a><spanclass="lineno"> 796</span> <spanclass="preprocessor"># read by doxygen.</span></div>
<divclass="line"><aname="l00798"></a><spanclass="lineno"> 798</span> <spanclass="preprocessor"># If left blank the following patterns are tested:*.c, *.cc, *.cxx, *.cpp,</span></div>
<divclass="line"><aname="l00807"></a><spanclass="lineno"> 807</span> <spanclass="preprocessor"># The RECURSIVE tag can be used to specify whether or not subdirectories should</span></div>
<divclass="line"><aname="l00808"></a><spanclass="lineno"> 808</span> <spanclass="preprocessor"># be searched for input files as well.</span></div>
<divclass="line"><aname="l00809"></a><spanclass="lineno"> 809</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00813"></a><spanclass="lineno"> 813</span> <spanclass="preprocessor"># The EXCLUDE tag can be used to specify files and/or directories that should be</span></div>
<divclass="line"><aname="l00814"></a><spanclass="lineno"> 814</span> <spanclass="preprocessor"># excluded from the INPUT source files. This way you can easily exclude a</span></div>
<divclass="line"><aname="l00815"></a><spanclass="lineno"> 815</span> <spanclass="preprocessor"># subdirectory from a directory tree whose root is specified with the INPUT tag.</span></div>
<divclass="line"><aname="l00817"></a><spanclass="lineno"> 817</span> <spanclass="preprocessor"># Note that relative paths are relative to the directory from which doxygen is</span></div>
<divclass="line"><aname="l00822"></a><spanclass="lineno"> 822</span> <spanclass="preprocessor"># The EXCLUDE_SYMLINKS tag can be used to select whether or not files or</span></div>
<divclass="line"><aname="l00823"></a><spanclass="lineno"> 823</span> <spanclass="preprocessor"># directories that are symbolic links (a Unix file system feature) are excluded</span></div>
<divclass="line"><aname="l00824"></a><spanclass="lineno"> 824</span> <spanclass="preprocessor"># from the input.</span></div>
<divclass="line"><aname="l00825"></a><spanclass="lineno"> 825</span> <spanclass="preprocessor"># The default value is: NO.</span></div>
<divclass="line"><aname="l00829"></a><spanclass="lineno"> 829</span> <spanclass="preprocessor"># If the value of the INPUT tag contains directories, you can use the</span></div>
<divclass="line"><aname="l00830"></a><spanclass="lineno"> 830</span> <spanclass="preprocessor"># EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude</span></div>
<divclass="line"><aname="l00831"></a><spanclass="lineno"> 831</span> <spanclass="preprocessor"># certain files from those directories.</span></div>
<divclass="line"><aname="l00833"></a><spanclass="lineno"> 833</span> <spanclass="preprocessor"># Note that the wildcards are matched against the file with absolute path, so to</span></div>
<divclass="line"><aname="l00834"></a><spanclass="lineno"> 834</span> <spanclass="preprocessor"># exclude all test directories for example use the pattern */test</span><spanclass="comment">/*</span></div>
<divclass="line"><aname="l00838"></a><spanclass="lineno"> 838</span> <spanclass="comment"># The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names</span></div>
<divclass="line"><aname="l00839"></a><spanclass="lineno"> 839</span> <spanclass="comment"># (namespaces, classes, functions, etc.) that should be excluded from the</span></div>
<divclass="line"><aname="l00840"></a><spanclass="lineno"> 840</span> <spanclass="comment"># output. The symbol name can be a fully qualified name, a word, or if the</span></div>
<divclass="line"><aname="l00841"></a><spanclass="lineno"> 841</span> <spanclass="comment"># wildcard * is used, a substring. Examples: ANamespace, AClass,</span></div>
<divclass="line"><aname="l00844"></a><spanclass="lineno"> 844</span> <spanclass="comment"># Note that the wildcards are matched against the file with absolute path, so to</span></div>
<divclass="line"><aname="l00845"></a><spanclass="lineno"> 845</span> <spanclass="comment"># exclude all test directories use the pattern */</span><spanclass="preprocessor">test</span><spanclass="comment">/*</span></div>
<divclass="line"><aname="l00849"></a><spanclass="lineno"> 849</span> <spanclass="comment"># The EXAMPLE_PATH tag can be used to specify one or more files or directories</span></div>
<divclass="line"><aname="l00850"></a><spanclass="lineno"> 850</span> <spanclass="comment"># that contain example code fragments that are included (see the \include</span></div>
<divclass="line"><aname="l00855"></a><spanclass="lineno"> 855</span> <spanclass="comment"># If the value of the EXAMPLE_PATH tag contains directories, you can use the</span></div>
<divclass="line"><aname="l00856"></a><spanclass="lineno"> 856</span> <spanclass="comment"># EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and</span></div>
<divclass="line"><aname="l00857"></a><spanclass="lineno"> 857</span> <spanclass="comment"># *.h) to filter out the source-files in the directories. If left blank all</span></div>
<divclass="line"><aname="l00858"></a><spanclass="lineno"> 858</span> <spanclass="comment"># files are included.</span></div>
<divclass="line"><aname="l00862"></a><spanclass="lineno"> 862</span> <spanclass="comment"># If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be</span></div>
<divclass="line"><aname="l00863"></a><spanclass="lineno"> 863</span> <spanclass="comment"># searched for input files to be used with the \include or \dontinclude commands</span></div>
<divclass="line"><aname="l00864"></a><spanclass="lineno"> 864</span> <spanclass="comment"># irrespective of the value of the RECURSIVE tag.</span></div>
<divclass="line"><aname="l00865"></a><spanclass="lineno"> 865</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l00869"></a><spanclass="lineno"> 869</span> <spanclass="comment"># The IMAGE_PATH tag can be used to specify one or more files or directories</span></div>
<divclass="line"><aname="l00870"></a><spanclass="lineno"> 870</span> <spanclass="comment"># that contain images that are to be included in the documentation (see the</span></div>
<divclass="line"><aname="l00875"></a><spanclass="lineno"> 875</span> <spanclass="comment"># The INPUT_FILTER tag can be used to specify a program that doxygen should</span></div>
<divclass="line"><aname="l00876"></a><spanclass="lineno"> 876</span> <spanclass="comment"># invoke to filter for each input file. Doxygen will invoke the filter program</span></div>
<divclass="line"><aname="l00877"></a><spanclass="lineno"> 877</span> <spanclass="comment"># by executing (via popen()) the command:</span></div>
<divclass="line"><aname="l00881"></a><spanclass="lineno"> 881</span> <spanclass="comment"># where <filter> is the value of the INPUT_FILTER tag, and <input-file> is the</span></div>
<divclass="line"><aname="l00882"></a><spanclass="lineno"> 882</span> <spanclass="comment"># name of an input file. Doxygen will then use the output that the filter</span></div>
<divclass="line"><aname="l00883"></a><spanclass="lineno"> 883</span> <spanclass="comment"># program writes to standard output. If FILTER_PATTERNS is specified, this tag</span></div>
<divclass="line"><aname="l00884"></a><spanclass="lineno"> 884</span> <spanclass="comment"># will be ignored.</span></div>
<divclass="line"><aname="l00886"></a><spanclass="lineno"> 886</span> <spanclass="comment"># Note that the filter must not add or remove lines; it is applied before the</span></div>
<divclass="line"><aname="l00887"></a><spanclass="lineno"> 887</span> <spanclass="comment"># code is scanned, but not when the output code is generated. If lines are added</span></div>
<divclass="line"><aname="l00888"></a><spanclass="lineno"> 888</span> <spanclass="comment"># or removed, the anchors will not be placed correctly.</span></div>
<divclass="line"><aname="l00892"></a><spanclass="lineno"> 892</span> <spanclass="comment"># The FILTER_PATTERNS tag can be used to specify filters on a per file pattern</span></div>
<divclass="line"><aname="l00893"></a><spanclass="lineno"> 893</span> <spanclass="comment"># basis. Doxygen will compare the file name with each pattern and apply the</span></div>
<divclass="line"><aname="l00894"></a><spanclass="lineno"> 894</span> <spanclass="comment"># filter if there is a match. The filters are a list of the form: pattern=filter</span></div>
<divclass="line"><aname="l00895"></a><spanclass="lineno"> 895</span> <spanclass="comment"># (like *.cpp=my_cpp_filter). See INPUT_FILTER for further information on how</span></div>
<divclass="line"><aname="l00896"></a><spanclass="lineno"> 896</span> <spanclass="comment"># filters are used. If the FILTER_PATTERNS tag is empty or if none of the</span></div>
<divclass="line"><aname="l00897"></a><spanclass="lineno"> 897</span> <spanclass="comment"># patterns match the file name, INPUT_FILTER is applied.</span></div>
<divclass="line"><aname="l00901"></a><spanclass="lineno"> 901</span> <spanclass="comment"># If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using</span></div>
<divclass="line"><aname="l00902"></a><spanclass="lineno"> 902</span> <spanclass="comment"># INPUT_FILTER) will also be used to filter the input files that are used for</span></div>
<divclass="line"><aname="l00903"></a><spanclass="lineno"> 903</span> <spanclass="comment"># producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES).</span></div>
<divclass="line"><aname="l00904"></a><spanclass="lineno"> 904</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l00908"></a><spanclass="lineno"> 908</span> <spanclass="comment"># The FILTER_SOURCE_PATTERNS tag can be used to specify source filters per file</span></div>
<divclass="line"><aname="l00909"></a><spanclass="lineno"> 909</span> <spanclass="comment"># pattern. A pattern will override the setting for FILTER_PATTERN (if any) and</span></div>
<divclass="line"><aname="l00910"></a><spanclass="lineno"> 910</span> <spanclass="comment"># it is also possible to disable source filtering for a specific pattern using</span></div>
<divclass="line"><aname="l00911"></a><spanclass="lineno"> 911</span> <spanclass="comment"># *.ext= (so without naming a filter).</span></div>
<divclass="line"><aname="l00912"></a><spanclass="lineno"> 912</span> <spanclass="comment"># This tag requires that the tag FILTER_SOURCE_FILES is set to YES.</span></div>
<divclass="line"><aname="l00916"></a><spanclass="lineno"> 916</span> <spanclass="comment"># If the USE_MDFILE_AS_MAINPAGE tag refers to the name of a markdown file that</span></div>
<divclass="line"><aname="l00917"></a><spanclass="lineno"> 917</span> <spanclass="comment"># is part of the input, its contents will be placed on the main page</span></div>
<divclass="line"><aname="l00918"></a><spanclass="lineno"> 918</span> <spanclass="comment"># (index.html). This can be useful if you have a project on for instance GitHub</span></div>
<divclass="line"><aname="l00919"></a><spanclass="lineno"> 919</span> <spanclass="comment"># and want to reuse the introduction page also for the doxygen output.</span></div>
<divclass="line"><aname="l00924"></a><spanclass="lineno"> 924</span> <spanclass="comment"># Configuration options related to source browsing</span></div>
<divclass="line"><aname="l00927"></a><spanclass="lineno"> 927</span> <spanclass="comment"># If the SOURCE_BROWSER tag is set to YES then a list of source files will be</span></div>
<divclass="line"><aname="l00928"></a><spanclass="lineno"> 928</span> <spanclass="comment"># generated. Documented entities will be cross-referenced with these sources.</span></div>
<divclass="line"><aname="l00930"></a><spanclass="lineno"> 930</span> <spanclass="comment"># Note: To get rid of all source code in the generated output, make sure that</span></div>
<divclass="line"><aname="l00931"></a><spanclass="lineno"> 931</span> <spanclass="comment"># also VERBATIM_HEADERS is set to NO.</span></div>
<divclass="line"><aname="l00932"></a><spanclass="lineno"> 932</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l00936"></a><spanclass="lineno"> 936</span> <spanclass="comment"># Setting the INLINE_SOURCES tag to YES will include the body of functions,</span></div>
<divclass="line"><aname="l00937"></a><spanclass="lineno"> 937</span> <spanclass="comment"># classes and enums directly into the documentation.</span></div>
<divclass="line"><aname="l00938"></a><spanclass="lineno"> 938</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l00942"></a><spanclass="lineno"> 942</span> <spanclass="comment"># Setting the STRIP_CODE_COMMENTS tag to YES will instruct doxygen to hide any</span></div>
<divclass="line"><aname="l00943"></a><spanclass="lineno"> 943</span> <spanclass="comment"># special comment blocks from generated source code fragments. Normal C, C++ and</span></div>
<divclass="line"><aname="l00944"></a><spanclass="lineno"> 944</span> <spanclass="comment"># Fortran comments will always remain visible.</span></div>
<divclass="line"><aname="l00945"></a><spanclass="lineno"> 945</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l00949"></a><spanclass="lineno"> 949</span> <spanclass="comment"># If the REFERENCED_BY_RELATION tag is set to YES then for each documented</span></div>
<divclass="line"><aname="l00950"></a><spanclass="lineno"> 950</span> <spanclass="comment"># function all documented functions referencing it will be listed.</span></div>
<divclass="line"><aname="l00951"></a><spanclass="lineno"> 951</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l00955"></a><spanclass="lineno"> 955</span> <spanclass="comment"># If the REFERENCES_RELATION tag is set to YES then for each documented function</span></div>
<divclass="line"><aname="l00956"></a><spanclass="lineno"> 956</span> <spanclass="comment"># all documented entities called/used by that function will be listed.</span></div>
<divclass="line"><aname="l00957"></a><spanclass="lineno"> 957</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l00961"></a><spanclass="lineno"> 961</span> <spanclass="comment"># If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set</span></div>
<divclass="line"><aname="l00962"></a><spanclass="lineno"> 962</span> <spanclass="comment"># to YES then the hyperlinks from functions in REFERENCES_RELATION and</span></div>
<divclass="line"><aname="l00963"></a><spanclass="lineno"> 963</span> <spanclass="comment"># REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will</span></div>
<divclass="line"><aname="l00964"></a><spanclass="lineno"> 964</span> <spanclass="comment"># link to the documentation.</span></div>
<divclass="line"><aname="l00965"></a><spanclass="lineno"> 965</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l00969"></a><spanclass="lineno"> 969</span> <spanclass="comment"># If SOURCE_TOOLTIPS is enabled (the default) then hovering a hyperlink in the</span></div>
<divclass="line"><aname="l00970"></a><spanclass="lineno"> 970</span> <spanclass="comment"># source code will show a tooltip with additional information such as prototype,</span></div>
<divclass="line"><aname="l00971"></a><spanclass="lineno"> 971</span> <spanclass="comment"># brief description and links to the definition and documentation. Since this</span></div>
<divclass="line"><aname="l00972"></a><spanclass="lineno"> 972</span> <spanclass="comment"># will make the HTML file larger and loading of large files a bit slower, you</span></div>
<divclass="line"><aname="l00973"></a><spanclass="lineno"> 973</span> <spanclass="comment"># can opt to disable this feature.</span></div>
<divclass="line"><aname="l00974"></a><spanclass="lineno"> 974</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l00975"></a><spanclass="lineno"> 975</span> <spanclass="comment"># This tag requires that the tag SOURCE_BROWSER is set to YES.</span></div>
<divclass="line"><aname="l00979"></a><spanclass="lineno"> 979</span> <spanclass="comment"># If the USE_HTAGS tag is set to YES then the references to source code will</span></div>
<divclass="line"><aname="l00980"></a><spanclass="lineno"> 980</span> <spanclass="comment"># point to the HTML generated by the htags(1) tool instead of doxygen built-in</span></div>
<divclass="line"><aname="l00981"></a><spanclass="lineno"> 981</span> <spanclass="comment"># source browser. The htags tool is part of GNU's global source tagging system</span></div>
<divclass="line"><aname="l00982"></a><spanclass="lineno"> 982</span> <spanclass="comment"># (see http://www.gnu.org/software/global/global.html). You will need version</span></div>
<divclass="line"><aname="l00983"></a><spanclass="lineno"> 983</span> <spanclass="comment"># 4.8.6 or higher.</span></div>
<divclass="line"><aname="l00985"></a><spanclass="lineno"> 985</span> <spanclass="comment"># To use it do the following:</span></div>
<divclass="line"><aname="l00986"></a><spanclass="lineno"> 986</span> <spanclass="comment"># - Install the latest version of global</span></div>
<divclass="line"><aname="l00987"></a><spanclass="lineno"> 987</span> <spanclass="comment"># - Enable SOURCE_BROWSER and USE_HTAGS in the config file</span></div>
<divclass="line"><aname="l00988"></a><spanclass="lineno"> 988</span> <spanclass="comment"># - Make sure the INPUT points to the root of the source tree</span></div>
<divclass="line"><aname="l00989"></a><spanclass="lineno"> 989</span> <spanclass="comment"># - Run doxygen as normal</span></div>
<divclass="line"><aname="l00991"></a><spanclass="lineno"> 991</span> <spanclass="comment"># Doxygen will invoke htags (and that will in turn invoke gtags), so these</span></div>
<divclass="line"><aname="l00992"></a><spanclass="lineno"> 992</span> <spanclass="comment"># tools must be available from the command line (i.e. in the search path).</span></div>
<divclass="line"><aname="l00994"></a><spanclass="lineno"> 994</span> <spanclass="comment"># The result: instead of the source browser generated by doxygen, the links to</span></div>
<divclass="line"><aname="l00995"></a><spanclass="lineno"> 995</span> <spanclass="comment"># source code will now point to the output of htags.</span></div>
<divclass="line"><aname="l00996"></a><spanclass="lineno"> 996</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l00997"></a><spanclass="lineno"> 997</span> <spanclass="comment"># This tag requires that the tag SOURCE_BROWSER is set to YES.</span></div>
<divclass="line"><aname="l01001"></a><spanclass="lineno"> 1001</span> <spanclass="comment"># If the VERBATIM_HEADERS tag is set the YES then doxygen will generate a</span></div>
<divclass="line"><aname="l01002"></a><spanclass="lineno"> 1002</span> <spanclass="comment"># verbatim copy of the header file for each class for which an include is</span></div>
<divclass="line"><aname="l01003"></a><spanclass="lineno"> 1003</span> <spanclass="comment"># specified. Set to NO to disable this.</span></div>
<divclass="line"><aname="l01004"></a><spanclass="lineno"> 1004</span> <spanclass="comment"># See also: Section \class.</span></div>
<divclass="line"><aname="l01005"></a><spanclass="lineno"> 1005</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01009"></a><spanclass="lineno"> 1009</span> <spanclass="comment"># If the CLANG_ASSISTED_PARSING tag is set to YES then doxygen will use the</span></div>
<divclass="line"><aname="l01010"></a><spanclass="lineno"> 1010</span> <spanclass="comment"># clang parser (see: http://clang.llvm.org/) for more accurate parsing at the</span></div>
<divclass="line"><aname="l01011"></a><spanclass="lineno"> 1011</span> <spanclass="comment"># cost of reduced performance. This can be particularly helpful with template</span></div>
<divclass="line"><aname="l01012"></a><spanclass="lineno"> 1012</span> <spanclass="comment"># rich C++ code for which doxygen's built-in parser lacks the necessary type</span></div>
<divclass="line"><aname="l01014"></a><spanclass="lineno"> 1014</span> <spanclass="comment"># Note: The availability of this option depends on whether or not doxygen was</span></div>
<divclass="line"><aname="l01015"></a><spanclass="lineno"> 1015</span> <spanclass="comment"># compiled with the --with-libclang option.</span></div>
<divclass="line"><aname="l01016"></a><spanclass="lineno"> 1016</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01020"></a><spanclass="lineno"> 1020</span> <spanclass="comment"># If clang assisted parsing is enabled you can provide the compiler with command</span></div>
<divclass="line"><aname="l01021"></a><spanclass="lineno"> 1021</span> <spanclass="comment"># line options that you would normally use when invoking the compiler. Note that</span></div>
<divclass="line"><aname="l01022"></a><spanclass="lineno"> 1022</span> <spanclass="comment"># the include paths will already be set by doxygen for the files and directories</span></div>
<divclass="line"><aname="l01023"></a><spanclass="lineno"> 1023</span> <spanclass="comment"># specified with INPUT and INCLUDE_PATH.</span></div>
<divclass="line"><aname="l01024"></a><spanclass="lineno"> 1024</span> <spanclass="comment"># This tag requires that the tag CLANG_ASSISTED_PARSING is set to YES.</span></div>
<divclass="line"><aname="l01029"></a><spanclass="lineno"> 1029</span> <spanclass="comment"># Configuration options related to the alphabetical class index</span></div>
<divclass="line"><aname="l01032"></a><spanclass="lineno"> 1032</span> <spanclass="comment"># If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index of all</span></div>
<divclass="line"><aname="l01033"></a><spanclass="lineno"> 1033</span> <spanclass="comment"># compounds will be generated. Enable this if the project contains a lot of</span></div>
<divclass="line"><aname="l01034"></a><spanclass="lineno"> 1034</span> <spanclass="comment"># classes, structs, unions or interfaces.</span></div>
<divclass="line"><aname="l01035"></a><spanclass="lineno"> 1035</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01039"></a><spanclass="lineno"> 1039</span> <spanclass="comment"># The COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns in</span></div>
<divclass="line"><aname="l01040"></a><spanclass="lineno"> 1040</span> <spanclass="comment"># which the alphabetical index list will be split.</span></div>
<divclass="line"><aname="l01042"></a><spanclass="lineno"> 1042</span> <spanclass="comment"># This tag requires that the tag ALPHABETICAL_INDEX is set to YES.</span></div>
<divclass="line"><aname="l01046"></a><spanclass="lineno"> 1046</span> <spanclass="comment"># In case all classes in a project start with a common prefix, all classes will</span></div>
<divclass="line"><aname="l01047"></a><spanclass="lineno"> 1047</span> <spanclass="comment"># be put under the same header in the alphabetical index. The IGNORE_PREFIX tag</span></div>
<divclass="line"><aname="l01048"></a><spanclass="lineno"> 1048</span> <spanclass="comment"># can be used to specify a prefix (or a list of prefixes) that should be ignored</span></div>
<divclass="line"><aname="l01049"></a><spanclass="lineno"> 1049</span> <spanclass="comment"># while generating the index headers.</span></div>
<divclass="line"><aname="l01050"></a><spanclass="lineno"> 1050</span> <spanclass="comment"># This tag requires that the tag ALPHABETICAL_INDEX is set to YES.</span></div>
<divclass="line"><aname="l01055"></a><spanclass="lineno"> 1055</span> <spanclass="comment"># Configuration options related to the HTML output</span></div>
<divclass="line"><aname="l01058"></a><spanclass="lineno"> 1058</span> <spanclass="comment"># If the GENERATE_HTML tag is set to YES, doxygen will generate HTML output</span></div>
<divclass="line"><aname="l01059"></a><spanclass="lineno"> 1059</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01063"></a><spanclass="lineno"> 1063</span> <spanclass="comment"># The HTML_OUTPUT tag is used to specify where the HTML docs will be put. If a</span></div>
<divclass="line"><aname="l01064"></a><spanclass="lineno"> 1064</span> <spanclass="comment"># relative path is entered the value of OUTPUT_DIRECTORY will be put in front of</span></div>
<divclass="line"><aname="l01066"></a><spanclass="lineno"> 1066</span> <spanclass="comment"># The default directory is: html.</span></div>
<divclass="line"><aname="l01067"></a><spanclass="lineno"> 1067</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01071"></a><spanclass="lineno"> 1071</span> <spanclass="comment"># The HTML_FILE_EXTENSION tag can be used to specify the file extension for each</span></div>
<divclass="line"><aname="l01072"></a><spanclass="lineno"> 1072</span> <spanclass="comment"># generated HTML page (for example: .htm, .php, .asp).</span></div>
<divclass="line"><aname="l01073"></a><spanclass="lineno"> 1073</span> <spanclass="comment"># The default value is: .html.</span></div>
<divclass="line"><aname="l01074"></a><spanclass="lineno"> 1074</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01078"></a><spanclass="lineno"> 1078</span> <spanclass="comment"># The HTML_HEADER tag can be used to specify a user-defined HTML header file for</span></div>
<divclass="line"><aname="l01079"></a><spanclass="lineno"> 1079</span> <spanclass="comment"># each generated HTML page. If the tag is left blank doxygen will generate a</span></div>
<divclass="line"><aname="l01080"></a><spanclass="lineno"> 1080</span> <spanclass="comment"># standard header.</span></div>
<divclass="line"><aname="l01082"></a><spanclass="lineno"> 1082</span> <spanclass="comment"># To get valid HTML the header file that includes any scripts and style sheets</span></div>
<divclass="line"><aname="l01083"></a><spanclass="lineno"> 1083</span> <spanclass="comment"># that doxygen needs, which is dependent on the configuration options used (e.g.</span></div>
<divclass="line"><aname="l01084"></a><spanclass="lineno"> 1084</span> <spanclass="comment"># the setting GENERATE_TREEVIEW). It is highly recommended to start with a</span></div>
<divclass="line"><aname="l01088"></a><spanclass="lineno"> 1088</span> <spanclass="comment"># and then modify the file new_header.html. See also section "Doxygen usage"</span></div>
<divclass="line"><aname="l01089"></a><spanclass="lineno"> 1089</span> <spanclass="comment"># for information on how to generate the default header that doxygen normally</span></div>
<divclass="line"><aname="l01091"></a><spanclass="lineno"> 1091</span> <spanclass="comment"># Note: The header is subject to change so you typically have to regenerate the</span></div>
<divclass="line"><aname="l01092"></a><spanclass="lineno"> 1092</span> <spanclass="comment"># default header when upgrading to a newer version of doxygen. For a description</span></div>
<divclass="line"><aname="l01093"></a><spanclass="lineno"> 1093</span> <spanclass="comment"># of the possible markers and block names see the documentation.</span></div>
<divclass="line"><aname="l01094"></a><spanclass="lineno"> 1094</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01098"></a><spanclass="lineno"> 1098</span> <spanclass="comment"># The HTML_FOOTER tag can be used to specify a user-defined HTML footer for each</span></div>
<divclass="line"><aname="l01099"></a><spanclass="lineno"> 1099</span> <spanclass="comment"># generated HTML page. If the tag is left blank doxygen will generate a standard</span></div>
<divclass="line"><aname="l01100"></a><spanclass="lineno"> 1100</span> <spanclass="comment"># footer. See HTML_HEADER for more information on how to generate a default</span></div>
<divclass="line"><aname="l01101"></a><spanclass="lineno"> 1101</span> <spanclass="comment"># footer and what special commands can be used inside the footer. See also</span></div>
<divclass="line"><aname="l01102"></a><spanclass="lineno"> 1102</span> <spanclass="comment"># section "Doxygen usage" for information on how to generate the default footer</span></div>
<divclass="line"><aname="l01103"></a><spanclass="lineno"> 1103</span> <spanclass="comment"># that doxygen normally uses.</span></div>
<divclass="line"><aname="l01104"></a><spanclass="lineno"> 1104</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01108"></a><spanclass="lineno"> 1108</span> <spanclass="comment"># The HTML_STYLESHEET tag can be used to specify a user-defined cascading style</span></div>
<divclass="line"><aname="l01109"></a><spanclass="lineno"> 1109</span> <spanclass="comment"># sheet that is used by each HTML page. It can be used to fine-tune the look of</span></div>
<divclass="line"><aname="l01110"></a><spanclass="lineno"> 1110</span> <spanclass="comment"># the HTML output. If left blank doxygen will generate a default style sheet.</span></div>
<divclass="line"><aname="l01111"></a><spanclass="lineno"> 1111</span> <spanclass="comment"># See also section "Doxygen usage" for information on how to generate the style</span></div>
<divclass="line"><aname="l01112"></a><spanclass="lineno"> 1112</span> <spanclass="comment"># sheet that doxygen normally uses.</span></div>
<divclass="line"><aname="l01113"></a><spanclass="lineno"> 1113</span> <spanclass="comment"># Note: It is recommended to use HTML_EXTRA_STYLESHEET instead of this tag, as</span></div>
<divclass="line"><aname="l01114"></a><spanclass="lineno"> 1114</span> <spanclass="comment"># it is more robust and this tag (HTML_STYLESHEET) will in the future become</span></div>
<divclass="line"><aname="l01116"></a><spanclass="lineno"> 1116</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01120"></a><spanclass="lineno"> 1120</span> <spanclass="comment"># The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined</span></div>
<divclass="line"><aname="l01121"></a><spanclass="lineno"> 1121</span> <spanclass="comment"># cascading style sheets that are included after the standard style sheets</span></div>
<divclass="line"><aname="l01122"></a><spanclass="lineno"> 1122</span> <spanclass="comment"># created by doxygen. Using this option one can overrule certain style aspects.</span></div>
<divclass="line"><aname="l01123"></a><spanclass="lineno"> 1123</span> <spanclass="comment"># This is preferred over using HTML_STYLESHEET since it does not replace the</span></div>
<divclass="line"><aname="l01124"></a><spanclass="lineno"> 1124</span> <spanclass="comment"># standard style sheet and is therefore more robust against future updates.</span></div>
<divclass="line"><aname="l01125"></a><spanclass="lineno"> 1125</span> <spanclass="comment"># Doxygen will copy the style sheet files to the output directory.</span></div>
<divclass="line"><aname="l01126"></a><spanclass="lineno"> 1126</span> <spanclass="comment"># Note: The order of the extra style sheet files is of importance (e.g. the last</span></div>
<divclass="line"><aname="l01127"></a><spanclass="lineno"> 1127</span> <spanclass="comment"># style sheet in the list overrules the setting of the previous ones in the</span></div>
<divclass="line"><aname="l01128"></a><spanclass="lineno"> 1128</span> <spanclass="comment"># list). For an example see the documentation.</span></div>
<divclass="line"><aname="l01129"></a><spanclass="lineno"> 1129</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01133"></a><spanclass="lineno"> 1133</span> <spanclass="comment"># The HTML_EXTRA_FILES tag can be used to specify one or more extra images or</span></div>
<divclass="line"><aname="l01134"></a><spanclass="lineno"> 1134</span> <spanclass="comment"># other source files which should be copied to the HTML output directory. Note</span></div>
<divclass="line"><aname="l01135"></a><spanclass="lineno"> 1135</span> <spanclass="comment"># that these files will be copied to the base HTML output directory. Use the</span></div>
<divclass="line"><aname="l01136"></a><spanclass="lineno"> 1136</span> <spanclass="comment"># $relpath^ marker in the HTML_HEADER and/or HTML_FOOTER files to load these</span></div>
<divclass="line"><aname="l01137"></a><spanclass="lineno"> 1137</span> <spanclass="comment"># files. In the HTML_STYLESHEET file, use the file name only. Also note that the</span></div>
<divclass="line"><aname="l01138"></a><spanclass="lineno"> 1138</span> <spanclass="comment"># files will be copied as-is; there are no commands or markers available.</span></div>
<divclass="line"><aname="l01139"></a><spanclass="lineno"> 1139</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01143"></a><spanclass="lineno"> 1143</span> <spanclass="comment"># The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen</span></div>
<divclass="line"><aname="l01144"></a><spanclass="lineno"> 1144</span> <spanclass="comment"># will adjust the colors in the style sheet and background images according to</span></div>
<divclass="line"><aname="l01145"></a><spanclass="lineno"> 1145</span> <spanclass="comment"># this color. Hue is specified as an angle on a colorwheel, see</span></div>
<divclass="line"><aname="l01146"></a><spanclass="lineno"> 1146</span> <spanclass="comment"># http://en.wikipedia.org/wiki/Hue for more information. For instance the value</span></div>
<divclass="line"><aname="l01147"></a><spanclass="lineno"> 1147</span> <spanclass="comment"># 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300</span></div>
<divclass="line"><aname="l01148"></a><spanclass="lineno"> 1148</span> <spanclass="comment"># purple, and 360 is red again.</span></div>
<divclass="line"><aname="l01150"></a><spanclass="lineno"> 1150</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01154"></a><spanclass="lineno"> 1154</span> <spanclass="comment"># The HTML_COLORSTYLE_SAT tag controls the purity (or saturation) of the colors</span></div>
<divclass="line"><aname="l01155"></a><spanclass="lineno"> 1155</span> <spanclass="comment"># in the HTML output. For a value of 0 the output will use grayscales only. A</span></div>
<divclass="line"><aname="l01156"></a><spanclass="lineno"> 1156</span> <spanclass="comment"># value of 255 will produce the most vivid colors.</span></div>
<divclass="line"><aname="l01158"></a><spanclass="lineno"> 1158</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01162"></a><spanclass="lineno"> 1162</span> <spanclass="comment"># The HTML_COLORSTYLE_GAMMA tag controls the gamma correction applied to the</span></div>
<divclass="line"><aname="l01163"></a><spanclass="lineno"> 1163</span> <spanclass="comment"># luminance component of the colors in the HTML output. Values below 100</span></div>
<divclass="line"><aname="l01164"></a><spanclass="lineno"> 1164</span> <spanclass="comment"># gradually make the output lighter, whereas values above 100 make the output</span></div>
<divclass="line"><aname="l01165"></a><spanclass="lineno"> 1165</span> <spanclass="comment"># darker. The value divided by 100 is the actual gamma applied, so 80 represents</span></div>
<divclass="line"><aname="l01166"></a><spanclass="lineno"> 1166</span> <spanclass="comment"># a gamma of 0.8, The value 220 represents a gamma of 2.2, and 100 does not</span></div>
<divclass="line"><aname="l01167"></a><spanclass="lineno"> 1167</span> <spanclass="comment"># change the gamma.</span></div>
<divclass="line"><aname="l01169"></a><spanclass="lineno"> 1169</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01173"></a><spanclass="lineno"> 1173</span> <spanclass="comment"># If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML</span></div>
<divclass="line"><aname="l01174"></a><spanclass="lineno"> 1174</span> <spanclass="comment"># page will contain the date and time when the page was generated. Setting this</span></div>
<divclass="line"><aname="l01175"></a><spanclass="lineno"> 1175</span> <spanclass="comment"># to YES can help to show when doxygen was last run and thus if the</span></div>
<divclass="line"><aname="l01176"></a><spanclass="lineno"> 1176</span> <spanclass="comment"># documentation is up to date.</span></div>
<divclass="line"><aname="l01177"></a><spanclass="lineno"> 1177</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01178"></a><spanclass="lineno"> 1178</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01182"></a><spanclass="lineno"> 1182</span> <spanclass="comment"># If the HTML_DYNAMIC_SECTIONS tag is set to YES then the generated HTML</span></div>
<divclass="line"><aname="l01183"></a><spanclass="lineno"> 1183</span> <spanclass="comment"># documentation will contain sections that can be hidden and shown after the</span></div>
<divclass="line"><aname="l01184"></a><spanclass="lineno"> 1184</span> <spanclass="comment"># page has loaded.</span></div>
<divclass="line"><aname="l01185"></a><spanclass="lineno"> 1185</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01186"></a><spanclass="lineno"> 1186</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01190"></a><spanclass="lineno"> 1190</span> <spanclass="comment"># With HTML_INDEX_NUM_ENTRIES one can control the preferred number of entries</span></div>
<divclass="line"><aname="l01191"></a><spanclass="lineno"> 1191</span> <spanclass="comment"># shown in the various tree structured indices initially; the user can expand</span></div>
<divclass="line"><aname="l01192"></a><spanclass="lineno"> 1192</span> <spanclass="comment"># and collapse entries dynamically later on. Doxygen will expand the tree to</span></div>
<divclass="line"><aname="l01193"></a><spanclass="lineno"> 1193</span> <spanclass="comment"># such a level that at most the specified number of entries are visible (unless</span></div>
<divclass="line"><aname="l01194"></a><spanclass="lineno"> 1194</span> <spanclass="comment"># a fully collapsed tree already exceeds this amount). So setting the number of</span></div>
<divclass="line"><aname="l01195"></a><spanclass="lineno"> 1195</span> <spanclass="comment"># entries 1 will produce a full collapsed tree by default. 0 is a special value</span></div>
<divclass="line"><aname="l01196"></a><spanclass="lineno"> 1196</span> <spanclass="comment"># representing an infinite number of entries and will result in a full expanded</span></div>
<divclass="line"><aname="l01197"></a><spanclass="lineno"> 1197</span> <spanclass="comment"># tree by default.</span></div>
<divclass="line"><aname="l01199"></a><spanclass="lineno"> 1199</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01203"></a><spanclass="lineno"> 1203</span> <spanclass="comment"># If the GENERATE_DOCSET tag is set to YES, additional index files will be</span></div>
<divclass="line"><aname="l01204"></a><spanclass="lineno"> 1204</span> <spanclass="comment"># generated that can be used as input for Apple's Xcode 3 integrated development</span></div>
<divclass="line"><aname="l01206"></a><spanclass="lineno"> 1206</span> <spanclass="comment"># OSX 10.5 (Leopard). To create a documentation set, doxygen will generate a</span></div>
<divclass="line"><aname="l01207"></a><spanclass="lineno"> 1207</span> <spanclass="comment"># Makefile in the HTML output directory. Running make will produce the docset in</span></div>
<divclass="line"><aname="l01208"></a><spanclass="lineno"> 1208</span> <spanclass="comment"># that directory and running make install will install the docset in</span></div>
<divclass="line"><aname="l01209"></a><spanclass="lineno"> 1209</span> <spanclass="comment"># ~/Library/Developer/Shared/Documentation/DocSets so that Xcode will find it at</span></div>
<divclass="line"><aname="l01210"></a><spanclass="lineno"> 1210</span> <spanclass="comment"># startup. See http://developer.apple.com/tools/creatingdocsetswithdoxygen.html</span></div>
<divclass="line"><aname="l01211"></a><spanclass="lineno"> 1211</span> <spanclass="comment"># for more information.</span></div>
<divclass="line"><aname="l01212"></a><spanclass="lineno"> 1212</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01213"></a><spanclass="lineno"> 1213</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01217"></a><spanclass="lineno"> 1217</span> <spanclass="comment"># This tag determines the name of the docset feed. A documentation feed provides</span></div>
<divclass="line"><aname="l01218"></a><spanclass="lineno"> 1218</span> <spanclass="comment"># an umbrella under which multiple documentation sets from a single provider</span></div>
<divclass="line"><aname="l01219"></a><spanclass="lineno"> 1219</span> <spanclass="comment"># (such as a company or product suite) can be grouped.</span></div>
<divclass="line"><aname="l01220"></a><spanclass="lineno"> 1220</span> <spanclass="comment"># The default value is: Doxygen generated docs.</span></div>
<divclass="line"><aname="l01221"></a><spanclass="lineno"> 1221</span> <spanclass="comment"># This tag requires that the tag GENERATE_DOCSET is set to YES.</span></div>
<divclass="line"><aname="l01225"></a><spanclass="lineno"> 1225</span> <spanclass="comment"># This tag specifies a string that should uniquely identify the documentation</span></div>
<divclass="line"><aname="l01226"></a><spanclass="lineno"> 1226</span> <spanclass="comment"># set bundle. This should be a reverse domain-name style string, e.g.</span></div>
<divclass="line"><aname="l01227"></a><spanclass="lineno"> 1227</span> <spanclass="comment"># com.mycompany.MyDocSet. Doxygen will append .docset to the name.</span></div>
<divclass="line"><aname="l01228"></a><spanclass="lineno"> 1228</span> <spanclass="comment"># The default value is: org.doxygen.Project.</span></div>
<divclass="line"><aname="l01229"></a><spanclass="lineno"> 1229</span> <spanclass="comment"># This tag requires that the tag GENERATE_DOCSET is set to YES.</span></div>
<divclass="line"><aname="l01233"></a><spanclass="lineno"> 1233</span> <spanclass="comment"># The DOCSET_PUBLISHER_ID tag specifies a string that should uniquely identify</span></div>
<divclass="line"><aname="l01234"></a><spanclass="lineno"> 1234</span> <spanclass="comment"># the documentation publisher. This should be a reverse domain-name style</span></div>
<divclass="line"><aname="l01235"></a><spanclass="lineno"> 1235</span> <spanclass="comment"># string, e.g. com.mycompany.MyDocSet.documentation.</span></div>
<divclass="line"><aname="l01236"></a><spanclass="lineno"> 1236</span> <spanclass="comment"># The default value is: org.doxygen.Publisher.</span></div>
<divclass="line"><aname="l01237"></a><spanclass="lineno"> 1237</span> <spanclass="comment"># This tag requires that the tag GENERATE_DOCSET is set to YES.</span></div>
<divclass="line"><aname="l01241"></a><spanclass="lineno"> 1241</span> <spanclass="comment"># The DOCSET_PUBLISHER_NAME tag identifies the documentation publisher.</span></div>
<divclass="line"><aname="l01242"></a><spanclass="lineno"> 1242</span> <spanclass="comment"># The default value is: Publisher.</span></div>
<divclass="line"><aname="l01243"></a><spanclass="lineno"> 1243</span> <spanclass="comment"># This tag requires that the tag GENERATE_DOCSET is set to YES.</span></div>
<divclass="line"><aname="l01247"></a><spanclass="lineno"> 1247</span> <spanclass="comment"># If the GENERATE_HTMLHELP tag is set to YES then doxygen generates three</span></div>
<divclass="line"><aname="l01248"></a><spanclass="lineno"> 1248</span> <spanclass="comment"># additional HTML index files: index.hhp, index.hhc, and index.hhk. The</span></div>
<divclass="line"><aname="l01249"></a><spanclass="lineno"> 1249</span> <spanclass="comment"># index.hhp is a project file that can be read by Microsoft's HTML Help Workshop</span></div>
<divclass="line"><aname="l01253"></a><spanclass="lineno"> 1253</span> <spanclass="comment"># The HTML Help Workshop contains a compiler that can convert all HTML output</span></div>
<divclass="line"><aname="l01254"></a><spanclass="lineno"> 1254</span> <spanclass="comment"># generated by doxygen into a single compiled HTML file (.chm). Compiled HTML</span></div>
<divclass="line"><aname="l01255"></a><spanclass="lineno"> 1255</span> <spanclass="comment"># files are now used as the Windows 98 help format, and will replace the old</span></div>
<divclass="line"><aname="l01256"></a><spanclass="lineno"> 1256</span> <spanclass="comment"># Windows help format (.hlp) on all Windows platforms in the future. Compressed</span></div>
<divclass="line"><aname="l01257"></a><spanclass="lineno"> 1257</span> <spanclass="comment"># HTML files also contain an index, a table of contents, and you can search for</span></div>
<divclass="line"><aname="l01258"></a><spanclass="lineno"> 1258</span> <spanclass="comment"># words in the documentation. The HTML workshop also contains a viewer for</span></div>
<divclass="line"><aname="l01259"></a><spanclass="lineno"> 1259</span> <spanclass="comment"># compressed HTML files.</span></div>
<divclass="line"><aname="l01260"></a><spanclass="lineno"> 1260</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01261"></a><spanclass="lineno"> 1261</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01265"></a><spanclass="lineno"> 1265</span> <spanclass="comment"># The CHM_FILE tag can be used to specify the file name of the resulting .chm</span></div>
<divclass="line"><aname="l01266"></a><spanclass="lineno"> 1266</span> <spanclass="comment"># file. You can add a path in front of the file if the result should not be</span></div>
<divclass="line"><aname="l01267"></a><spanclass="lineno"> 1267</span> <spanclass="comment"># written to the html output directory.</span></div>
<divclass="line"><aname="l01268"></a><spanclass="lineno"> 1268</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTMLHELP is set to YES.</span></div>
<divclass="line"><aname="l01272"></a><spanclass="lineno"> 1272</span> <spanclass="comment"># The HHC_LOCATION tag can be used to specify the location (absolute path</span></div>
<divclass="line"><aname="l01273"></a><spanclass="lineno"> 1273</span> <spanclass="comment"># including file name) of the HTML help compiler (hhc.exe). If non-empty,</span></div>
<divclass="line"><aname="l01274"></a><spanclass="lineno"> 1274</span> <spanclass="comment"># doxygen will try to run the HTML help compiler on the generated index.hhp.</span></div>
<divclass="line"><aname="l01275"></a><spanclass="lineno"> 1275</span> <spanclass="comment"># The file has to be specified with full path.</span></div>
<divclass="line"><aname="l01276"></a><spanclass="lineno"> 1276</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTMLHELP is set to YES.</span></div>
<divclass="line"><aname="l01280"></a><spanclass="lineno"> 1280</span> <spanclass="comment"># The GENERATE_CHI flag controls if a separate .chi index file is generated</span></div>
<divclass="line"><aname="l01281"></a><spanclass="lineno"> 1281</span> <spanclass="comment"># (YES) or that it should be included in the master .chm file (NO).</span></div>
<divclass="line"><aname="l01282"></a><spanclass="lineno"> 1282</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01283"></a><spanclass="lineno"> 1283</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTMLHELP is set to YES.</span></div>
<divclass="line"><aname="l01287"></a><spanclass="lineno"> 1287</span> <spanclass="comment"># The CHM_INDEX_ENCODING is used to encode HtmlHelp index (hhk), content (hhc)</span></div>
<divclass="line"><aname="l01288"></a><spanclass="lineno"> 1288</span> <spanclass="comment"># and project file content.</span></div>
<divclass="line"><aname="l01289"></a><spanclass="lineno"> 1289</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTMLHELP is set to YES.</span></div>
<divclass="line"><aname="l01293"></a><spanclass="lineno"> 1293</span> <spanclass="comment"># The BINARY_TOC flag controls whether a binary table of contents is generated</span></div>
<divclass="line"><aname="l01294"></a><spanclass="lineno"> 1294</span> <spanclass="comment"># (YES) or a normal table of contents (NO) in the .chm file. Furthermore it</span></div>
<divclass="line"><aname="l01295"></a><spanclass="lineno"> 1295</span> <spanclass="comment"># enables the Previous and Next buttons.</span></div>
<divclass="line"><aname="l01296"></a><spanclass="lineno"> 1296</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01297"></a><spanclass="lineno"> 1297</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTMLHELP is set to YES.</span></div>
<divclass="line"><aname="l01301"></a><spanclass="lineno"> 1301</span> <spanclass="comment"># The TOC_EXPAND flag can be set to YES to add extra items for group members to</span></div>
<divclass="line"><aname="l01302"></a><spanclass="lineno"> 1302</span> <spanclass="comment"># the table of contents of the HTML help documentation and to the tree view.</span></div>
<divclass="line"><aname="l01303"></a><spanclass="lineno"> 1303</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01304"></a><spanclass="lineno"> 1304</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTMLHELP is set to YES.</span></div>
<divclass="line"><aname="l01308"></a><spanclass="lineno"> 1308</span> <spanclass="comment"># If the GENERATE_QHP tag is set to YES and both QHP_NAMESPACE and</span></div>
<divclass="line"><aname="l01309"></a><spanclass="lineno"> 1309</span> <spanclass="comment"># QHP_VIRTUAL_FOLDER are set, an additional index file will be generated that</span></div>
<divclass="line"><aname="l01310"></a><spanclass="lineno"> 1310</span> <spanclass="comment"># can be used as input for Qt's qhelpgenerator to generate a Qt Compressed Help</span></div>
<divclass="line"><aname="l01311"></a><spanclass="lineno"> 1311</span> <spanclass="comment"># (.qch) of the generated HTML documentation.</span></div>
<divclass="line"><aname="l01312"></a><spanclass="lineno"> 1312</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01313"></a><spanclass="lineno"> 1313</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01317"></a><spanclass="lineno"> 1317</span> <spanclass="comment"># If the QHG_LOCATION tag is specified, the QCH_FILE tag can be used to specify</span></div>
<divclass="line"><aname="l01318"></a><spanclass="lineno"> 1318</span> <spanclass="comment"># the file name of the resulting .qch file. The path specified is relative to</span></div>
<divclass="line"><aname="l01319"></a><spanclass="lineno"> 1319</span> <spanclass="comment"># the HTML output folder.</span></div>
<divclass="line"><aname="l01320"></a><spanclass="lineno"> 1320</span> <spanclass="comment"># This tag requires that the tag GENERATE_QHP is set to YES.</span></div>
<divclass="line"><aname="l01324"></a><spanclass="lineno"> 1324</span> <spanclass="comment"># The QHP_NAMESPACE tag specifies the namespace to use when generating Qt Help</span></div>
<divclass="line"><aname="l01325"></a><spanclass="lineno"> 1325</span> <spanclass="comment"># Project output. For more information please see Qt Help Project / Namespace</span></div>
<divclass="line"><aname="l01327"></a><spanclass="lineno"> 1327</span> <spanclass="comment"># The default value is: org.doxygen.Project.</span></div>
<divclass="line"><aname="l01328"></a><spanclass="lineno"> 1328</span> <spanclass="comment"># This tag requires that the tag GENERATE_QHP is set to YES.</span></div>
<divclass="line"><aname="l01332"></a><spanclass="lineno"> 1332</span> <spanclass="comment"># The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating Qt</span></div>
<divclass="line"><aname="l01333"></a><spanclass="lineno"> 1333</span> <spanclass="comment"># Help Project output. For more information please see Qt Help Project / Virtual</span></div>
<divclass="line"><aname="l01336"></a><spanclass="lineno"> 1336</span> <spanclass="comment"># The default value is: doc.</span></div>
<divclass="line"><aname="l01337"></a><spanclass="lineno"> 1337</span> <spanclass="comment"># This tag requires that the tag GENERATE_QHP is set to YES.</span></div>
<divclass="line"><aname="l01341"></a><spanclass="lineno"> 1341</span> <spanclass="comment"># If the QHP_CUST_FILTER_NAME tag is set, it specifies the name of a custom</span></div>
<divclass="line"><aname="l01342"></a><spanclass="lineno"> 1342</span> <spanclass="comment"># filter to add. For more information please see Qt Help Project / Custom</span></div>
<divclass="line"><aname="l01345"></a><spanclass="lineno"> 1345</span> <spanclass="comment"># This tag requires that the tag GENERATE_QHP is set to YES.</span></div>
<divclass="line"><aname="l01349"></a><spanclass="lineno"> 1349</span> <spanclass="comment"># The QHP_CUST_FILTER_ATTRS tag specifies the list of the attributes of the</span></div>
<divclass="line"><aname="l01350"></a><spanclass="lineno"> 1350</span> <spanclass="comment"># custom filter to add. For more information please see Qt Help Project / Custom</span></div>
<divclass="line"><aname="l01353"></a><spanclass="lineno"> 1353</span> <spanclass="comment"># This tag requires that the tag GENERATE_QHP is set to YES.</span></div>
<divclass="line"><aname="l01357"></a><spanclass="lineno"> 1357</span> <spanclass="comment"># The QHP_SECT_FILTER_ATTRS tag specifies the list of the attributes this</span></div>
<divclass="line"><aname="l01360"></a><spanclass="lineno"> 1360</span> <spanclass="comment"># This tag requires that the tag GENERATE_QHP is set to YES.</span></div>
<divclass="line"><aname="l01364"></a><spanclass="lineno"> 1364</span> <spanclass="comment"># The QHG_LOCATION tag can be used to specify the location of Qt's</span></div>
<divclass="line"><aname="l01365"></a><spanclass="lineno"> 1365</span> <spanclass="comment"># qhelpgenerator. If non-empty doxygen will try to run qhelpgenerator on the</span></div>
<divclass="line"><aname="l01367"></a><spanclass="lineno"> 1367</span> <spanclass="comment"># This tag requires that the tag GENERATE_QHP is set to YES.</span></div>
<divclass="line"><aname="l01371"></a><spanclass="lineno"> 1371</span> <spanclass="comment"># If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files will be</span></div>
<divclass="line"><aname="l01372"></a><spanclass="lineno"> 1372</span> <spanclass="comment"># generated, together with the HTML files, they form an Eclipse help plugin. To</span></div>
<divclass="line"><aname="l01373"></a><spanclass="lineno"> 1373</span> <spanclass="comment"># install this plugin and make it available under the help contents menu in</span></div>
<divclass="line"><aname="l01374"></a><spanclass="lineno"> 1374</span> <spanclass="comment"># Eclipse, the contents of the directory containing the HTML and XML files needs</span></div>
<divclass="line"><aname="l01375"></a><spanclass="lineno"> 1375</span> <spanclass="comment"># to be copied into the plugins directory of eclipse. The name of the directory</span></div>
<divclass="line"><aname="l01376"></a><spanclass="lineno"> 1376</span> <spanclass="comment"># within the plugins directory should be the same as the ECLIPSE_DOC_ID value.</span></div>
<divclass="line"><aname="l01377"></a><spanclass="lineno"> 1377</span> <spanclass="comment"># After copying Eclipse needs to be restarted before the help appears.</span></div>
<divclass="line"><aname="l01378"></a><spanclass="lineno"> 1378</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01379"></a><spanclass="lineno"> 1379</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01383"></a><spanclass="lineno"> 1383</span> <spanclass="comment"># A unique identifier for the Eclipse help plugin. When installing the plugin</span></div>
<divclass="line"><aname="l01384"></a><spanclass="lineno"> 1384</span> <spanclass="comment"># the directory name containing the HTML and XML files should also have this</span></div>
<divclass="line"><aname="l01385"></a><spanclass="lineno"> 1385</span> <spanclass="comment"># name. Each documentation set should have its own identifier.</span></div>
<divclass="line"><aname="l01386"></a><spanclass="lineno"> 1386</span> <spanclass="comment"># The default value is: org.doxygen.Project.</span></div>
<divclass="line"><aname="l01387"></a><spanclass="lineno"> 1387</span> <spanclass="comment"># This tag requires that the tag GENERATE_ECLIPSEHELP is set to YES.</span></div>
<divclass="line"><aname="l01391"></a><spanclass="lineno"> 1391</span> <spanclass="comment"># If you want full control over the layout of the generated HTML pages it might</span></div>
<divclass="line"><aname="l01392"></a><spanclass="lineno"> 1392</span> <spanclass="comment"># be necessary to disable the index and replace it with your own. The</span></div>
<divclass="line"><aname="l01393"></a><spanclass="lineno"> 1393</span> <spanclass="comment"># DISABLE_INDEX tag can be used to turn on/off the condensed index (tabs) at top</span></div>
<divclass="line"><aname="l01394"></a><spanclass="lineno"> 1394</span> <spanclass="comment"># of each HTML page. A value of NO enables the index and the value YES disables</span></div>
<divclass="line"><aname="l01395"></a><spanclass="lineno"> 1395</span> <spanclass="comment"># it. Since the tabs in the index contain the same information as the navigation</span></div>
<divclass="line"><aname="l01396"></a><spanclass="lineno"> 1396</span> <spanclass="comment"># tree, you can set this option to YES if you also set GENERATE_TREEVIEW to YES.</span></div>
<divclass="line"><aname="l01397"></a><spanclass="lineno"> 1397</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01398"></a><spanclass="lineno"> 1398</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01402"></a><spanclass="lineno"> 1402</span> <spanclass="comment"># The GENERATE_TREEVIEW tag is used to specify whether a tree-like index</span></div>
<divclass="line"><aname="l01403"></a><spanclass="lineno"> 1403</span> <spanclass="comment"># structure should be generated to display hierarchical information. If the tag</span></div>
<divclass="line"><aname="l01404"></a><spanclass="lineno"> 1404</span> <spanclass="comment"># value is set to YES, a side panel will be generated containing a tree-like</span></div>
<divclass="line"><aname="l01405"></a><spanclass="lineno"> 1405</span> <spanclass="comment"># index structure (just like the one that is generated for HTML Help). For this</span></div>
<divclass="line"><aname="l01406"></a><spanclass="lineno"> 1406</span> <spanclass="comment"># to work a browser that supports JavaScript, DHTML, CSS and frames is required</span></div>
<divclass="line"><aname="l01407"></a><spanclass="lineno"> 1407</span> <spanclass="comment"># (i.e. any modern browser). Windows users are probably better off using the</span></div>
<divclass="line"><aname="l01408"></a><spanclass="lineno"> 1408</span> <spanclass="comment"># HTML help feature. Via custom style sheets (see HTML_EXTRA_STYLESHEET) one can</span></div>
<divclass="line"><aname="l01409"></a><spanclass="lineno"> 1409</span> <spanclass="comment"># further fine-tune the look of the index. As an example, the default style</span></div>
<divclass="line"><aname="l01410"></a><spanclass="lineno"> 1410</span> <spanclass="comment"># sheet generated by doxygen has an example that shows how to put an image at</span></div>
<divclass="line"><aname="l01411"></a><spanclass="lineno"> 1411</span> <spanclass="comment"># the root of the tree instead of the PROJECT_NAME. Since the tree basically has</span></div>
<divclass="line"><aname="l01412"></a><spanclass="lineno"> 1412</span> <spanclass="comment"># the same information as the tab index, you could consider setting</span></div>
<divclass="line"><aname="l01413"></a><spanclass="lineno"> 1413</span> <spanclass="comment"># DISABLE_INDEX to YES when enabling this option.</span></div>
<divclass="line"><aname="l01414"></a><spanclass="lineno"> 1414</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01415"></a><spanclass="lineno"> 1415</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01419"></a><spanclass="lineno"> 1419</span> <spanclass="comment"># The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that</span></div>
<divclass="line"><aname="l01420"></a><spanclass="lineno"> 1420</span> <spanclass="comment"># doxygen will group on one line in the generated HTML documentation.</span></div>
<divclass="line"><aname="l01422"></a><spanclass="lineno"> 1422</span> <spanclass="comment"># Note that a value of 0 will completely suppress the enum values from appearing</span></div>
<divclass="line"><aname="l01423"></a><spanclass="lineno"> 1423</span> <spanclass="comment"># in the overview section.</span></div>
<divclass="line"><aname="l01425"></a><spanclass="lineno"> 1425</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01429"></a><spanclass="lineno"> 1429</span> <spanclass="comment"># If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be used</span></div>
<divclass="line"><aname="l01430"></a><spanclass="lineno"> 1430</span> <spanclass="comment"># to set the initial width (in pixels) of the frame in which the tree is shown.</span></div>
<divclass="line"><aname="l01432"></a><spanclass="lineno"> 1432</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01436"></a><spanclass="lineno"> 1436</span> <spanclass="comment"># If the EXT_LINKS_IN_WINDOW option is set to YES, doxygen will open links to</span></div>
<divclass="line"><aname="l01437"></a><spanclass="lineno"> 1437</span> <spanclass="comment"># external symbols imported via tag files in a separate window.</span></div>
<divclass="line"><aname="l01438"></a><spanclass="lineno"> 1438</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01439"></a><spanclass="lineno"> 1439</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01443"></a><spanclass="lineno"> 1443</span> <spanclass="comment"># Use this tag to change the font size of LaTeX formulas included as images in</span></div>
<divclass="line"><aname="l01444"></a><spanclass="lineno"> 1444</span> <spanclass="comment"># the HTML documentation. When you change the font size after a successful</span></div>
<divclass="line"><aname="l01445"></a><spanclass="lineno"> 1445</span> <spanclass="comment"># doxygen run you need to manually remove any form_*.png images from the HTML</span></div>
<divclass="line"><aname="l01446"></a><spanclass="lineno"> 1446</span> <spanclass="comment"># output directory to force them to be regenerated.</span></div>
<divclass="line"><aname="l01448"></a><spanclass="lineno"> 1448</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01452"></a><spanclass="lineno"> 1452</span> <spanclass="comment"># Use the FORMULA_TRANPARENT tag to determine whether or not the images</span></div>
<divclass="line"><aname="l01453"></a><spanclass="lineno"> 1453</span> <spanclass="comment"># generated for formulas are transparent PNGs. Transparent PNGs are not</span></div>
<divclass="line"><aname="l01454"></a><spanclass="lineno"> 1454</span> <spanclass="comment"># supported properly for IE 6.0, but are supported on all modern browsers.</span></div>
<divclass="line"><aname="l01456"></a><spanclass="lineno"> 1456</span> <spanclass="comment"># Note that when changing this option you need to delete any form_*.png files in</span></div>
<divclass="line"><aname="l01457"></a><spanclass="lineno"> 1457</span> <spanclass="comment"># the HTML output directory before the changes have effect.</span></div>
<divclass="line"><aname="l01458"></a><spanclass="lineno"> 1458</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01459"></a><spanclass="lineno"> 1459</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01463"></a><spanclass="lineno"> 1463</span> <spanclass="comment"># Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see</span></div>
<divclass="line"><aname="l01464"></a><spanclass="lineno"> 1464</span> <spanclass="comment"># http://www.mathjax.org) which uses client side Javascript for the rendering</span></div>
<divclass="line"><aname="l01465"></a><spanclass="lineno"> 1465</span> <spanclass="comment"># instead of using pre-rendered bitmaps. Use this if you do not have LaTeX</span></div>
<divclass="line"><aname="l01466"></a><spanclass="lineno"> 1466</span> <spanclass="comment"># installed or if you want to formulas look prettier in the HTML output. When</span></div>
<divclass="line"><aname="l01467"></a><spanclass="lineno"> 1467</span> <spanclass="comment"># enabled you may also need to install MathJax separately and configure the path</span></div>
<divclass="line"><aname="l01468"></a><spanclass="lineno"> 1468</span> <spanclass="comment"># to it using the MATHJAX_RELPATH option.</span></div>
<divclass="line"><aname="l01469"></a><spanclass="lineno"> 1469</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01470"></a><spanclass="lineno"> 1470</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01474"></a><spanclass="lineno"> 1474</span> <spanclass="comment"># When MathJax is enabled you can set the default output format to be used for</span></div>
<divclass="line"><aname="l01475"></a><spanclass="lineno"> 1475</span> <spanclass="comment"># the MathJax output. See the MathJax site (see:</span></div>
<divclass="line"><aname="l01476"></a><spanclass="lineno"> 1476</span> <spanclass="comment"># http://docs.mathjax.org/en/latest/output.html) for more details.</span></div>
<divclass="line"><aname="l01477"></a><spanclass="lineno"> 1477</span> <spanclass="comment"># Possible values are: HTML-CSS (which is slower, but has the best</span></div>
<divclass="line"><aname="l01478"></a><spanclass="lineno"> 1478</span> <spanclass="comment"># compatibility), NativeMML (i.e. MathML) and SVG.</span></div>
<divclass="line"><aname="l01479"></a><spanclass="lineno"> 1479</span> <spanclass="comment"># The default value is: HTML-CSS.</span></div>
<divclass="line"><aname="l01480"></a><spanclass="lineno"> 1480</span> <spanclass="comment"># This tag requires that the tag USE_MATHJAX is set to YES.</span></div>
<divclass="line"><aname="l01484"></a><spanclass="lineno"> 1484</span> <spanclass="comment"># When MathJax is enabled you need to specify the location relative to the HTML</span></div>
<divclass="line"><aname="l01485"></a><spanclass="lineno"> 1485</span> <spanclass="comment"># output directory using the MATHJAX_RELPATH option. The destination directory</span></div>
<divclass="line"><aname="l01486"></a><spanclass="lineno"> 1486</span> <spanclass="comment"># should contain the MathJax.js script. For instance, if the mathjax directory</span></div>
<divclass="line"><aname="l01487"></a><spanclass="lineno"> 1487</span> <spanclass="comment"># is located at the same level as the HTML output directory, then</span></div>
<divclass="line"><aname="l01488"></a><spanclass="lineno"> 1488</span> <spanclass="comment"># MATHJAX_RELPATH should be ../mathjax. The default value points to the MathJax</span></div>
<divclass="line"><aname="l01489"></a><spanclass="lineno"> 1489</span> <spanclass="comment"># Content Delivery Network so you can quickly see the result without installing</span></div>
<divclass="line"><aname="l01490"></a><spanclass="lineno"> 1490</span> <spanclass="comment"># MathJax. However, it is strongly recommended to install a local copy of</span></div>
<divclass="line"><aname="l01491"></a><spanclass="lineno"> 1491</span> <spanclass="comment"># MathJax from http://www.mathjax.org before deployment.</span></div>
<divclass="line"><aname="l01492"></a><spanclass="lineno"> 1492</span> <spanclass="comment"># The default value is: http://cdn.mathjax.org/mathjax/latest.</span></div>
<divclass="line"><aname="l01493"></a><spanclass="lineno"> 1493</span> <spanclass="comment"># This tag requires that the tag USE_MATHJAX is set to YES.</span></div>
<divclass="line"><aname="l01497"></a><spanclass="lineno"> 1497</span> <spanclass="comment"># The MATHJAX_EXTENSIONS tag can be used to specify one or more MathJax</span></div>
<divclass="line"><aname="l01498"></a><spanclass="lineno"> 1498</span> <spanclass="comment"># extension names that should be enabled during MathJax rendering. For example</span></div>
<divclass="line"><aname="l01500"></a><spanclass="lineno"> 1500</span> <spanclass="comment"># This tag requires that the tag USE_MATHJAX is set to YES.</span></div>
<divclass="line"><aname="l01504"></a><spanclass="lineno"> 1504</span> <spanclass="comment"># The MATHJAX_CODEFILE tag can be used to specify a file with javascript pieces</span></div>
<divclass="line"><aname="l01505"></a><spanclass="lineno"> 1505</span> <spanclass="comment"># of code that will be used on startup of the MathJax code. See the MathJax site</span></div>
<divclass="line"><aname="l01506"></a><spanclass="lineno"> 1506</span> <spanclass="comment"># (see: http://docs.mathjax.org/en/latest/output.html) for more details. For an</span></div>
<divclass="line"><aname="l01507"></a><spanclass="lineno"> 1507</span> <spanclass="comment"># example see the documentation.</span></div>
<divclass="line"><aname="l01508"></a><spanclass="lineno"> 1508</span> <spanclass="comment"># This tag requires that the tag USE_MATHJAX is set to YES.</span></div>
<divclass="line"><aname="l01512"></a><spanclass="lineno"> 1512</span> <spanclass="comment"># When the SEARCHENGINE tag is enabled doxygen will generate a search box for</span></div>
<divclass="line"><aname="l01513"></a><spanclass="lineno"> 1513</span> <spanclass="comment"># the HTML output. The underlying search engine uses javascript and DHTML and</span></div>
<divclass="line"><aname="l01514"></a><spanclass="lineno"> 1514</span> <spanclass="comment"># should work on any modern browser. Note that when using HTML help</span></div>
<divclass="line"><aname="l01515"></a><spanclass="lineno"> 1515</span> <spanclass="comment"># (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets (GENERATE_DOCSET)</span></div>
<divclass="line"><aname="l01516"></a><spanclass="lineno"> 1516</span> <spanclass="comment"># there is already a search function so this one should typically be disabled.</span></div>
<divclass="line"><aname="l01517"></a><spanclass="lineno"> 1517</span> <spanclass="comment"># For large projects the javascript based search engine can be slow, then</span></div>
<divclass="line"><aname="l01518"></a><spanclass="lineno"> 1518</span> <spanclass="comment"># enabling SERVER_BASED_SEARCH may provide a better solution. It is possible to</span></div>
<divclass="line"><aname="l01519"></a><spanclass="lineno"> 1519</span> <spanclass="comment"># search using the keyboard; to jump to the search box use <access key> + S</span></div>
<divclass="line"><aname="l01520"></a><spanclass="lineno"> 1520</span> <spanclass="comment"># (what the <access key> is depends on the OS and browser, but it is typically</span></div>
<divclass="line"><aname="l01521"></a><spanclass="lineno"> 1521</span> <spanclass="comment"># <CTRL>, <ALT>/<option>, or both). Inside the search box use the <cursor down</span></div>
<divclass="line"><aname="l01522"></a><spanclass="lineno"> 1522</span> <spanclass="comment"># key> to jump into the search results window, the results can be navigated</span></div>
<divclass="line"><aname="l01523"></a><spanclass="lineno"> 1523</span> <spanclass="comment"># using the <cursor keys>. Press <Enter> to select an item or <escape> to cancel</span></div>
<divclass="line"><aname="l01524"></a><spanclass="lineno"> 1524</span> <spanclass="comment"># the search. The filter options can be selected when the cursor is inside the</span></div>
<divclass="line"><aname="l01525"></a><spanclass="lineno"> 1525</span> <spanclass="comment"># search box by pressing <Shift>+<cursor down>. Also here use the <cursor keys></span></div>
<divclass="line"><aname="l01526"></a><spanclass="lineno"> 1526</span> <spanclass="comment"># to select a filter and <Enter> or <escape> to activate or cancel the filter</span></div>
<divclass="line"><aname="l01528"></a><spanclass="lineno"> 1528</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01529"></a><spanclass="lineno"> 1529</span> <spanclass="comment"># This tag requires that the tag GENERATE_HTML is set to YES.</span></div>
<divclass="line"><aname="l01533"></a><spanclass="lineno"> 1533</span> <spanclass="comment"># When the SERVER_BASED_SEARCH tag is enabled the search engine will be</span></div>
<divclass="line"><aname="l01534"></a><spanclass="lineno"> 1534</span> <spanclass="comment"># implemented using a web server instead of a web client using Javascript. There</span></div>
<divclass="line"><aname="l01535"></a><spanclass="lineno"> 1535</span> <spanclass="comment"># are two flavors of web server based searching depending on the EXTERNAL_SEARCH</span></div>
<divclass="line"><aname="l01536"></a><spanclass="lineno"> 1536</span> <spanclass="comment"># setting. When disabled, doxygen will generate a PHP script for searching and</span></div>
<divclass="line"><aname="l01537"></a><spanclass="lineno"> 1537</span> <spanclass="comment"># an index file used by the script. When EXTERNAL_SEARCH is enabled the indexing</span></div>
<divclass="line"><aname="l01538"></a><spanclass="lineno"> 1538</span> <spanclass="comment"># and searching needs to be provided by external tools. See the section</span></div>
<divclass="line"><aname="l01539"></a><spanclass="lineno"> 1539</span> <spanclass="comment"># "External Indexing and Searching" for details.</span></div>
<divclass="line"><aname="l01540"></a><spanclass="lineno"> 1540</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01541"></a><spanclass="lineno"> 1541</span> <spanclass="comment"># This tag requires that the tag SEARCHENGINE is set to YES.</span></div>
<divclass="line"><aname="l01545"></a><spanclass="lineno"> 1545</span> <spanclass="comment"># When EXTERNAL_SEARCH tag is enabled doxygen will no longer generate the PHP</span></div>
<divclass="line"><aname="l01546"></a><spanclass="lineno"> 1546</span> <spanclass="comment"># script for searching. Instead the search results are written to an XML file</span></div>
<divclass="line"><aname="l01547"></a><spanclass="lineno"> 1547</span> <spanclass="comment"># which needs to be processed by an external indexer. Doxygen will invoke an</span></div>
<divclass="line"><aname="l01548"></a><spanclass="lineno"> 1548</span> <spanclass="comment"># external search engine pointed to by the SEARCHENGINE_URL option to obtain the</span></div>
<divclass="line"><aname="l01551"></a><spanclass="lineno"> 1551</span> <spanclass="comment"># Doxygen ships with an example indexer (doxyindexer) and search engine</span></div>
<divclass="line"><aname="l01552"></a><spanclass="lineno"> 1552</span> <spanclass="comment"># (doxysearch.cgi) which are based on the open source search engine library</span></div>
<divclass="line"><aname="l01555"></a><spanclass="lineno"> 1555</span> <spanclass="comment"># See the section "External Indexing and Searching" for details.</span></div>
<divclass="line"><aname="l01556"></a><spanclass="lineno"> 1556</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01557"></a><spanclass="lineno"> 1557</span> <spanclass="comment"># This tag requires that the tag SEARCHENGINE is set to YES.</span></div>
<divclass="line"><aname="l01561"></a><spanclass="lineno"> 1561</span> <spanclass="comment"># The SEARCHENGINE_URL should point to a search engine hosted by a web server</span></div>
<divclass="line"><aname="l01562"></a><spanclass="lineno"> 1562</span> <spanclass="comment"># which will return the search results when EXTERNAL_SEARCH is enabled.</span></div>
<divclass="line"><aname="l01564"></a><spanclass="lineno"> 1564</span> <spanclass="comment"># Doxygen ships with an example indexer (doxyindexer) and search engine</span></div>
<divclass="line"><aname="l01565"></a><spanclass="lineno"> 1565</span> <spanclass="comment"># (doxysearch.cgi) which are based on the open source search engine library</span></div>
<divclass="line"><aname="l01566"></a><spanclass="lineno"> 1566</span> <spanclass="comment"># Xapian (see: http://xapian.org/). See the section "External Indexing and</span></div>
<divclass="line"><aname="l01567"></a><spanclass="lineno"> 1567</span> <spanclass="comment"># Searching" for details.</span></div>
<divclass="line"><aname="l01568"></a><spanclass="lineno"> 1568</span> <spanclass="comment"># This tag requires that the tag SEARCHENGINE is set to YES.</span></div>
<divclass="line"><aname="l01572"></a><spanclass="lineno"> 1572</span> <spanclass="comment"># When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the unindexed</span></div>
<divclass="line"><aname="l01573"></a><spanclass="lineno"> 1573</span> <spanclass="comment"># search data is written to a file for indexing by an external tool. With the</span></div>
<divclass="line"><aname="l01574"></a><spanclass="lineno"> 1574</span> <spanclass="comment"># SEARCHDATA_FILE tag the name of this file can be specified.</span></div>
<divclass="line"><aname="l01575"></a><spanclass="lineno"> 1575</span> <spanclass="comment"># The default file is: searchdata.xml.</span></div>
<divclass="line"><aname="l01576"></a><spanclass="lineno"> 1576</span> <spanclass="comment"># This tag requires that the tag SEARCHENGINE is set to YES.</span></div>
<divclass="line"><aname="l01580"></a><spanclass="lineno"> 1580</span> <spanclass="comment"># When SERVER_BASED_SEARCH and EXTERNAL_SEARCH are both enabled the</span></div>
<divclass="line"><aname="l01581"></a><spanclass="lineno"> 1581</span> <spanclass="comment"># EXTERNAL_SEARCH_ID tag can be used as an identifier for the project. This is</span></div>
<divclass="line"><aname="l01582"></a><spanclass="lineno"> 1582</span> <spanclass="comment"># useful in combination with EXTRA_SEARCH_MAPPINGS to search through multiple</span></div>
<divclass="line"><aname="l01583"></a><spanclass="lineno"> 1583</span> <spanclass="comment"># projects and redirect the results back to the right project.</span></div>
<divclass="line"><aname="l01584"></a><spanclass="lineno"> 1584</span> <spanclass="comment"># This tag requires that the tag SEARCHENGINE is set to YES.</span></div>
<divclass="line"><aname="l01588"></a><spanclass="lineno"> 1588</span> <spanclass="comment"># The EXTRA_SEARCH_MAPPINGS tag can be used to enable searching through doxygen</span></div>
<divclass="line"><aname="l01589"></a><spanclass="lineno"> 1589</span> <spanclass="comment"># projects other than the one defined by this configuration file, but that are</span></div>
<divclass="line"><aname="l01590"></a><spanclass="lineno"> 1590</span> <spanclass="comment"># all added to the same external search index. Each project needs to have a</span></div>
<divclass="line"><aname="l01591"></a><spanclass="lineno"> 1591</span> <spanclass="comment"># unique id set via EXTERNAL_SEARCH_ID. The search mapping then maps the id of</span></div>
<divclass="line"><aname="l01592"></a><spanclass="lineno"> 1592</span> <spanclass="comment"># to a relative location where the documentation can be found. The format is:</span></div>
<divclass="line"><aname="l01594"></a><spanclass="lineno"> 1594</span> <spanclass="comment"># This tag requires that the tag SEARCHENGINE is set to YES.</span></div>
<divclass="line"><aname="l01599"></a><spanclass="lineno"> 1599</span> <spanclass="comment"># Configuration options related to the LaTeX output</span></div>
<divclass="line"><aname="l01602"></a><spanclass="lineno"> 1602</span> <spanclass="comment"># If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.</span></div>
<divclass="line"><aname="l01603"></a><spanclass="lineno"> 1603</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01607"></a><spanclass="lineno"> 1607</span> <spanclass="comment"># The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. If a</span></div>
<divclass="line"><aname="l01608"></a><spanclass="lineno"> 1608</span> <spanclass="comment"># relative path is entered the value of OUTPUT_DIRECTORY will be put in front of</span></div>
<divclass="line"><aname="l01610"></a><spanclass="lineno"> 1610</span> <spanclass="comment"># The default directory is: latex.</span></div>
<divclass="line"><aname="l01611"></a><spanclass="lineno"> 1611</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01615"></a><spanclass="lineno"> 1615</span> <spanclass="comment"># The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be</span></div>
<divclass="line"><aname="l01618"></a><spanclass="lineno"> 1618</span> <spanclass="comment"># Note that when enabling USE_PDFLATEX this option is only used for generating</span></div>
<divclass="line"><aname="l01619"></a><spanclass="lineno"> 1619</span> <spanclass="comment"># bitmaps for formulas in the HTML output, but not in the Makefile that is</span></div>
<divclass="line"><aname="l01620"></a><spanclass="lineno"> 1620</span> <spanclass="comment"># written to the output directory.</span></div>
<divclass="line"><aname="l01621"></a><spanclass="lineno"> 1621</span> <spanclass="comment"># The default file is: latex.</span></div>
<divclass="line"><aname="l01622"></a><spanclass="lineno"> 1622</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01626"></a><spanclass="lineno"> 1626</span> <spanclass="comment"># The MAKEINDEX_CMD_NAME tag can be used to specify the command name to generate</span></div>
<divclass="line"><aname="l01627"></a><spanclass="lineno"> 1627</span> <spanclass="comment"># index for LaTeX.</span></div>
<divclass="line"><aname="l01628"></a><spanclass="lineno"> 1628</span> <spanclass="comment"># The default file is: makeindex.</span></div>
<divclass="line"><aname="l01629"></a><spanclass="lineno"> 1629</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01633"></a><spanclass="lineno"> 1633</span> <spanclass="comment"># If the COMPACT_LATEX tag is set to YES, doxygen generates more compact LaTeX</span></div>
<divclass="line"><aname="l01634"></a><spanclass="lineno"> 1634</span> <spanclass="comment"># documents. This may be useful for small projects and may help to save some</span></div>
<divclass="line"><aname="l01635"></a><spanclass="lineno"> 1635</span> <spanclass="comment"># trees in general.</span></div>
<divclass="line"><aname="l01636"></a><spanclass="lineno"> 1636</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01637"></a><spanclass="lineno"> 1637</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01641"></a><spanclass="lineno"> 1641</span> <spanclass="comment"># The PAPER_TYPE tag can be used to set the paper type that is used by the</span></div>
<divclass="line"><aname="l01643"></a><spanclass="lineno"> 1643</span> <spanclass="comment"># Possible values are: a4 (210 x 297 mm), letter (8.5 x 11 inches), legal (8.5 x</span></div>
<divclass="line"><aname="l01644"></a><spanclass="lineno"> 1644</span> <spanclass="comment"># 14 inches) and executive (7.25 x 10.5 inches).</span></div>
<divclass="line"><aname="l01645"></a><spanclass="lineno"> 1645</span> <spanclass="comment"># The default value is: a4.</span></div>
<divclass="line"><aname="l01646"></a><spanclass="lineno"> 1646</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01650"></a><spanclass="lineno"> 1650</span> <spanclass="comment"># The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names</span></div>
<divclass="line"><aname="l01651"></a><spanclass="lineno"> 1651</span> <spanclass="comment"># that should be included in the LaTeX output. The package can be specified just</span></div>
<divclass="line"><aname="l01652"></a><spanclass="lineno"> 1652</span> <spanclass="comment"># by its name or with the correct syntax as to be used with the LaTeX</span></div>
<divclass="line"><aname="l01653"></a><spanclass="lineno"> 1653</span> <spanclass="comment"># \usepackage command. To get the times font for instance you can specify :</span></div>
<divclass="line"><aname="l01654"></a><spanclass="lineno"> 1654</span> <spanclass="comment"># EXTRA_PACKAGES=times or EXTRA_PACKAGES={times}</span></div>
<divclass="line"><aname="l01655"></a><spanclass="lineno"> 1655</span> <spanclass="comment"># To use the option intlimits with the amsmath package you can specify:</span></div>
<divclass="line"><aname="l01657"></a><spanclass="lineno"> 1657</span> <spanclass="comment"># If left blank no extra packages will be included.</span></div>
<divclass="line"><aname="l01658"></a><spanclass="lineno"> 1658</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01662"></a><spanclass="lineno"> 1662</span> <spanclass="comment"># The LATEX_HEADER tag can be used to specify a personal LaTeX header for the</span></div>
<divclass="line"><aname="l01663"></a><spanclass="lineno"> 1663</span> <spanclass="comment"># generated LaTeX document. The header should contain everything until the first</span></div>
<divclass="line"><aname="l01664"></a><spanclass="lineno"> 1664</span> <spanclass="comment"># chapter. If it is left blank doxygen will generate a standard header. See</span></div>
<divclass="line"><aname="l01665"></a><spanclass="lineno"> 1665</span> <spanclass="comment"># section "Doxygen usage" for information on how to let doxygen write the</span></div>
<divclass="line"><aname="l01666"></a><spanclass="lineno"> 1666</span> <spanclass="comment"># default header to a separate file.</span></div>
<divclass="line"><aname="l01668"></a><spanclass="lineno"> 1668</span> <spanclass="comment"># Note: Only use a user-defined header if you know what you are doing! The</span></div>
<divclass="line"><aname="l01669"></a><spanclass="lineno"> 1669</span> <spanclass="comment"># following commands have a special meaning inside the header: $title,</span></div>
<divclass="line"><aname="l01671"></a><spanclass="lineno"> 1671</span> <spanclass="comment"># $projectbrief, $projectlogo. Doxygen will replace $title with the empty</span></div>
<divclass="line"><aname="l01672"></a><spanclass="lineno"> 1672</span> <spanclass="comment"># string, for the replacement values of the other commands the user is referred</span></div>
<divclass="line"><aname="l01673"></a><spanclass="lineno"> 1673</span> <spanclass="comment"># to HTML_HEADER.</span></div>
<divclass="line"><aname="l01674"></a><spanclass="lineno"> 1674</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01678"></a><spanclass="lineno"> 1678</span> <spanclass="comment"># The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for the</span></div>
<divclass="line"><aname="l01679"></a><spanclass="lineno"> 1679</span> <spanclass="comment"># generated LaTeX document. The footer should contain everything after the last</span></div>
<divclass="line"><aname="l01680"></a><spanclass="lineno"> 1680</span> <spanclass="comment"># chapter. If it is left blank doxygen will generate a standard footer. See</span></div>
<divclass="line"><aname="l01681"></a><spanclass="lineno"> 1681</span> <spanclass="comment"># LATEX_HEADER for more information on how to generate a default footer and what</span></div>
<divclass="line"><aname="l01682"></a><spanclass="lineno"> 1682</span> <spanclass="comment"># special commands can be used inside the footer.</span></div>
<divclass="line"><aname="l01684"></a><spanclass="lineno"> 1684</span> <spanclass="comment"># Note: Only use a user-defined footer if you know what you are doing!</span></div>
<divclass="line"><aname="l01685"></a><spanclass="lineno"> 1685</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01689"></a><spanclass="lineno"> 1689</span> <spanclass="comment"># The LATEX_EXTRA_STYLESHEET tag can be used to specify additional user-defined</span></div>
<divclass="line"><aname="l01690"></a><spanclass="lineno"> 1690</span> <spanclass="comment"># LaTeX style sheets that are included after the standard style sheets created</span></div>
<divclass="line"><aname="l01691"></a><spanclass="lineno"> 1691</span> <spanclass="comment"># by doxygen. Using this option one can overrule certain style aspects. Doxygen</span></div>
<divclass="line"><aname="l01692"></a><spanclass="lineno"> 1692</span> <spanclass="comment"># will copy the style sheet files to the output directory.</span></div>
<divclass="line"><aname="l01693"></a><spanclass="lineno"> 1693</span> <spanclass="comment"># Note: The order of the extra style sheet files is of importance (e.g. the last</span></div>
<divclass="line"><aname="l01694"></a><spanclass="lineno"> 1694</span> <spanclass="comment"># style sheet in the list overrules the setting of the previous ones in the</span></div>
<divclass="line"><aname="l01696"></a><spanclass="lineno"> 1696</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01700"></a><spanclass="lineno"> 1700</span> <spanclass="comment"># The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or</span></div>
<divclass="line"><aname="l01701"></a><spanclass="lineno"> 1701</span> <spanclass="comment"># other source files which should be copied to the LATEX_OUTPUT output</span></div>
<divclass="line"><aname="l01702"></a><spanclass="lineno"> 1702</span> <spanclass="comment"># directory. Note that the files will be copied as-is; there are no commands or</span></div>
<divclass="line"><aname="l01704"></a><spanclass="lineno"> 1704</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01708"></a><spanclass="lineno"> 1708</span> <spanclass="comment"># If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated is</span></div>
<divclass="line"><aname="l01709"></a><spanclass="lineno"> 1709</span> <spanclass="comment"># prepared for conversion to PDF (using ps2pdf or pdflatex). The PDF file will</span></div>
<divclass="line"><aname="l01710"></a><spanclass="lineno"> 1710</span> <spanclass="comment"># contain links (just like the HTML output) instead of page references. This</span></div>
<divclass="line"><aname="l01711"></a><spanclass="lineno"> 1711</span> <spanclass="comment"># makes the output suitable for online browsing using a PDF viewer.</span></div>
<divclass="line"><aname="l01712"></a><spanclass="lineno"> 1712</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01713"></a><spanclass="lineno"> 1713</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01717"></a><spanclass="lineno"> 1717</span> <spanclass="comment"># If the USE_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate</span></div>
<divclass="line"><aname="l01718"></a><spanclass="lineno"> 1718</span> <spanclass="comment"># the PDF file directly from the LaTeX files. Set this option to YES, to get a</span></div>
<divclass="line"><aname="l01719"></a><spanclass="lineno"> 1719</span> <spanclass="comment"># higher quality PDF documentation.</span></div>
<divclass="line"><aname="l01720"></a><spanclass="lineno"> 1720</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01721"></a><spanclass="lineno"> 1721</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01725"></a><spanclass="lineno"> 1725</span> <spanclass="comment"># If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \batchmode</span></div>
<divclass="line"><aname="l01726"></a><spanclass="lineno"> 1726</span> <spanclass="comment"># command to the generated LaTeX files. This will instruct LaTeX to keep running</span></div>
<divclass="line"><aname="l01727"></a><spanclass="lineno"> 1727</span> <spanclass="comment"># if errors occur, instead of asking the user for help. This option is also used</span></div>
<divclass="line"><aname="l01728"></a><spanclass="lineno"> 1728</span> <spanclass="comment"># when generating formulas in HTML.</span></div>
<divclass="line"><aname="l01729"></a><spanclass="lineno"> 1729</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01730"></a><spanclass="lineno"> 1730</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01734"></a><spanclass="lineno"> 1734</span> <spanclass="comment"># If the LATEX_HIDE_INDICES tag is set to YES then doxygen will not include the</span></div>
<divclass="line"><aname="l01735"></a><spanclass="lineno"> 1735</span> <spanclass="comment"># index chapters (such as File Index, Compound Index, etc.) in the output.</span></div>
<divclass="line"><aname="l01736"></a><spanclass="lineno"> 1736</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01737"></a><spanclass="lineno"> 1737</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01741"></a><spanclass="lineno"> 1741</span> <spanclass="comment"># If the LATEX_SOURCE_CODE tag is set to YES then doxygen will include source</span></div>
<divclass="line"><aname="l01742"></a><spanclass="lineno"> 1742</span> <spanclass="comment"># code with syntax highlighting in the LaTeX output.</span></div>
<divclass="line"><aname="l01744"></a><spanclass="lineno"> 1744</span> <spanclass="comment"># Note that which sources are shown also depends on other settings such as</span></div>
<divclass="line"><aname="l01746"></a><spanclass="lineno"> 1746</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01747"></a><spanclass="lineno"> 1747</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01751"></a><spanclass="lineno"> 1751</span> <spanclass="comment"># The LATEX_BIB_STYLE tag can be used to specify the style to use for the</span></div>
<divclass="line"><aname="l01752"></a><spanclass="lineno"> 1752</span> <spanclass="comment"># bibliography, e.g. plainnat, or ieeetr. See</span></div>
<divclass="line"><aname="l01753"></a><spanclass="lineno"> 1753</span> <spanclass="comment"># http://en.wikipedia.org/wiki/BibTeX and \cite for more info.</span></div>
<divclass="line"><aname="l01754"></a><spanclass="lineno"> 1754</span> <spanclass="comment"># The default value is: plain.</span></div>
<divclass="line"><aname="l01755"></a><spanclass="lineno"> 1755</span> <spanclass="comment"># This tag requires that the tag GENERATE_LATEX is set to YES.</span></div>
<divclass="line"><aname="l01760"></a><spanclass="lineno"> 1760</span> <spanclass="comment"># Configuration options related to the RTF output</span></div>
<divclass="line"><aname="l01763"></a><spanclass="lineno"> 1763</span> <spanclass="comment"># If the GENERATE_RTF tag is set to YES, doxygen will generate RTF output. The</span></div>
<divclass="line"><aname="l01764"></a><spanclass="lineno"> 1764</span> <spanclass="comment"># RTF output is optimized for Word 97 and may not look too pretty with other RTF</span></div>
<divclass="line"><aname="l01770"></a><spanclass="lineno"> 1770</span> <spanclass="comment"># The RTF_OUTPUT tag is used to specify where the RTF docs will be put. If a</span></div>
<divclass="line"><aname="l01771"></a><spanclass="lineno"> 1771</span> <spanclass="comment"># relative path is entered the value of OUTPUT_DIRECTORY will be put in front of</span></div>
<divclass="line"><aname="l01773"></a><spanclass="lineno"> 1773</span> <spanclass="comment"># The default directory is: rtf.</span></div>
<divclass="line"><aname="l01774"></a><spanclass="lineno"> 1774</span> <spanclass="comment"># This tag requires that the tag GENERATE_RTF is set to YES.</span></div>
<divclass="line"><aname="l01778"></a><spanclass="lineno"> 1778</span> <spanclass="comment"># If the COMPACT_RTF tag is set to YES, doxygen generates more compact RTF</span></div>
<divclass="line"><aname="l01779"></a><spanclass="lineno"> 1779</span> <spanclass="comment"># documents. This may be useful for small projects and may help to save some</span></div>
<divclass="line"><aname="l01780"></a><spanclass="lineno"> 1780</span> <spanclass="comment"># trees in general.</span></div>
<divclass="line"><aname="l01781"></a><spanclass="lineno"> 1781</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01782"></a><spanclass="lineno"> 1782</span> <spanclass="comment"># This tag requires that the tag GENERATE_RTF is set to YES.</span></div>
<divclass="line"><aname="l01786"></a><spanclass="lineno"> 1786</span> <spanclass="comment"># If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated will</span></div>
<divclass="line"><aname="l01787"></a><spanclass="lineno"> 1787</span> <spanclass="comment"># contain hyperlink fields. The RTF file will contain links (just like the HTML</span></div>
<divclass="line"><aname="l01788"></a><spanclass="lineno"> 1788</span> <spanclass="comment"># output) instead of page references. This makes the output suitable for online</span></div>
<divclass="line"><aname="l01789"></a><spanclass="lineno"> 1789</span> <spanclass="comment"># browsing using Word or some other Word compatible readers that support those</span></div>
<divclass="line"><aname="l01792"></a><spanclass="lineno"> 1792</span> <spanclass="comment"># Note: WordPad (write) and others do not support links.</span></div>
<divclass="line"><aname="l01793"></a><spanclass="lineno"> 1793</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01794"></a><spanclass="lineno"> 1794</span> <spanclass="comment"># This tag requires that the tag GENERATE_RTF is set to YES.</span></div>
<divclass="line"><aname="l01798"></a><spanclass="lineno"> 1798</span> <spanclass="comment"># Load stylesheet definitions from file. Syntax is similar to doxygen's config</span></div>
<divclass="line"><aname="l01799"></a><spanclass="lineno"> 1799</span> <spanclass="comment"># file, i.e. a series of assignments. You only have to provide replacements,</span></div>
<divclass="line"><aname="l01800"></a><spanclass="lineno"> 1800</span> <spanclass="comment"># missing definitions are set to their default value.</span></div>
<divclass="line"><aname="l01802"></a><spanclass="lineno"> 1802</span> <spanclass="comment"># See also section "Doxygen usage" for information on how to generate the</span></div>
<divclass="line"><aname="l01803"></a><spanclass="lineno"> 1803</span> <spanclass="comment"># default style sheet that doxygen normally uses.</span></div>
<divclass="line"><aname="l01804"></a><spanclass="lineno"> 1804</span> <spanclass="comment"># This tag requires that the tag GENERATE_RTF is set to YES.</span></div>
<divclass="line"><aname="l01808"></a><spanclass="lineno"> 1808</span> <spanclass="comment"># Set optional variables used in the generation of an RTF document. Syntax is</span></div>
<divclass="line"><aname="l01809"></a><spanclass="lineno"> 1809</span> <spanclass="comment"># similar to doxygen's config file. A template extensions file can be generated</span></div>
<divclass="line"><aname="l01810"></a><spanclass="lineno"> 1810</span> <spanclass="comment"># using doxygen -e rtf extensionFile.</span></div>
<divclass="line"><aname="l01811"></a><spanclass="lineno"> 1811</span> <spanclass="comment"># This tag requires that the tag GENERATE_RTF is set to YES.</span></div>
<divclass="line"><aname="l01815"></a><spanclass="lineno"> 1815</span> <spanclass="comment"># If the RTF_SOURCE_CODE tag is set to YES then doxygen will include source code</span></div>
<divclass="line"><aname="l01816"></a><spanclass="lineno"> 1816</span> <spanclass="comment"># with syntax highlighting in the RTF output.</span></div>
<divclass="line"><aname="l01818"></a><spanclass="lineno"> 1818</span> <spanclass="comment"># Note that which sources are shown also depends on other settings such as</span></div>
<divclass="line"><aname="l01820"></a><spanclass="lineno"> 1820</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01821"></a><spanclass="lineno"> 1821</span> <spanclass="comment"># This tag requires that the tag GENERATE_RTF is set to YES.</span></div>
<divclass="line"><aname="l01826"></a><spanclass="lineno"> 1826</span> <spanclass="comment"># Configuration options related to the man page output</span></div>
<divclass="line"><aname="l01829"></a><spanclass="lineno"> 1829</span> <spanclass="comment"># If the GENERATE_MAN tag is set to YES, doxygen will generate man pages for</span></div>
<divclass="line"><aname="l01830"></a><spanclass="lineno"> 1830</span> <spanclass="comment"># classes and files.</span></div>
<divclass="line"><aname="l01831"></a><spanclass="lineno"> 1831</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01835"></a><spanclass="lineno"> 1835</span> <spanclass="comment"># The MAN_OUTPUT tag is used to specify where the man pages will be put. If a</span></div>
<divclass="line"><aname="l01836"></a><spanclass="lineno"> 1836</span> <spanclass="comment"># relative path is entered the value of OUTPUT_DIRECTORY will be put in front of</span></div>
<divclass="line"><aname="l01837"></a><spanclass="lineno"> 1837</span> <spanclass="comment"># it. A directory man3 will be created inside the directory specified by</span></div>
<divclass="line"><aname="l01839"></a><spanclass="lineno"> 1839</span> <spanclass="comment"># The default directory is: man.</span></div>
<divclass="line"><aname="l01840"></a><spanclass="lineno"> 1840</span> <spanclass="comment"># This tag requires that the tag GENERATE_MAN is set to YES.</span></div>
<divclass="line"><aname="l01844"></a><spanclass="lineno"> 1844</span> <spanclass="comment"># The MAN_EXTENSION tag determines the extension that is added to the generated</span></div>
<divclass="line"><aname="l01845"></a><spanclass="lineno"> 1845</span> <spanclass="comment"># man pages. In case the manual section does not start with a number, the number</span></div>
<divclass="line"><aname="l01846"></a><spanclass="lineno"> 1846</span> <spanclass="comment"># 3 is prepended. The dot (.) at the beginning of the MAN_EXTENSION tag is</span></div>
<divclass="line"><aname="l01848"></a><spanclass="lineno"> 1848</span> <spanclass="comment"># The default value is: .3.</span></div>
<divclass="line"><aname="l01849"></a><spanclass="lineno"> 1849</span> <spanclass="comment"># This tag requires that the tag GENERATE_MAN is set to YES.</span></div>
<divclass="line"><aname="l01853"></a><spanclass="lineno"> 1853</span> <spanclass="comment"># The MAN_SUBDIR tag determines the name of the directory created within</span></div>
<divclass="line"><aname="l01854"></a><spanclass="lineno"> 1854</span> <spanclass="comment"># MAN_OUTPUT in which the man pages are placed. If defaults to man followed by</span></div>
<divclass="line"><aname="l01855"></a><spanclass="lineno"> 1855</span> <spanclass="comment"># MAN_EXTENSION with the initial . removed.</span></div>
<divclass="line"><aname="l01856"></a><spanclass="lineno"> 1856</span> <spanclass="comment"># This tag requires that the tag GENERATE_MAN is set to YES.</span></div>
<divclass="line"><aname="l01860"></a><spanclass="lineno"> 1860</span> <spanclass="comment"># If the MAN_LINKS tag is set to YES and doxygen generates man output, then it</span></div>
<divclass="line"><aname="l01861"></a><spanclass="lineno"> 1861</span> <spanclass="comment"># will generate one additional man file for each entity documented in the real</span></div>
<divclass="line"><aname="l01862"></a><spanclass="lineno"> 1862</span> <spanclass="comment"># man page(s). These additional files only source the real man page, but without</span></div>
<divclass="line"><aname="l01863"></a><spanclass="lineno"> 1863</span> <spanclass="comment"># them the man command would be unable to find the correct page.</span></div>
<divclass="line"><aname="l01864"></a><spanclass="lineno"> 1864</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01865"></a><spanclass="lineno"> 1865</span> <spanclass="comment"># This tag requires that the tag GENERATE_MAN is set to YES.</span></div>
<divclass="line"><aname="l01870"></a><spanclass="lineno"> 1870</span> <spanclass="comment"># Configuration options related to the XML output</span></div>
<divclass="line"><aname="l01873"></a><spanclass="lineno"> 1873</span> <spanclass="comment"># If the GENERATE_XML tag is set to YES, doxygen will generate an XML file that</span></div>
<divclass="line"><aname="l01874"></a><spanclass="lineno"> 1874</span> <spanclass="comment"># captures the structure of the code including all documentation.</span></div>
<divclass="line"><aname="l01875"></a><spanclass="lineno"> 1875</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01879"></a><spanclass="lineno"> 1879</span> <spanclass="comment"># The XML_OUTPUT tag is used to specify where the XML pages will be put. If a</span></div>
<divclass="line"><aname="l01880"></a><spanclass="lineno"> 1880</span> <spanclass="comment"># relative path is entered the value of OUTPUT_DIRECTORY will be put in front of</span></div>
<divclass="line"><aname="l01882"></a><spanclass="lineno"> 1882</span> <spanclass="comment"># The default directory is: xml.</span></div>
<divclass="line"><aname="l01883"></a><spanclass="lineno"> 1883</span> <spanclass="comment"># This tag requires that the tag GENERATE_XML is set to YES.</span></div>
<divclass="line"><aname="l01887"></a><spanclass="lineno"> 1887</span> <spanclass="comment"># If the XML_PROGRAMLISTING tag is set to YES, doxygen will dump the program</span></div>
<divclass="line"><aname="l01888"></a><spanclass="lineno"> 1888</span> <spanclass="comment"># listings (including syntax highlighting and cross-referencing information) to</span></div>
<divclass="line"><aname="l01889"></a><spanclass="lineno"> 1889</span> <spanclass="comment"># the XML output. Note that enabling this will significantly increase the size</span></div>
<divclass="line"><aname="l01890"></a><spanclass="lineno"> 1890</span> <spanclass="comment"># of the XML output.</span></div>
<divclass="line"><aname="l01891"></a><spanclass="lineno"> 1891</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01892"></a><spanclass="lineno"> 1892</span> <spanclass="comment"># This tag requires that the tag GENERATE_XML is set to YES.</span></div>
<divclass="line"><aname="l01897"></a><spanclass="lineno"> 1897</span> <spanclass="comment"># Configuration options related to the DOCBOOK output</span></div>
<divclass="line"><aname="l01900"></a><spanclass="lineno"> 1900</span> <spanclass="comment"># If the GENERATE_DOCBOOK tag is set to YES, doxygen will generate Docbook files</span></div>
<divclass="line"><aname="l01901"></a><spanclass="lineno"> 1901</span> <spanclass="comment"># that can be used to generate PDF.</span></div>
<divclass="line"><aname="l01902"></a><spanclass="lineno"> 1902</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01906"></a><spanclass="lineno"> 1906</span> <spanclass="comment"># The DOCBOOK_OUTPUT tag is used to specify where the Docbook pages will be put.</span></div>
<divclass="line"><aname="l01907"></a><spanclass="lineno"> 1907</span> <spanclass="comment"># If a relative path is entered the value of OUTPUT_DIRECTORY will be put in</span></div>
<divclass="line"><aname="l01908"></a><spanclass="lineno"> 1908</span> <spanclass="comment"># front of it.</span></div>
<divclass="line"><aname="l01909"></a><spanclass="lineno"> 1909</span> <spanclass="comment"># The default directory is: docbook.</span></div>
<divclass="line"><aname="l01910"></a><spanclass="lineno"> 1910</span> <spanclass="comment"># This tag requires that the tag GENERATE_DOCBOOK is set to YES.</span></div>
<divclass="line"><aname="l01914"></a><spanclass="lineno"> 1914</span> <spanclass="comment"># If the DOCBOOK_PROGRAMLISTING tag is set to YES, doxygen will include the</span></div>
<divclass="line"><aname="l01915"></a><spanclass="lineno"> 1915</span> <spanclass="comment"># program listings (including syntax highlighting and cross-referencing</span></div>
<divclass="line"><aname="l01916"></a><spanclass="lineno"> 1916</span> <spanclass="comment"># information) to the DOCBOOK output. Note that enabling this will significantly</span></div>
<divclass="line"><aname="l01917"></a><spanclass="lineno"> 1917</span> <spanclass="comment"># increase the size of the DOCBOOK output.</span></div>
<divclass="line"><aname="l01918"></a><spanclass="lineno"> 1918</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01919"></a><spanclass="lineno"> 1919</span> <spanclass="comment"># This tag requires that the tag GENERATE_DOCBOOK is set to YES.</span></div>
<divclass="line"><aname="l01924"></a><spanclass="lineno"> 1924</span> <spanclass="comment"># Configuration options for the AutoGen Definitions output</span></div>
<divclass="line"><aname="l01927"></a><spanclass="lineno"> 1927</span> <spanclass="comment"># If the GENERATE_AUTOGEN_DEF tag is set to YES, doxygen will generate an</span></div>
<divclass="line"><aname="l01928"></a><spanclass="lineno"> 1928</span> <spanclass="comment"># AutoGen Definitions (see http://autogen.sf.net) file that captures the</span></div>
<divclass="line"><aname="l01929"></a><spanclass="lineno"> 1929</span> <spanclass="comment"># structure of the code including all documentation. Note that this feature is</span></div>
<divclass="line"><aname="l01930"></a><spanclass="lineno"> 1930</span> <spanclass="comment"># still experimental and incomplete at the moment.</span></div>
<divclass="line"><aname="l01931"></a><spanclass="lineno"> 1931</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01936"></a><spanclass="lineno"> 1936</span> <spanclass="comment"># Configuration options related to the Perl module output</span></div>
<divclass="line"><aname="l01939"></a><spanclass="lineno"> 1939</span> <spanclass="comment"># If the GENERATE_PERLMOD tag is set to YES, doxygen will generate a Perl module</span></div>
<divclass="line"><aname="l01940"></a><spanclass="lineno"> 1940</span> <spanclass="comment"># file that captures the structure of the code including all documentation.</span></div>
<divclass="line"><aname="l01942"></a><spanclass="lineno"> 1942</span> <spanclass="comment"># Note that this feature is still experimental and incomplete at the moment.</span></div>
<divclass="line"><aname="l01943"></a><spanclass="lineno"> 1943</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01947"></a><spanclass="lineno"> 1947</span> <spanclass="comment"># If the PERLMOD_LATEX tag is set to YES, doxygen will generate the necessary</span></div>
<divclass="line"><aname="l01948"></a><spanclass="lineno"> 1948</span> <spanclass="comment"># Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI</span></div>
<divclass="line"><aname="l01949"></a><spanclass="lineno"> 1949</span> <spanclass="comment"># output from the Perl module output.</span></div>
<divclass="line"><aname="l01950"></a><spanclass="lineno"> 1950</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01951"></a><spanclass="lineno"> 1951</span> <spanclass="comment"># This tag requires that the tag GENERATE_PERLMOD is set to YES.</span></div>
<divclass="line"><aname="l01955"></a><spanclass="lineno"> 1955</span> <spanclass="comment"># If the PERLMOD_PRETTY tag is set to YES, the Perl module output will be nicely</span></div>
<divclass="line"><aname="l01956"></a><spanclass="lineno"> 1956</span> <spanclass="comment"># formatted so it can be parsed by a human reader. This is useful if you want to</span></div>
<divclass="line"><aname="l01957"></a><spanclass="lineno"> 1957</span> <spanclass="comment"># understand what is going on. On the other hand, if this tag is set to NO, the</span></div>
<divclass="line"><aname="l01958"></a><spanclass="lineno"> 1958</span> <spanclass="comment"># size of the Perl module output will be much smaller and Perl will parse it</span></div>
<divclass="line"><aname="l01959"></a><spanclass="lineno"> 1959</span> <spanclass="comment"># just the same.</span></div>
<divclass="line"><aname="l01960"></a><spanclass="lineno"> 1960</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01961"></a><spanclass="lineno"> 1961</span> <spanclass="comment"># This tag requires that the tag GENERATE_PERLMOD is set to YES.</span></div>
<divclass="line"><aname="l01965"></a><spanclass="lineno"> 1965</span> <spanclass="comment"># The names of the make variables in the generated doxyrules.make file are</span></div>
<divclass="line"><aname="l01966"></a><spanclass="lineno"> 1966</span> <spanclass="comment"># prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. This is useful</span></div>
<divclass="line"><aname="l01967"></a><spanclass="lineno"> 1967</span> <spanclass="comment"># so different doxyrules.make files included by the same Makefile don't</span></div>
<divclass="line"><aname="l01968"></a><spanclass="lineno"> 1968</span> <spanclass="comment"># overwrite each other's variables.</span></div>
<divclass="line"><aname="l01969"></a><spanclass="lineno"> 1969</span> <spanclass="comment"># This tag requires that the tag GENERATE_PERLMOD is set to YES.</span></div>
<divclass="line"><aname="l01974"></a><spanclass="lineno"> 1974</span> <spanclass="comment"># Configuration options related to the preprocessor</span></div>
<divclass="line"><aname="l01977"></a><spanclass="lineno"> 1977</span> <spanclass="comment"># If the ENABLE_PREPROCESSING tag is set to YES, doxygen will evaluate all</span></div>
<divclass="line"><aname="l01978"></a><spanclass="lineno"> 1978</span> <spanclass="comment"># C-preprocessor directives found in the sources and include files.</span></div>
<divclass="line"><aname="l01979"></a><spanclass="lineno"> 1979</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l01983"></a><spanclass="lineno"> 1983</span> <spanclass="comment"># If the MACRO_EXPANSION tag is set to YES, doxygen will expand all macro names</span></div>
<divclass="line"><aname="l01984"></a><spanclass="lineno"> 1984</span> <spanclass="comment"># in the source code. If set to NO, only conditional compilation will be</span></div>
<divclass="line"><aname="l01985"></a><spanclass="lineno"> 1985</span> <spanclass="comment"># performed. Macro expansion can be done in a controlled way by setting</span></div>
<divclass="line"><aname="l01986"></a><spanclass="lineno"> 1986</span> <spanclass="comment"># EXPAND_ONLY_PREDEF to YES.</span></div>
<divclass="line"><aname="l01987"></a><spanclass="lineno"> 1987</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01988"></a><spanclass="lineno"> 1988</span> <spanclass="comment"># This tag requires that the tag ENABLE_PREPROCESSING is set to YES.</span></div>
<divclass="line"><aname="l01992"></a><spanclass="lineno"> 1992</span> <spanclass="comment"># If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then</span></div>
<divclass="line"><aname="l01993"></a><spanclass="lineno"> 1993</span> <spanclass="comment"># the macro expansion is limited to the macros specified with the PREDEFINED and</span></div>
<divclass="line"><aname="l01995"></a><spanclass="lineno"> 1995</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l01996"></a><spanclass="lineno"> 1996</span> <spanclass="comment"># This tag requires that the tag ENABLE_PREPROCESSING is set to YES.</span></div>
<divclass="line"><aname="l02000"></a><spanclass="lineno"> 2000</span> <spanclass="comment"># If the SEARCH_INCLUDES tag is set to YES, the include files in the</span></div>
<divclass="line"><aname="l02001"></a><spanclass="lineno"> 2001</span> <spanclass="comment"># INCLUDE_PATH will be searched if a #include is found.</span></div>
<divclass="line"><aname="l02002"></a><spanclass="lineno"> 2002</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02003"></a><spanclass="lineno"> 2003</span> <spanclass="comment"># This tag requires that the tag ENABLE_PREPROCESSING is set to YES.</span></div>
<divclass="line"><aname="l02007"></a><spanclass="lineno"> 2007</span> <spanclass="comment"># The INCLUDE_PATH tag can be used to specify one or more directories that</span></div>
<divclass="line"><aname="l02008"></a><spanclass="lineno"> 2008</span> <spanclass="comment"># contain include files that are not input files but should be processed by the</span></div>
<divclass="line"><aname="l02010"></a><spanclass="lineno"> 2010</span> <spanclass="comment"># This tag requires that the tag SEARCH_INCLUDES is set to YES.</span></div>
<divclass="line"><aname="l02014"></a><spanclass="lineno"> 2014</span> <spanclass="comment"># You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard</span></div>
<divclass="line"><aname="l02015"></a><spanclass="lineno"> 2015</span> <spanclass="comment"># patterns (like *.h and *.hpp) to filter out the header-files in the</span></div>
<divclass="line"><aname="l02016"></a><spanclass="lineno"> 2016</span> <spanclass="comment"># directories. If left blank, the patterns specified with FILE_PATTERNS will be</span></div>
<divclass="line"><aname="l02018"></a><spanclass="lineno"> 2018</span> <spanclass="comment"># This tag requires that the tag ENABLE_PREPROCESSING is set to YES.</span></div>
<divclass="line"><aname="l02022"></a><spanclass="lineno"> 2022</span> <spanclass="comment"># The PREDEFINED tag can be used to specify one or more macro names that are</span></div>
<divclass="line"><aname="l02023"></a><spanclass="lineno"> 2023</span> <spanclass="comment"># defined before the preprocessor is started (similar to the -D option of e.g.</span></div>
<divclass="line"><aname="l02024"></a><spanclass="lineno"> 2024</span> <spanclass="comment"># gcc). The argument of the tag is a list of macros of the form: name or</span></div>
<divclass="line"><aname="l02025"></a><spanclass="lineno"> 2025</span> <spanclass="comment"># name=definition (no spaces). If the definition and the "=" are omitted, "=1"</span></div>
<divclass="line"><aname="l02026"></a><spanclass="lineno"> 2026</span> <spanclass="comment"># is assumed. To prevent a macro definition from being undefined via #undef or</span></div>
<divclass="line"><aname="l02027"></a><spanclass="lineno"> 2027</span> <spanclass="comment"># recursively expanded use the := operator instead of the = operator.</span></div>
<divclass="line"><aname="l02028"></a><spanclass="lineno"> 2028</span> <spanclass="comment"># This tag requires that the tag ENABLE_PREPROCESSING is set to YES.</span></div>
<divclass="line"><aname="l02032"></a><spanclass="lineno"> 2032</span> <spanclass="comment"># If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this</span></div>
<divclass="line"><aname="l02033"></a><spanclass="lineno"> 2033</span> <spanclass="comment"># tag can be used to specify a list of macro names that should be expanded. The</span></div>
<divclass="line"><aname="l02034"></a><spanclass="lineno"> 2034</span> <spanclass="comment"># macro definition that is found in the sources will be used. Use the PREDEFINED</span></div>
<divclass="line"><aname="l02035"></a><spanclass="lineno"> 2035</span> <spanclass="comment"># tag if you want to use a different macro definition that overrules the</span></div>
<divclass="line"><aname="l02036"></a><spanclass="lineno"> 2036</span> <spanclass="comment"># definition found in the source code.</span></div>
<divclass="line"><aname="l02037"></a><spanclass="lineno"> 2037</span> <spanclass="comment"># This tag requires that the tag ENABLE_PREPROCESSING is set to YES.</span></div>
<divclass="line"><aname="l02041"></a><spanclass="lineno"> 2041</span> <spanclass="comment"># If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will</span></div>
<divclass="line"><aname="l02042"></a><spanclass="lineno"> 2042</span> <spanclass="comment"># remove all references to function-like macros that are alone on a line, have</span></div>
<divclass="line"><aname="l02043"></a><spanclass="lineno"> 2043</span> <spanclass="comment"># an all uppercase name, and do not end with a semicolon. Such function macros</span></div>
<divclass="line"><aname="l02044"></a><spanclass="lineno"> 2044</span> <spanclass="comment"># are typically used for boiler-plate code, and will confuse the parser if not</span></div>
<divclass="line"><aname="l02046"></a><spanclass="lineno"> 2046</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02047"></a><spanclass="lineno"> 2047</span> <spanclass="comment"># This tag requires that the tag ENABLE_PREPROCESSING is set to YES.</span></div>
<divclass="line"><aname="l02052"></a><spanclass="lineno"> 2052</span> <spanclass="comment"># Configuration options related to external references</span></div>
<divclass="line"><aname="l02055"></a><spanclass="lineno"> 2055</span> <spanclass="comment"># The TAGFILES tag can be used to specify one or more tag files. For each tag</span></div>
<divclass="line"><aname="l02056"></a><spanclass="lineno"> 2056</span> <spanclass="comment"># file the location of the external documentation should be added. The format of</span></div>
<divclass="line"><aname="l02057"></a><spanclass="lineno"> 2057</span> <spanclass="comment"># a tag file without this location is as follows:</span></div>
<divclass="line"><aname="l02059"></a><spanclass="lineno"> 2059</span> <spanclass="comment"># Adding location for the tag files is done as follows:</span></div>
<divclass="line"><aname="l02061"></a><spanclass="lineno"> 2061</span> <spanclass="comment"># where loc1 and loc2 can be relative or absolute paths or URLs. See the</span></div>
<divclass="line"><aname="l02062"></a><spanclass="lineno"> 2062</span> <spanclass="comment"># section "Linking to external documentation" for more information about the use</span></div>
<divclass="line"><aname="l02063"></a><spanclass="lineno"> 2063</span> <spanclass="comment"># of tag files.</span></div>
<divclass="line"><aname="l02064"></a><spanclass="lineno"> 2064</span> <spanclass="comment"># Note: Each tag file must have a unique name (where the name does NOT include</span></div>
<divclass="line"><aname="l02065"></a><spanclass="lineno"> 2065</span> <spanclass="comment"># the path). If a tag file is not located in the directory in which doxygen is</span></div>
<divclass="line"><aname="l02066"></a><spanclass="lineno"> 2066</span> <spanclass="comment"># run, you must also specify the path to the tagfile here.</span></div>
<divclass="line"><aname="l02070"></a><spanclass="lineno"> 2070</span> <spanclass="comment"># When a file name is specified after GENERATE_TAGFILE, doxygen will create a</span></div>
<divclass="line"><aname="l02071"></a><spanclass="lineno"> 2071</span> <spanclass="comment"># tag file that is based on the input files it reads. See section "Linking to</span></div>
<divclass="line"><aname="l02072"></a><spanclass="lineno"> 2072</span> <spanclass="comment"># external documentation" for more information about the usage of tag files.</span></div>
<divclass="line"><aname="l02076"></a><spanclass="lineno"> 2076</span> <spanclass="comment"># If the ALLEXTERNALS tag is set to YES, all external class will be listed in</span></div>
<divclass="line"><aname="l02077"></a><spanclass="lineno"> 2077</span> <spanclass="comment"># the class index. If set to NO, only the inherited external classes will be</span></div>
<divclass="line"><aname="l02083"></a><spanclass="lineno"> 2083</span> <spanclass="comment"># If the EXTERNAL_GROUPS tag is set to YES, all external groups will be listed</span></div>
<divclass="line"><aname="l02084"></a><spanclass="lineno"> 2084</span> <spanclass="comment"># in the modules index. If set to NO, only the current project's groups will be</span></div>
<divclass="line"><aname="l02090"></a><spanclass="lineno"> 2090</span> <spanclass="comment"># If the EXTERNAL_PAGES tag is set to YES, all external pages will be listed in</span></div>
<divclass="line"><aname="l02091"></a><spanclass="lineno"> 2091</span> <spanclass="comment"># the related pages index. If set to NO, only the current project's pages will</span></div>
<divclass="line"><aname="l02092"></a><spanclass="lineno"> 2092</span> <spanclass="comment"># be listed.</span></div>
<divclass="line"><aname="l02093"></a><spanclass="lineno"> 2093</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02097"></a><spanclass="lineno"> 2097</span> <spanclass="comment"># The PERL_PATH should be the absolute path and name of the perl script</span></div>
<divclass="line"><aname="l02098"></a><spanclass="lineno"> 2098</span> <spanclass="comment"># interpreter (i.e. the result of 'which perl').</span></div>
<divclass="line"><aname="l02099"></a><spanclass="lineno"> 2099</span> <spanclass="comment"># The default file (with absolute path) is: /usr/bin/perl.</span></div>
<divclass="line"><aname="l02104"></a><spanclass="lineno"> 2104</span> <spanclass="comment"># Configuration options related to the dot tool</span></div>
<divclass="line"><aname="l02107"></a><spanclass="lineno"> 2107</span> <spanclass="comment"># If the CLASS_DIAGRAMS tag is set to YES, doxygen will generate a class diagram</span></div>
<divclass="line"><aname="l02108"></a><spanclass="lineno"> 2108</span> <spanclass="comment"># (in HTML and LaTeX) for classes with base or super classes. Setting the tag to</span></div>
<divclass="line"><aname="l02109"></a><spanclass="lineno"> 2109</span> <spanclass="comment"># NO turns the diagrams off. Note that this option also works with HAVE_DOT</span></div>
<divclass="line"><aname="l02110"></a><spanclass="lineno"> 2110</span> <spanclass="comment"># disabled, but it is recommended to install and use dot, since it yields more</span></div>
<divclass="line"><aname="l02116"></a><spanclass="lineno"> 2116</span> <spanclass="comment"># You can define message sequence charts within doxygen comments using the \msc</span></div>
<divclass="line"><aname="l02117"></a><spanclass="lineno"> 2117</span> <spanclass="comment"># command. Doxygen will then run the mscgen tool (see:</span></div>
<divclass="line"><aname="l02118"></a><spanclass="lineno"> 2118</span> <spanclass="comment"># http://www.mcternan.me.uk/mscgen/)) to produce the chart and insert it in the</span></div>
<divclass="line"><aname="l02119"></a><spanclass="lineno"> 2119</span> <spanclass="comment"># documentation. The MSCGEN_PATH tag allows you to specify the directory where</span></div>
<divclass="line"><aname="l02120"></a><spanclass="lineno"> 2120</span> <spanclass="comment"># the mscgen tool resides. If left empty the tool is assumed to be found in the</span></div>
<divclass="line"><aname="l02125"></a><spanclass="lineno"> 2125</span> <spanclass="comment"># You can include diagrams made with dia in doxygen documentation. Doxygen will</span></div>
<divclass="line"><aname="l02126"></a><spanclass="lineno"> 2126</span> <spanclass="comment"># then run dia to produce the diagram and insert it in the documentation. The</span></div>
<divclass="line"><aname="l02127"></a><spanclass="lineno"> 2127</span> <spanclass="comment"># DIA_PATH tag allows you to specify the directory where the dia binary resides.</span></div>
<divclass="line"><aname="l02128"></a><spanclass="lineno"> 2128</span> <spanclass="comment"># If left empty dia is assumed to be found in the default search path.</span></div>
<divclass="line"><aname="l02132"></a><spanclass="lineno"> 2132</span> <spanclass="comment"># If set to YES the inheritance and collaboration graphs will hide inheritance</span></div>
<divclass="line"><aname="l02133"></a><spanclass="lineno"> 2133</span> <spanclass="comment"># and usage relations if the target is undocumented or is not a class.</span></div>
<divclass="line"><aname="l02134"></a><spanclass="lineno"> 2134</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02138"></a><spanclass="lineno"> 2138</span> <spanclass="comment"># If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is</span></div>
<divclass="line"><aname="l02139"></a><spanclass="lineno"> 2139</span> <spanclass="comment"># available from the path. This tool is part of Graphviz (see:</span></div>
<divclass="line"><aname="l02140"></a><spanclass="lineno"> 2140</span> <spanclass="comment"># http://www.graphviz.org/), a graph visualization toolkit from AT&T and Lucent</span></div>
<divclass="line"><aname="l02141"></a><spanclass="lineno"> 2141</span> <spanclass="comment"># Bell Labs. The other options in this section have no effect if this option is</span></div>
<divclass="line"><aname="l02142"></a><spanclass="lineno"> 2142</span> <spanclass="comment"># set to NO</span></div>
<divclass="line"><aname="l02143"></a><spanclass="lineno"> 2143</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l02147"></a><spanclass="lineno"> 2147</span> <spanclass="comment"># The DOT_NUM_THREADS specifies the number of dot invocations doxygen is allowed</span></div>
<divclass="line"><aname="l02148"></a><spanclass="lineno"> 2148</span> <spanclass="comment"># to run in parallel. When set to 0 doxygen will base this on the number of</span></div>
<divclass="line"><aname="l02149"></a><spanclass="lineno"> 2149</span> <spanclass="comment"># processors available in the system. You can set it explicitly to a value</span></div>
<divclass="line"><aname="l02150"></a><spanclass="lineno"> 2150</span> <spanclass="comment"># larger than 0 to get control over the balance between CPU load and processing</span></div>
<divclass="line"><aname="l02153"></a><spanclass="lineno"> 2153</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02157"></a><spanclass="lineno"> 2157</span> <spanclass="comment"># When you want a differently looking font in the dot files that doxygen</span></div>
<divclass="line"><aname="l02158"></a><spanclass="lineno"> 2158</span> <spanclass="comment"># generates you can specify the font name using DOT_FONTNAME. You need to make</span></div>
<divclass="line"><aname="l02159"></a><spanclass="lineno"> 2159</span> <spanclass="comment"># sure dot is able to find the font, which can be done by putting it in a</span></div>
<divclass="line"><aname="l02160"></a><spanclass="lineno"> 2160</span> <spanclass="comment"># standard location or by setting the DOTFONTPATH environment variable or by</span></div>
<divclass="line"><aname="l02161"></a><spanclass="lineno"> 2161</span> <spanclass="comment"># setting DOT_FONTPATH to the directory containing the font.</span></div>
<divclass="line"><aname="l02162"></a><spanclass="lineno"> 2162</span> <spanclass="comment"># The default value is: Helvetica.</span></div>
<divclass="line"><aname="l02163"></a><spanclass="lineno"> 2163</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02167"></a><spanclass="lineno"> 2167</span> <spanclass="comment"># The DOT_FONTSIZE tag can be used to set the size (in points) of the font of</span></div>
<divclass="line"><aname="l02170"></a><spanclass="lineno"> 2170</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02174"></a><spanclass="lineno"> 2174</span> <spanclass="comment"># By default doxygen will tell dot to use the default font as specified with</span></div>
<divclass="line"><aname="l02175"></a><spanclass="lineno"> 2175</span> <spanclass="comment"># DOT_FONTNAME. If you specify a different font using DOT_FONTNAME you can set</span></div>
<divclass="line"><aname="l02176"></a><spanclass="lineno"> 2176</span> <spanclass="comment"># the path where dot can find it using this tag.</span></div>
<divclass="line"><aname="l02177"></a><spanclass="lineno"> 2177</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02181"></a><spanclass="lineno"> 2181</span> <spanclass="comment"># If the CLASS_GRAPH tag is set to YES then doxygen will generate a graph for</span></div>
<divclass="line"><aname="l02182"></a><spanclass="lineno"> 2182</span> <spanclass="comment"># each documented class showing the direct and indirect inheritance relations.</span></div>
<divclass="line"><aname="l02183"></a><spanclass="lineno"> 2183</span> <spanclass="comment"># Setting this tag to YES will force the CLASS_DIAGRAMS tag to NO.</span></div>
<divclass="line"><aname="l02184"></a><spanclass="lineno"> 2184</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02185"></a><spanclass="lineno"> 2185</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02189"></a><spanclass="lineno"> 2189</span> <spanclass="comment"># If the COLLABORATION_GRAPH tag is set to YES then doxygen will generate a</span></div>
<divclass="line"><aname="l02190"></a><spanclass="lineno"> 2190</span> <spanclass="comment"># graph for each documented class showing the direct and indirect implementation</span></div>
<divclass="line"><aname="l02191"></a><spanclass="lineno"> 2191</span> <spanclass="comment"># dependencies (inheritance, containment, and class references variables) of the</span></div>
<divclass="line"><aname="l02192"></a><spanclass="lineno"> 2192</span> <spanclass="comment"># class with other documented classes.</span></div>
<divclass="line"><aname="l02193"></a><spanclass="lineno"> 2193</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02194"></a><spanclass="lineno"> 2194</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02198"></a><spanclass="lineno"> 2198</span> <spanclass="comment"># If the GROUP_GRAPHS tag is set to YES then doxygen will generate a graph for</span></div>
<divclass="line"><aname="l02199"></a><spanclass="lineno"> 2199</span> <spanclass="comment"># groups, showing the direct groups dependencies.</span></div>
<divclass="line"><aname="l02200"></a><spanclass="lineno"> 2200</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02201"></a><spanclass="lineno"> 2201</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02205"></a><spanclass="lineno"> 2205</span> <spanclass="comment"># If the UML_LOOK tag is set to YES, doxygen will generate inheritance and</span></div>
<divclass="line"><aname="l02206"></a><spanclass="lineno"> 2206</span> <spanclass="comment"># collaboration diagrams in a style similar to the OMG's Unified Modeling</span></div>
<divclass="line"><aname="l02208"></a><spanclass="lineno"> 2208</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l02209"></a><spanclass="lineno"> 2209</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02213"></a><spanclass="lineno"> 2213</span> <spanclass="comment"># If the UML_LOOK tag is enabled, the fields and methods are shown inside the</span></div>
<divclass="line"><aname="l02214"></a><spanclass="lineno"> 2214</span> <spanclass="comment"># class node. If there are many fields or methods and many nodes the graph may</span></div>
<divclass="line"><aname="l02215"></a><spanclass="lineno"> 2215</span> <spanclass="comment"># become too big to be useful. The UML_LIMIT_NUM_FIELDS threshold limits the</span></div>
<divclass="line"><aname="l02216"></a><spanclass="lineno"> 2216</span> <spanclass="comment"># number of items for each type to make the size more manageable. Set this to 0</span></div>
<divclass="line"><aname="l02217"></a><spanclass="lineno"> 2217</span> <spanclass="comment"># for no limit. Note that the threshold may be exceeded by 50% before the limit</span></div>
<divclass="line"><aname="l02218"></a><spanclass="lineno"> 2218</span> <spanclass="comment"># is enforced. So when you set the threshold to 10, up to 15 fields may appear,</span></div>
<divclass="line"><aname="l02219"></a><spanclass="lineno"> 2219</span> <spanclass="comment"># but if the number exceeds 15, the total amount of fields shown is limited to</span></div>
<divclass="line"><aname="l02222"></a><spanclass="lineno"> 2222</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02226"></a><spanclass="lineno"> 2226</span> <spanclass="comment"># If the TEMPLATE_RELATIONS tag is set to YES then the inheritance and</span></div>
<divclass="line"><aname="l02227"></a><spanclass="lineno"> 2227</span> <spanclass="comment"># collaboration graphs will show the relations between templates and their</span></div>
<divclass="line"><aname="l02229"></a><spanclass="lineno"> 2229</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l02230"></a><spanclass="lineno"> 2230</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02234"></a><spanclass="lineno"> 2234</span> <spanclass="comment"># If the INCLUDE_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are set to</span></div>
<divclass="line"><aname="l02235"></a><spanclass="lineno"> 2235</span> <spanclass="comment"># YES then doxygen will generate a graph for each documented file showing the</span></div>
<divclass="line"><aname="l02236"></a><spanclass="lineno"> 2236</span> <spanclass="comment"># direct and indirect include dependencies of the file with other documented</span></div>
<divclass="line"><aname="l02238"></a><spanclass="lineno"> 2238</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02239"></a><spanclass="lineno"> 2239</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02243"></a><spanclass="lineno"> 2243</span> <spanclass="comment"># If the INCLUDED_BY_GRAPH, ENABLE_PREPROCESSING and SEARCH_INCLUDES tags are</span></div>
<divclass="line"><aname="l02244"></a><spanclass="lineno"> 2244</span> <spanclass="comment"># set to YES then doxygen will generate a graph for each documented file showing</span></div>
<divclass="line"><aname="l02245"></a><spanclass="lineno"> 2245</span> <spanclass="comment"># the direct and indirect include dependencies of the file with other documented</span></div>
<divclass="line"><aname="l02247"></a><spanclass="lineno"> 2247</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02248"></a><spanclass="lineno"> 2248</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02252"></a><spanclass="lineno"> 2252</span> <spanclass="comment"># If the CALL_GRAPH tag is set to YES then doxygen will generate a call</span></div>
<divclass="line"><aname="l02253"></a><spanclass="lineno"> 2253</span> <spanclass="comment"># dependency graph for every global function or class method.</span></div>
<divclass="line"><aname="l02255"></a><spanclass="lineno"> 2255</span> <spanclass="comment"># Note that enabling this option will significantly increase the time of a run.</span></div>
<divclass="line"><aname="l02256"></a><spanclass="lineno"> 2256</span> <spanclass="comment"># So in most cases it will be better to enable call graphs for selected</span></div>
<divclass="line"><aname="l02257"></a><spanclass="lineno"> 2257</span> <spanclass="comment"># functions only using the \callgraph command. Disabling a call graph can be</span></div>
<divclass="line"><aname="l02258"></a><spanclass="lineno"> 2258</span> <spanclass="comment"># accomplished by means of the command \hidecallgraph.</span></div>
<divclass="line"><aname="l02259"></a><spanclass="lineno"> 2259</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l02260"></a><spanclass="lineno"> 2260</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02264"></a><spanclass="lineno"> 2264</span> <spanclass="comment"># If the CALLER_GRAPH tag is set to YES then doxygen will generate a caller</span></div>
<divclass="line"><aname="l02265"></a><spanclass="lineno"> 2265</span> <spanclass="comment"># dependency graph for every global function or class method.</span></div>
<divclass="line"><aname="l02267"></a><spanclass="lineno"> 2267</span> <spanclass="comment"># Note that enabling this option will significantly increase the time of a run.</span></div>
<divclass="line"><aname="l02268"></a><spanclass="lineno"> 2268</span> <spanclass="comment"># So in most cases it will be better to enable caller graphs for selected</span></div>
<divclass="line"><aname="l02269"></a><spanclass="lineno"> 2269</span> <spanclass="comment"># functions only using the \callergraph command. Disabling a caller graph can be</span></div>
<divclass="line"><aname="l02270"></a><spanclass="lineno"> 2270</span> <spanclass="comment"># accomplished by means of the command \hidecallergraph.</span></div>
<divclass="line"><aname="l02271"></a><spanclass="lineno"> 2271</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l02272"></a><spanclass="lineno"> 2272</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02276"></a><spanclass="lineno"> 2276</span> <spanclass="comment"># If the GRAPHICAL_HIERARCHY tag is set to YES then doxygen will graphical</span></div>
<divclass="line"><aname="l02277"></a><spanclass="lineno"> 2277</span> <spanclass="comment"># hierarchy of all classes instead of a textual one.</span></div>
<divclass="line"><aname="l02278"></a><spanclass="lineno"> 2278</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02279"></a><spanclass="lineno"> 2279</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02283"></a><spanclass="lineno"> 2283</span> <spanclass="comment"># If the DIRECTORY_GRAPH tag is set to YES then doxygen will show the</span></div>
<divclass="line"><aname="l02284"></a><spanclass="lineno"> 2284</span> <spanclass="comment"># dependencies a directory has on other directories in a graphical way. The</span></div>
<divclass="line"><aname="l02285"></a><spanclass="lineno"> 2285</span> <spanclass="comment"># dependency relations are determined by the #include relations between the</span></div>
<divclass="line"><aname="l02286"></a><spanclass="lineno"> 2286</span> <spanclass="comment"># files in the directories.</span></div>
<divclass="line"><aname="l02287"></a><spanclass="lineno"> 2287</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02288"></a><spanclass="lineno"> 2288</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02292"></a><spanclass="lineno"> 2292</span> <spanclass="comment"># The DOT_IMAGE_FORMAT tag can be used to set the image format of the images</span></div>
<divclass="line"><aname="l02293"></a><spanclass="lineno"> 2293</span> <spanclass="comment"># generated by dot. For an explanation of the image formats see the section</span></div>
<divclass="line"><aname="l02294"></a><spanclass="lineno"> 2294</span> <spanclass="comment"># output formats in the documentation of the dot tool (Graphviz (see:</span></div>
<divclass="line"><aname="l02296"></a><spanclass="lineno"> 2296</span> <spanclass="comment"># Note: If you choose svg you need to set HTML_FILE_EXTENSION to xhtml in order</span></div>
<divclass="line"><aname="l02297"></a><spanclass="lineno"> 2297</span> <spanclass="comment"># to make the SVG files visible in IE 9+ (other browsers do not have this</span></div>
<divclass="line"><aname="l02302"></a><spanclass="lineno"> 2302</span> <spanclass="comment"># The default value is: png.</span></div>
<divclass="line"><aname="l02303"></a><spanclass="lineno"> 2303</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02307"></a><spanclass="lineno"> 2307</span> <spanclass="comment"># If DOT_IMAGE_FORMAT is set to svg, then this option can be set to YES to</span></div>
<divclass="line"><aname="l02308"></a><spanclass="lineno"> 2308</span> <spanclass="comment"># enable generation of interactive SVG images that allow zooming and panning.</span></div>
<divclass="line"><aname="l02310"></a><spanclass="lineno"> 2310</span> <spanclass="comment"># Note that this requires a modern browser other than Internet Explorer. Tested</span></div>
<divclass="line"><aname="l02311"></a><spanclass="lineno"> 2311</span> <spanclass="comment"># and working are Firefox, Chrome, Safari, and Opera.</span></div>
<divclass="line"><aname="l02312"></a><spanclass="lineno"> 2312</span> <spanclass="comment"># Note: For IE 9+ you need to set HTML_FILE_EXTENSION to xhtml in order to make</span></div>
<divclass="line"><aname="l02313"></a><spanclass="lineno"> 2313</span> <spanclass="comment"># the SVG files visible. Older versions of IE do not have SVG support.</span></div>
<divclass="line"><aname="l02314"></a><spanclass="lineno"> 2314</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l02315"></a><spanclass="lineno"> 2315</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02319"></a><spanclass="lineno"> 2319</span> <spanclass="comment"># The DOT_PATH tag can be used to specify the path where the dot tool can be</span></div>
<divclass="line"><aname="l02320"></a><spanclass="lineno"> 2320</span> <spanclass="comment"># found. If left blank, it is assumed the dot tool can be found in the path.</span></div>
<divclass="line"><aname="l02321"></a><spanclass="lineno"> 2321</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02325"></a><spanclass="lineno"> 2325</span> <spanclass="comment"># The DOTFILE_DIRS tag can be used to specify one or more directories that</span></div>
<divclass="line"><aname="l02326"></a><spanclass="lineno"> 2326</span> <spanclass="comment"># contain dot files that are included in the documentation (see the \dotfile</span></div>
<divclass="line"><aname="l02328"></a><spanclass="lineno"> 2328</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02332"></a><spanclass="lineno"> 2332</span> <spanclass="comment"># The MSCFILE_DIRS tag can be used to specify one or more directories that</span></div>
<divclass="line"><aname="l02333"></a><spanclass="lineno"> 2333</span> <spanclass="comment"># contain msc files that are included in the documentation (see the \mscfile</span></div>
<divclass="line"><aname="l02338"></a><spanclass="lineno"> 2338</span> <spanclass="comment"># The DIAFILE_DIRS tag can be used to specify one or more directories that</span></div>
<divclass="line"><aname="l02339"></a><spanclass="lineno"> 2339</span> <spanclass="comment"># contain dia files that are included in the documentation (see the \diafile</span></div>
<divclass="line"><aname="l02344"></a><spanclass="lineno"> 2344</span> <spanclass="comment"># When using plantuml, the PLANTUML_JAR_PATH tag should be used to specify the</span></div>
<divclass="line"><aname="l02345"></a><spanclass="lineno"> 2345</span> <spanclass="comment"># path where java can find the plantuml.jar file. If left blank, it is assumed</span></div>
<divclass="line"><aname="l02346"></a><spanclass="lineno"> 2346</span> <spanclass="comment"># PlantUML is not used or called during a preprocessing step. Doxygen will</span></div>
<divclass="line"><aname="l02347"></a><spanclass="lineno"> 2347</span> <spanclass="comment"># generate a warning when it encounters a \startuml command in this case and</span></div>
<divclass="line"><aname="l02348"></a><spanclass="lineno"> 2348</span> <spanclass="comment"># will not generate output for the diagram.</span></div>
<divclass="line"><aname="l02352"></a><spanclass="lineno"> 2352</span> <spanclass="comment"># When using plantuml, the specified paths are searched for files specified by</span></div>
<divclass="line"><aname="l02353"></a><spanclass="lineno"> 2353</span> <spanclass="comment"># the !include statement in a plantuml block.</span></div>
<divclass="line"><aname="l02357"></a><spanclass="lineno"> 2357</span> <spanclass="comment"># The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of nodes</span></div>
<divclass="line"><aname="l02358"></a><spanclass="lineno"> 2358</span> <spanclass="comment"># that will be shown in the graph. If the number of nodes in a graph becomes</span></div>
<divclass="line"><aname="l02359"></a><spanclass="lineno"> 2359</span> <spanclass="comment"># larger than this value, doxygen will truncate the graph, which is visualized</span></div>
<divclass="line"><aname="l02360"></a><spanclass="lineno"> 2360</span> <spanclass="comment"># by representing a node as a red box. Note that doxygen if the number of direct</span></div>
<divclass="line"><aname="l02361"></a><spanclass="lineno"> 2361</span> <spanclass="comment"># children of the root node in a graph is already larger than</span></div>
<divclass="line"><aname="l02362"></a><spanclass="lineno"> 2362</span> <spanclass="comment"># DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note that</span></div>
<divclass="line"><aname="l02363"></a><spanclass="lineno"> 2363</span> <spanclass="comment"># the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.</span></div>
<divclass="line"><aname="l02365"></a><spanclass="lineno"> 2365</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02369"></a><spanclass="lineno"> 2369</span> <spanclass="comment"># The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the graphs</span></div>
<divclass="line"><aname="l02370"></a><spanclass="lineno"> 2370</span> <spanclass="comment"># generated by dot. A depth value of 3 means that only nodes reachable from the</span></div>
<divclass="line"><aname="l02371"></a><spanclass="lineno"> 2371</span> <spanclass="comment"># root by following a path via at most 3 edges will be shown. Nodes that lay</span></div>
<divclass="line"><aname="l02372"></a><spanclass="lineno"> 2372</span> <spanclass="comment"># further from the root node will be omitted. Note that setting this option to 1</span></div>
<divclass="line"><aname="l02373"></a><spanclass="lineno"> 2373</span> <spanclass="comment"># or 2 may greatly reduce the computation time needed for large code bases. Also</span></div>
<divclass="line"><aname="l02374"></a><spanclass="lineno"> 2374</span> <spanclass="comment"># note that the size of a graph can be further restricted by</span></div>
<divclass="line"><aname="l02375"></a><spanclass="lineno"> 2375</span> <spanclass="comment"># DOT_GRAPH_MAX_NODES. Using a depth of 0 means no depth restriction.</span></div>
<divclass="line"><aname="l02377"></a><spanclass="lineno"> 2377</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02381"></a><spanclass="lineno"> 2381</span> <spanclass="comment"># Set the DOT_TRANSPARENT tag to YES to generate images with a transparent</span></div>
<divclass="line"><aname="l02382"></a><spanclass="lineno"> 2382</span> <spanclass="comment"># background. This is disabled by default, because dot on Windows does not seem</span></div>
<divclass="line"><aname="l02383"></a><spanclass="lineno"> 2383</span> <spanclass="comment"># to support this out of the box.</span></div>
<divclass="line"><aname="l02385"></a><spanclass="lineno"> 2385</span> <spanclass="comment"># Warning: Depending on the platform used, enabling this option may lead to</span></div>
<divclass="line"><aname="l02386"></a><spanclass="lineno"> 2386</span> <spanclass="comment"># badly anti-aliased labels on the edges of a graph (i.e. they become hard to</span></div>
<divclass="line"><aname="l02388"></a><spanclass="lineno"> 2388</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l02389"></a><spanclass="lineno"> 2389</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02393"></a><spanclass="lineno"> 2393</span> <spanclass="comment"># Set the DOT_MULTI_TARGETS tag to YES to allow dot to generate multiple output</span></div>
<divclass="line"><aname="l02394"></a><spanclass="lineno"> 2394</span> <spanclass="comment"># files in one run (i.e. multiple -o and -T options on the command line). This</span></div>
<divclass="line"><aname="l02395"></a><spanclass="lineno"> 2395</span> <spanclass="comment"># makes dot run faster, but since only newer versions of dot (>1.8.10) support</span></div>
<divclass="line"><aname="l02396"></a><spanclass="lineno"> 2396</span> <spanclass="comment"># this, this feature is disabled by default.</span></div>
<divclass="line"><aname="l02397"></a><spanclass="lineno"> 2397</span> <spanclass="comment"># The default value is: NO.</span></div>
<divclass="line"><aname="l02398"></a><spanclass="lineno"> 2398</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02402"></a><spanclass="lineno"> 2402</span> <spanclass="comment"># If the GENERATE_LEGEND tag is set to YES doxygen will generate a legend page</span></div>
<divclass="line"><aname="l02403"></a><spanclass="lineno"> 2403</span> <spanclass="comment"># explaining the meaning of the various boxes and arrows in the dot generated</span></div>
<divclass="line"><aname="l02405"></a><spanclass="lineno"> 2405</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02406"></a><spanclass="lineno"> 2406</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
<divclass="line"><aname="l02410"></a><spanclass="lineno"> 2410</span> <spanclass="comment"># If the DOT_CLEANUP tag is set to YES, doxygen will remove the intermediate dot</span></div>
<divclass="line"><aname="l02411"></a><spanclass="lineno"> 2411</span> <spanclass="comment"># files that are used to generate the various graphs.</span></div>
<divclass="line"><aname="l02412"></a><spanclass="lineno"> 2412</span> <spanclass="comment"># The default value is: YES.</span></div>
<divclass="line"><aname="l02413"></a><spanclass="lineno"> 2413</span> <spanclass="comment"># This tag requires that the tag HAVE_DOT is set to YES.</span></div>
