1*404b540aSrobert# Doxyfile 1.5.1
2*404b540aSrobert
3*404b540aSrobert# This file describes the settings to be used by the documentation system
4*404b540aSrobert# doxygen (www.doxygen.org) for a project
5*404b540aSrobert#
6*404b540aSrobert# All text after a hash (#) is considered a comment and will be ignored
7*404b540aSrobert# The format is:
8*404b540aSrobert#       TAG = value [value, ...]
9*404b540aSrobert# For lists items can also be appended using:
10*404b540aSrobert#       TAG += value [value, ...]
11*404b540aSrobert# Values that contain spaces should be placed between quotes (" ")
12*404b540aSrobert
13*404b540aSrobert#---------------------------------------------------------------------------
14*404b540aSrobert# Project related configuration options
15*404b540aSrobert#---------------------------------------------------------------------------
16*404b540aSrobert
17*404b540aSrobert# The PROJECT_NAME tag is a single word (or a sequence of words surrounded
18*404b540aSrobert# by quotes) that should identify the project.
19*404b540aSrobert
20*404b540aSrobertPROJECT_NAME           = libstdc++
21*404b540aSrobert
22*404b540aSrobert# The PROJECT_NUMBER tag can be used to enter a project or revision number.
23*404b540aSrobert# This could be handy for archiving the generated documentation or
24*404b540aSrobert# if some version control system is used.
25*404b540aSrobert
26*404b540aSrobertPROJECT_NUMBER         =
27*404b540aSrobert
28*404b540aSrobert# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
29*404b540aSrobert# base path where the generated documentation will be put.
30*404b540aSrobert# If a relative path is entered, it will be relative to the location
31*404b540aSrobert# where doxygen was started. If left blank the current directory will be used.
32*404b540aSrobert
33*404b540aSrobertOUTPUT_DIRECTORY       = @outdir@
34*404b540aSrobert
35*404b540aSrobert# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create
36*404b540aSrobert# 4096 sub-directories (in 2 levels) under the output directory of each output
37*404b540aSrobert# format and will distribute the generated files over these directories.
38*404b540aSrobert# Enabling this option can be useful when feeding doxygen a huge amount of
39*404b540aSrobert# source files, where putting all generated files in the same directory would
40*404b540aSrobert# otherwise cause performance problems for the file system.
41*404b540aSrobert
42*404b540aSrobertCREATE_SUBDIRS         = NO
43*404b540aSrobert
44*404b540aSrobert# The OUTPUT_LANGUAGE tag is used to specify the language in which all
45*404b540aSrobert# documentation generated by doxygen is written. Doxygen will use this
46*404b540aSrobert# information to generate all constant output in the proper language.
47*404b540aSrobert# The default language is English, other supported languages are:
48*404b540aSrobert# Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional,
49*404b540aSrobert# Croatian, Czech, Danish, Dutch, Finnish, French, German, Greek, Hungarian,
50*404b540aSrobert# Italian, Japanese, Japanese-en (Japanese with English messages), Korean,
51*404b540aSrobert# Korean-en, Lithuanian, Norwegian, Polish, Portuguese, Romanian, Russian,
52*404b540aSrobert# Serbian, Slovak, Slovene, Spanish, Swedish, and Ukrainian.
53*404b540aSrobert
54*404b540aSrobertOUTPUT_LANGUAGE        = English
55*404b540aSrobert
56*404b540aSrobert# This tag can be used to specify the encoding used in the generated
57*404b540aSrobert# output.  The encoding is not always determined by the language that
58*404b540aSrobert# is chosen, but also whether or not the output is meant for Windows
59*404b540aSrobert# or non-Windows users.  In case there is a difference, setting the
60*404b540aSrobert# USE_WINDOWS_ENCODING tag to YES forces the Windows encoding (this is
61*404b540aSrobert# the default for the Windows binary), whereas setting the tag to NO
62*404b540aSrobert# uses a Unix-style encoding (the default for all platforms other than
63*404b540aSrobert# Windows).
64*404b540aSrobert
65*404b540aSrobertUSE_WINDOWS_ENCODING   = NO
66*404b540aSrobert
67*404b540aSrobert# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will
68*404b540aSrobert# include brief member descriptions after the members that are listed in
69*404b540aSrobert# the file and class documentation (similar to JavaDoc).
70*404b540aSrobert# Set to NO to disable this.
71*404b540aSrobert
72*404b540aSrobertBRIEF_MEMBER_DESC      = NO
73*404b540aSrobert
74*404b540aSrobert# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will
75*404b540aSrobert# prepend the brief description of a member or function before the
76*404b540aSrobert# detailed description.  Note: if both HIDE_UNDOC_MEMBERS and
77*404b540aSrobert# BRIEF_MEMBER_DESC are set to NO, the brief descriptions will be
78*404b540aSrobert# completely suppressed.
79*404b540aSrobert
80*404b540aSrobertREPEAT_BRIEF           = NO
81*404b540aSrobert
82*404b540aSrobert# This tag implements a quasi-intelligent brief description abbreviator
83*404b540aSrobert# that is used to form the text in various listings. Each string
84*404b540aSrobert# in this list, if found as the leading text of the brief description, will be
85*404b540aSrobert# stripped from the text and the result after processing the whole list, is
86*404b540aSrobert# used as the annotated text. Otherwise, the brief description is used as-is.
87*404b540aSrobert# If left blank, the following values are used ("$name" is automatically
88*404b540aSrobert# replaced with the name of the entity): "The $name class" "The $name widget"
89*404b540aSrobert# "The $name file" "is" "provides" "specifies" "contains"
90*404b540aSrobert# "represents" "a" "an" "the"
91*404b540aSrobert
92*404b540aSrobertABBREVIATE_BRIEF       =
93*404b540aSrobert
94*404b540aSrobert# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
95*404b540aSrobert# Doxygen will generate a detailed section even if there is only a brief
96*404b540aSrobert# description.
97*404b540aSrobert
98*404b540aSrobertALWAYS_DETAILED_SEC    = YES
99*404b540aSrobert
100*404b540aSrobert# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show
101*404b540aSrobert# all inherited members of a class in the documentation of that class
102*404b540aSrobert# as if those members were ordinary class members. Constructors,
103*404b540aSrobert# destructors and assignment operators of the base classes will not be
104*404b540aSrobert# shown.
105*404b540aSrobert
106*404b540aSrobertINLINE_INHERITED_MEMB  = YES
107*404b540aSrobert
108*404b540aSrobert# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full
109*404b540aSrobert# path before files name in the file list and in the header files. If set
110*404b540aSrobert# to NO the shortest path that makes the file name unique will be used.
111*404b540aSrobert
112*404b540aSrobertFULL_PATH_NAMES        = NO
113*404b540aSrobert
114*404b540aSrobert# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag
115*404b540aSrobert# can be used to strip a user-defined part of the path. Stripping is
116*404b540aSrobert# only done if one of the specified strings matches the left-hand part of
117*404b540aSrobert# the path. The tag can be used to show relative paths in the file list.
118*404b540aSrobert# If left blank the directory from which doxygen is run is used as the
119*404b540aSrobert# path to strip.
120*404b540aSrobert
121*404b540aSrobertSTRIP_FROM_PATH        =
122*404b540aSrobert
123*404b540aSrobert# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of
124*404b540aSrobert# the path mentioned in the documentation of a class, which tells
125*404b540aSrobert# the reader which header file to include in order to use a class.
126*404b540aSrobert# If left blank only the name of the header file containing the class
127*404b540aSrobert# definition is used. Otherwise one should specify the include paths that
128*404b540aSrobert# are normally passed to the compiler using the -I flag.
129*404b540aSrobert
130*404b540aSrobertSTRIP_FROM_INC_PATH    =
131*404b540aSrobert
132*404b540aSrobert# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter
133*404b540aSrobert# (but less readable) file names. This can be useful is your file systems
134*404b540aSrobert# doesn't support long names like on DOS, Mac, or CD-ROM.
135*404b540aSrobert
136*404b540aSrobertSHORT_NAMES            = NO
137*404b540aSrobert
138*404b540aSrobert# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen
139*404b540aSrobert# will interpret the first line (until the first dot) of a JavaDoc-style
140*404b540aSrobert# comment as the brief description. If set to NO, the JavaDoc
141*404b540aSrobert# comments will behave just like the Qt-style comments (thus requiring an
142*404b540aSrobert# explicit @brief command for a brief description.
143*404b540aSrobert
144*404b540aSrobertJAVADOC_AUTOBRIEF      = NO
145*404b540aSrobert
146*404b540aSrobert# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen
147*404b540aSrobert# treat a multi-line C++ special comment block (i.e. a block of //! or ///
148*404b540aSrobert# comments) as a brief description. This used to be the default behaviour.
149*404b540aSrobert# The new default is to treat a multi-line C++ comment block as a detailed
150*404b540aSrobert# description. Set this tag to YES if you prefer the old behaviour instead.
151*404b540aSrobert
152*404b540aSrobertMULTILINE_CPP_IS_BRIEF = YES
153*404b540aSrobert
154*404b540aSrobert# If the DETAILS_AT_TOP tag is set to YES then Doxygen
155*404b540aSrobert# will output the detailed description near the top, like JavaDoc.
156*404b540aSrobert# If set to NO, the detailed description appears after the member
157*404b540aSrobert# documentation.
158*404b540aSrobert
159*404b540aSrobertDETAILS_AT_TOP         = YES
160*404b540aSrobert
161*404b540aSrobert# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented
162*404b540aSrobert# member inherits the documentation from any documented member that it
163*404b540aSrobert# re-implements.
164*404b540aSrobert
165*404b540aSrobertINHERIT_DOCS           = YES
166*404b540aSrobert
167*404b540aSrobert# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce
168*404b540aSrobert# a new page for each member. If set to NO, the documentation of a member will
169*404b540aSrobert# be part of the file/class/namespace that contains it.
170*404b540aSrobert
171*404b540aSrobertSEPARATE_MEMBER_PAGES  = NO
172*404b540aSrobert
173*404b540aSrobert# The TAB_SIZE tag can be used to set the number of spaces in a tab.
174*404b540aSrobert# Doxygen uses this value to replace tabs by spaces in code fragments.
175*404b540aSrobert
176*404b540aSrobertTAB_SIZE               = 4
177*404b540aSrobert
178*404b540aSrobert# This tag can be used to specify a number of aliases that acts
179*404b540aSrobert# as commands in the documentation. An alias has the form "name=value".
180*404b540aSrobert# For example adding "sideeffect=\par Side Effects:\n" will allow you to
181*404b540aSrobert# put the command \sideeffect (or @sideeffect) in the documentation, which
182*404b540aSrobert# will result in a user-defined paragraph with heading "Side Effects:".
183*404b540aSrobert# You can put \n's in the value part of an alias to insert newlines.
184*404b540aSrobert
185*404b540aSrobertALIASES                = "doctodo=@todo\nDoc me!  See docs/doxygen/TODO and http://gcc.gnu.org/ml/libstdc++/2002-02/msg00003.html for more." \
186*404b540aSrobert                         "isiosfwd=One of the @link s27_2_iosfwd I/O forward declarations @endlink"
187*404b540aSrobert
188*404b540aSrobert# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C
189*404b540aSrobert# sources only. Doxygen will then generate output that is more tailored for C.
190*404b540aSrobert# For instance, some of the names that are used will be different. The list
191*404b540aSrobert# of all members will be omitted, etc.
192*404b540aSrobert
193*404b540aSrobertOPTIMIZE_OUTPUT_FOR_C  = NO
194*404b540aSrobert
195*404b540aSrobert# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of
196*404b540aSrobert# Java sources only. Doxygen will then generate output that is more
197*404b540aSrobert# tailored for Java.  For instance, namespaces will be presented as
198*404b540aSrobert# packages, qualified scopes will look different, etc.
199*404b540aSrobert
200*404b540aSrobertOPTIMIZE_OUTPUT_JAVA   = NO
201*404b540aSrobert
202*404b540aSrobert# If you use STL classes (i.e. std::string, std::vector, etc.) but do
203*404b540aSrobert# not want to include (a tag file for) the STL sources as input, then
204*404b540aSrobert# you should set this tag to YES in order to let doxygen match
205*404b540aSrobert# functions declarations and definitions whose arguments contain STL
206*404b540aSrobert# classes (e.g. func(std::string); v.s.  func(std::string) {}). This
207*404b540aSrobert# also make the inheritance and collaboration diagrams that involve
208*404b540aSrobert# STL classes more complete and accurate.
209*404b540aSrobert
210*404b540aSrobertBUILTIN_STL_SUPPORT    = NO
211*404b540aSrobert
212*404b540aSrobert# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
213*404b540aSrobert# tag is set to YES, then doxygen will reuse the documentation of the first
214*404b540aSrobert# member in the group (if any) for the other members of the group. By default
215*404b540aSrobert# all members of a group must be documented explicitly.
216*404b540aSrobert
217*404b540aSrobertDISTRIBUTE_GROUP_DOC   = YES
218*404b540aSrobert
219*404b540aSrobert# Set the SUBGROUPING tag to YES (the default) to allow class member groups of
220*404b540aSrobert# the same type (for instance a group of public functions) to be put as a
221*404b540aSrobert# subgroup of that type (e.g. under the Public Functions section). Set it to
222*404b540aSrobert# NO to prevent subgrouping. Alternatively, this can be done per class using
223*404b540aSrobert# the \nosubgrouping command.
224*404b540aSrobert
225*404b540aSrobertSUBGROUPING            = YES
226*404b540aSrobert
227*404b540aSrobert#---------------------------------------------------------------------------
228*404b540aSrobert# Build related configuration options
229*404b540aSrobert#---------------------------------------------------------------------------
230*404b540aSrobert
231*404b540aSrobert# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
232*404b540aSrobert# documentation are documented, even if no documentation was available.
233*404b540aSrobert# Private class members and static file members will be hidden unless
234*404b540aSrobert# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES
235*404b540aSrobert
236*404b540aSrobertEXTRACT_ALL            = NO
237*404b540aSrobert
238*404b540aSrobert# If the EXTRACT_PRIVATE tag is set to YES all private members of a class
239*404b540aSrobert# will be included in the documentation.
240*404b540aSrobert
241*404b540aSrobertEXTRACT_PRIVATE        = NO
242*404b540aSrobert
243*404b540aSrobert# If the EXTRACT_STATIC tag is set to YES all static members of a file
244*404b540aSrobert# will be included in the documentation.
245*404b540aSrobert
246*404b540aSrobertEXTRACT_STATIC         = YES
247*404b540aSrobert
248*404b540aSrobert# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs)
249*404b540aSrobert# defined locally in source files will be included in the documentation.
250*404b540aSrobert# If set to NO only classes defined in header files are included.
251*404b540aSrobert
252*404b540aSrobertEXTRACT_LOCAL_CLASSES  = YES
253*404b540aSrobert
254*404b540aSrobert# This flag is only useful for Objective-C code. When set to YES local
255*404b540aSrobert# methods, which are defined in the implementation section but not in
256*404b540aSrobert# the interface are included in the documentation.
257*404b540aSrobert# If set to NO (the default) only methods in the interface are included.
258*404b540aSrobert
259*404b540aSrobertEXTRACT_LOCAL_METHODS  = YES
260*404b540aSrobert
261*404b540aSrobert# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all
262*404b540aSrobert# undocumented members of documented classes, files or namespaces.
263*404b540aSrobert# If set to NO (the default) these members will be included in the
264*404b540aSrobert# various overviews, but no documentation section is generated.
265*404b540aSrobert# This option has no effect if EXTRACT_ALL is enabled.
266*404b540aSrobert
267*404b540aSrobertHIDE_UNDOC_MEMBERS     = NO
268*404b540aSrobert
269*404b540aSrobert# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all
270*404b540aSrobert# undocumented classes that are normally visible in the class hierarchy.
271*404b540aSrobert# If set to NO (the default) these classes will be included in the various
272*404b540aSrobert# overviews. This option has no effect if EXTRACT_ALL is enabled.
273*404b540aSrobert
274*404b540aSrobertHIDE_UNDOC_CLASSES     = YES
275*404b540aSrobert
276*404b540aSrobert# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all
277*404b540aSrobert# friend (class|struct|union) declarations.
278*404b540aSrobert# If set to NO (the default) these declarations will be included in the
279*404b540aSrobert# documentation.
280*404b540aSrobert
281*404b540aSrobertHIDE_FRIEND_COMPOUNDS  = NO
282*404b540aSrobert
283*404b540aSrobert# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any
284*404b540aSrobert# documentation blocks found inside the body of a function.
285*404b540aSrobert# If set to NO (the default) these blocks will be appended to the
286*404b540aSrobert# function's detailed documentation block.
287*404b540aSrobert
288*404b540aSrobertHIDE_IN_BODY_DOCS      = NO
289*404b540aSrobert
290*404b540aSrobert# The INTERNAL_DOCS tag determines if documentation
291*404b540aSrobert# that is typed after a \internal command is included. If the tag is set
292*404b540aSrobert# to NO (the default) then the documentation will be excluded.
293*404b540aSrobert# Set it to YES to include the internal documentation.
294*404b540aSrobert
295*404b540aSrobertINTERNAL_DOCS          = NO
296*404b540aSrobert
297*404b540aSrobert# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate
298*404b540aSrobert# file names in lower-case letters. If set to YES upper-case letters are also
299*404b540aSrobert# allowed. This is useful if you have classes or files whose names only differ
300*404b540aSrobert# in case and if your file system supports case sensitive file names. Windows
301*404b540aSrobert# and Mac users are advised to set this option to NO.
302*404b540aSrobert
303*404b540aSrobertCASE_SENSE_NAMES       = NO#
304*404b540aSrobert
305*404b540aSrobert# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen
306*404b540aSrobert# will show members with their full class and namespace scopes in the
307*404b540aSrobert# documentation. If set to YES the scope will be hidden.
308*404b540aSrobert
309*404b540aSrobertHIDE_SCOPE_NAMES       = NO
310*404b540aSrobert#HIDE_SCOPE_NAMES       = YES
311*404b540aSrobert
312*404b540aSrobert# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then
313*404b540aSrobert# Doxygen will put a list of the files that are included by a file in
314*404b540aSrobert# the documentation of that file.
315*404b540aSrobert
316*404b540aSrobertSHOW_INCLUDE_FILES     = NO
317*404b540aSrobert
318*404b540aSrobert# If the INLINE_INFO tag is set to YES (the default) then a tag [inline]
319*404b540aSrobert# is inserted in the documentation for inline members.
320*404b540aSrobert
321*404b540aSrobertINLINE_INFO            = YES
322*404b540aSrobert
323*404b540aSrobert# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen
324*404b540aSrobert# will sort the (detailed) documentation of file and class members
325*404b540aSrobert# alphabetically by member name. If set to NO the members will appear in
326*404b540aSrobert# declaration order.
327*404b540aSrobert
328*404b540aSrobertSORT_MEMBER_DOCS       = YES
329*404b540aSrobert
330*404b540aSrobert# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the
331*404b540aSrobert# brief documentation of file, namespace and class members alphabetically
332*404b540aSrobert# by member name. If set to NO (the default) the members will appear in
333*404b540aSrobert# declaration order.
334*404b540aSrobert
335*404b540aSrobertSORT_BRIEF_DOCS        = YES
336*404b540aSrobert
337*404b540aSrobert# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be
338*404b540aSrobert# sorted by fully-qualified names, including namespaces. If set to
339*404b540aSrobert# NO (the default), the class list will be sorted only by class name,
340*404b540aSrobert# not including the namespace part.
341*404b540aSrobert# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES.
342*404b540aSrobert# Note: This option applies only to the class list, not to the
343*404b540aSrobert# alphabetical list.
344*404b540aSrobert
345*404b540aSrobert#SORT_BY_SCOPE_NAME     = NO
346*404b540aSrobertSORT_BY_SCOPE_NAME     = YES
347*404b540aSrobert
348*404b540aSrobert# The GENERATE_TODOLIST tag can be used to enable (YES) or
349*404b540aSrobert# disable (NO) the todo list. This list is created by putting \todo
350*404b540aSrobert# commands in the documentation.
351*404b540aSrobert
352*404b540aSrobertGENERATE_TODOLIST      = YES
353*404b540aSrobert
354*404b540aSrobert# The GENERATE_TESTLIST tag can be used to enable (YES) or
355*404b540aSrobert# disable (NO) the test list. This list is created by putting \test
356*404b540aSrobert# commands in the documentation.
357*404b540aSrobert
358*404b540aSrobertGENERATE_TESTLIST      = NO
359*404b540aSrobert
360*404b540aSrobert# The GENERATE_BUGLIST tag can be used to enable (YES) or
361*404b540aSrobert# disable (NO) the bug list. This list is created by putting \bug
362*404b540aSrobert# commands in the documentation.
363*404b540aSrobert
364*404b540aSrobertGENERATE_BUGLIST       = YES
365*404b540aSrobert
366*404b540aSrobert# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or
367*404b540aSrobert# disable (NO) the deprecated list. This list is created by putting
368*404b540aSrobert# \deprecated commands in the documentation.
369*404b540aSrobert
370*404b540aSrobertGENERATE_DEPRECATEDLIST= YES
371*404b540aSrobert
372*404b540aSrobert# The ENABLED_SECTIONS tag can be used to enable conditional
373*404b540aSrobert# documentation sections, marked by \if sectionname ... \endif.
374*404b540aSrobert
375*404b540aSrobertENABLED_SECTIONS       = @enabled_sections@
376*404b540aSrobert
377*404b540aSrobert# The MAX_INITIALIZER_LINES tag determines the maximum number of lines
378*404b540aSrobert# the initial value of a variable or define consists of for it to appear in
379*404b540aSrobert# the documentation. If the initializer consists of more lines than specified
380*404b540aSrobert# here it will be hidden. Use a value of 0 to hide initializers completely.
381*404b540aSrobert# The appearance of the initializer of individual variables and defines in the
382*404b540aSrobert# documentation can be controlled using \showinitializer or \hideinitializer
383*404b540aSrobert# command in the documentation regardless of this setting.
384*404b540aSrobert
385*404b540aSrobertMAX_INITIALIZER_LINES  = 0
386*404b540aSrobert
387*404b540aSrobert# Set the SHOW_USED_FILES tag to NO to disable the list of files generated
388*404b540aSrobert# at the bottom of the documentation of classes and structs. If set to YES the
389*404b540aSrobert# list will mention the files that were used to generate the documentation.
390*404b540aSrobert
391*404b540aSrobertSHOW_USED_FILES        = YES
392*404b540aSrobert
393*404b540aSrobert# If the sources in your project are distributed over multiple
394*404b540aSrobert# directories then setting the SHOW_DIRECTORIES tag to YES will show
395*404b540aSrobert# the directory hierarchy in the documentation. The default is NO.
396*404b540aSrobert
397*404b540aSrobertSHOW_DIRECTORIES       = YES
398*404b540aSrobert
399*404b540aSrobert# The FILE_VERSION_FILTER tag can be used to specify a program or
400*404b540aSrobert# script that doxygen should invoke to get the current version for
401*404b540aSrobert# each file (typically from the version control system). Doxygen will
402*404b540aSrobert# invoke the program by executing (via popen()) the command <command>
403*404b540aSrobert# <input-file>, where <command> is the value of the
404*404b540aSrobert# FILE_VERSION_FILTER tag, and <input-file> is the name of an input
405*404b540aSrobert# file provided by doxygen. Whatever the program writes to standard
406*404b540aSrobert# output is used as the file version. See the manual for examples.
407*404b540aSrobert
408*404b540aSrobertFILE_VERSION_FILTER    =
409*404b540aSrobert
410*404b540aSrobert#---------------------------------------------------------------------------
411*404b540aSrobert# configuration options related to warning and progress messages
412*404b540aSrobert#---------------------------------------------------------------------------
413*404b540aSrobert
414*404b540aSrobert# The QUIET tag can be used to turn on/off the messages that are generated
415*404b540aSrobert# by doxygen. Possible values are YES and NO. If left blank NO is used.
416*404b540aSrobert
417*404b540aSrobertQUIET                  = NO
418*404b540aSrobert
419*404b540aSrobert# The WARNINGS tag can be used to turn on/off the warning messages that are
420*404b540aSrobert# generated by doxygen. Possible values are YES and NO. If left blank
421*404b540aSrobert# NO is used.
422*404b540aSrobert
423*404b540aSrobertWARNINGS               = YES
424*404b540aSrobert
425*404b540aSrobert# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings
426*404b540aSrobert# for undocumented members. If EXTRACT_ALL is set to YES then this flag will
427*404b540aSrobert# automatically be disabled.
428*404b540aSrobert
429*404b540aSrobertWARN_IF_UNDOCUMENTED   = NO
430*404b540aSrobert
431*404b540aSrobert# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for
432*404b540aSrobert# potential errors in the documentation, such as not documenting some
433*404b540aSrobert# parameters in a documented function, or documenting parameters that
434*404b540aSrobert# don't exist or using markup commands wrongly.
435*404b540aSrobert
436*404b540aSrobertWARN_IF_DOC_ERROR      = NO
437*404b540aSrobert
438*404b540aSrobert# This WARN_NO_PARAMDOC option can be abled to get warnings for
439*404b540aSrobert# functions that are documented, but have no documentation for their
440*404b540aSrobert# parameters or return value. If set to NO (the default) doxygen will
441*404b540aSrobert# only warn about wrong or incomplete parameter documentation, but not
442*404b540aSrobert# about the absence of documentation.
443*404b540aSrobert
444*404b540aSrobertWARN_NO_PARAMDOC       = NO
445*404b540aSrobert
446*404b540aSrobert# The WARN_FORMAT tag determines the format of the warning messages that
447*404b540aSrobert# doxygen can produce. The string should contain the $file, $line, and $text
448*404b540aSrobert# tags, which will be replaced by the file and line number from which the
449*404b540aSrobert# warning originated and the warning text. Optionally the format may contain
450*404b540aSrobert# $version, which will be replaced by the version of the file (if it could
451*404b540aSrobert# be obtained via FILE_VERSION_FILTER)
452*404b540aSrobert
453*404b540aSrobertWARN_FORMAT            = "$file:$line: $text"
454*404b540aSrobert
455*404b540aSrobert# The WARN_LOGFILE tag can be used to specify a file to which warning
456*404b540aSrobert# and error messages should be written. If left blank the output is written
457*404b540aSrobert# to stderr.
458*404b540aSrobert
459*404b540aSrobertWARN_LOGFILE           =
460*404b540aSrobert
461*404b540aSrobert#---------------------------------------------------------------------------
462*404b540aSrobert# configuration options related to the input files
463*404b540aSrobert#---------------------------------------------------------------------------
464*404b540aSrobert
465*404b540aSrobert# The INPUT tag can be used to specify the files and/or directories
466*404b540aSrobert# that contain documented source files. You may enter file names like
467*404b540aSrobert# "myfile.cpp" or directories like "/usr/src/myproject". Separate the
468*404b540aSrobert# files or directories with spaces.
469*404b540aSrobert
470*404b540aSrobertINPUT                  = @srcdir@/docs/doxygen/doxygroups.cc \
471*404b540aSrobert                   	 @srcdir@/include/precompiled/stdc++.h \
472*404b540aSrobert                   	 @srcdir@/include/precompiled/stdtr1c++.h \
473*404b540aSrobert                   	 @srcdir@/include/precompiled/extc++.h \
474*404b540aSrobert                   	 @srcdir@/libsupc++/cxxabi.h \
475*404b540aSrobert                         @srcdir@/libsupc++/exception \
476*404b540aSrobert                         @srcdir@/libsupc++/new \
477*404b540aSrobert                         @srcdir@/libsupc++/typeinfo \
478*404b540aSrobert                         include/@host_alias@/bits \
479*404b540aSrobert                         include/bits \
480*404b540aSrobert                         include/debug \
481*404b540aSrobert                         include/ext \
482*404b540aSrobert                         include/tr1 \
483*404b540aSrobert                         include/algorithm \
484*404b540aSrobert                         include/bitset \
485*404b540aSrobert                         include/cassert \
486*404b540aSrobert                         include/cctype \
487*404b540aSrobert                         include/cerrno \
488*404b540aSrobert                         include/cfloat \
489*404b540aSrobert                         include/ciso646 \
490*404b540aSrobert                         include/climits \
491*404b540aSrobert                         include/clocale \
492*404b540aSrobert                         include/cmath \
493*404b540aSrobert                         include/csetjmp \
494*404b540aSrobert                         include/csignal \
495*404b540aSrobert                         include/cstdarg \
496*404b540aSrobert                         include/cstddef \
497*404b540aSrobert                         include/cstdio \
498*404b540aSrobert                         include/cstdlib \
499*404b540aSrobert                         include/cstring \
500*404b540aSrobert                         include/ctime \
501*404b540aSrobert                         include/cwchar \
502*404b540aSrobert                         include/cwctype \
503*404b540aSrobert                         include/deque \
504*404b540aSrobert                         include/fstream \
505*404b540aSrobert                         include/functional \
506*404b540aSrobert                         include/iomanip \
507*404b540aSrobert                         include/ios \
508*404b540aSrobert                         include/iosfwd \
509*404b540aSrobert                         include/iostream \
510*404b540aSrobert                         include/istream \
511*404b540aSrobert                         include/iterator \
512*404b540aSrobert                         include/limits \
513*404b540aSrobert                         include/list \
514*404b540aSrobert                         include/locale \
515*404b540aSrobert                         include/map \
516*404b540aSrobert                         include/memory \
517*404b540aSrobert                         include/numeric \
518*404b540aSrobert                         include/ostream \
519*404b540aSrobert                         include/queue \
520*404b540aSrobert                         include/set \
521*404b540aSrobert                         include/sstream \
522*404b540aSrobert                         include/stack \
523*404b540aSrobert                         include/stdexcept \
524*404b540aSrobert                         include/streambuf \
525*404b540aSrobert                         include/string \
526*404b540aSrobert                         include/utility \
527*404b540aSrobert                         include/valarray \
528*404b540aSrobert                         include/vector \
529*404b540aSrobert                         include/debug/bitset \
530*404b540aSrobert                         include/debug/deque \
531*404b540aSrobert                         include/debug/hash_map \
532*404b540aSrobert                         include/debug/hash_set \
533*404b540aSrobert                         include/debug/list \
534*404b540aSrobert                         include/debug/map \
535*404b540aSrobert                         include/debug/set \
536*404b540aSrobert                         include/debug/string \
537*404b540aSrobert                         include/debug/vector \
538*404b540aSrobert                         include/ext/algorithm \
539*404b540aSrobert                         include/ext/functional \
540*404b540aSrobert                         include/ext/hash_map \
541*404b540aSrobert                         include/ext/hash_set \
542*404b540aSrobert                         include/ext/iterator \
543*404b540aSrobert                         include/ext/memory \
544*404b540aSrobert                         include/ext/numeric \
545*404b540aSrobert                         include/ext/rb_tree \
546*404b540aSrobert                         include/ext/rope \
547*404b540aSrobert                         include/ext/slist \
548*404b540aSrobert                         include/ext/pb_ds \
549*404b540aSrobert                         include/ext/pb_ds/detail \
550*404b540aSrobert                         include/tr1/array \
551*404b540aSrobert                         include/tr1/cctype \
552*404b540aSrobert                         include/tr1/cfenv \
553*404b540aSrobert                         include/tr1/cfloat \
554*404b540aSrobert                         include/tr1/cinttypes \
555*404b540aSrobert                         include/tr1/climits \
556*404b540aSrobert                         include/tr1/cmath \
557*404b540aSrobert                         include/tr1/complex \
558*404b540aSrobert                         include/tr1/cstdarg \
559*404b540aSrobert                         include/tr1/cstdbool \
560*404b540aSrobert                         include/tr1/cstdint \
561*404b540aSrobert                         include/tr1/cstdio \
562*404b540aSrobert                         include/tr1/cstdlib \
563*404b540aSrobert                         include/tr1/ctgmath \
564*404b540aSrobert                         include/tr1/ctime \
565*404b540aSrobert                         include/tr1/cwchar \
566*404b540aSrobert                         include/tr1/cwctype \
567*404b540aSrobert                         include/tr1/functional \
568*404b540aSrobert                         include/tr1/hashtable \
569*404b540aSrobert                         include/tr1/memory \
570*404b540aSrobert                         include/tr1/random \
571*404b540aSrobert                         include/tr1/tuple \
572*404b540aSrobert                         include/tr1/type_traits \
573*404b540aSrobert                         include/tr1/unordered_map \
574*404b540aSrobert                         include/tr1/unordered_set \
575*404b540aSrobert                         include/tr1/utility
576*404b540aSrobert
577*404b540aSrobert# If the value of the INPUT tag contains directories, you can use the
578*404b540aSrobert# FILE_PATTERNS tag to specify one or more wildcard pattern (like
579*404b540aSrobert# *.cpp and *.h) to filter out the source-files in the directories. If
580*404b540aSrobert# left blank the following patterns are tested: *.c *.cc *.cxx *.cpp
581*404b540aSrobert# *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx *.hpp *.h++
582*404b540aSrobert# *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm *.py
583*404b540aSrobert
584*404b540aSrobertFILE_PATTERNS          = *.h \
585*404b540aSrobert                         *.hpp \
586*404b540aSrobert                         *.tcc
587*404b540aSrobert
588*404b540aSrobert# The RECURSIVE tag can be used to turn specify whether or not subdirectories
589*404b540aSrobert# should be searched for input files as well. Possible values are YES and NO.
590*404b540aSrobert# If left blank NO is used.
591*404b540aSrobert
592*404b540aSrobertRECURSIVE              = NO
593*404b540aSrobert
594*404b540aSrobert# The EXCLUDE tag can be used to specify files and/or directories that
595*404b540aSrobert# should excluded from the INPUT source files. This way you can easily
596*404b540aSrobert# exclude a subdirectory from a directory tree whose root is specified
597*404b540aSrobert# with the INPUT tag.
598*404b540aSrobert
599*404b540aSrobertEXCLUDE                = Makefile
600*404b540aSrobert
601*404b540aSrobert# The EXCLUDE_SYMLINKS tag can be used select whether or not files or
602*404b540aSrobert# directories that are symbolic links (a Unix filesystem feature) are excluded
603*404b540aSrobert# from the input.
604*404b540aSrobert
605*404b540aSrobertEXCLUDE_SYMLINKS       = NO
606*404b540aSrobert
607*404b540aSrobert# If the value of the INPUT tag contains directories, you can use the
608*404b540aSrobert# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
609*404b540aSrobert# certain files from those directories. Note that the wildcards are matched
610*404b540aSrobert# against the file with absolute path, so to exclude all test directories
611*404b540aSrobert# for example use the pattern */test/*
612*404b540aSrobert
613*404b540aSrobertEXCLUDE_PATTERNS       = stamp-* \
614*404b540aSrobert                         *stdc++.h* \
615*404b540aSrobert                         *stdtr1c++.h* \
616*404b540aSrobert                         *extc++.h* \
617*404b540aSrobert                         */.svn/*
618*404b540aSrobert
619*404b540aSrobert# The EXAMPLE_PATH tag can be used to specify one or more files or
620*404b540aSrobert# directories that contain example code fragments that are included (see
621*404b540aSrobert# the \include command).
622*404b540aSrobert
623*404b540aSrobertEXAMPLE_PATH           =
624*404b540aSrobert
625*404b540aSrobert# If the value of the EXAMPLE_PATH tag contains directories, you can use the
626*404b540aSrobert# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
627*404b540aSrobert# and *.h) to filter out the source-files in the directories. If left
628*404b540aSrobert# blank all files are included.
629*404b540aSrobert
630*404b540aSrobertEXAMPLE_PATTERNS       =
631*404b540aSrobert
632*404b540aSrobert# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be
633*404b540aSrobert# searched for input files to be used with the \include or \dontinclude
634*404b540aSrobert# commands irrespective of the value of the RECURSIVE tag.
635*404b540aSrobert# Possible values are YES and NO. If left blank NO is used.
636*404b540aSrobert
637*404b540aSrobertEXAMPLE_RECURSIVE      = NO
638*404b540aSrobert
639*404b540aSrobert# The IMAGE_PATH tag can be used to specify one or more files or
640*404b540aSrobert# directories that contain image that are included in the documentation (see
641*404b540aSrobert# the \image command).
642*404b540aSrobert
643*404b540aSrobertIMAGE_PATH             =
644*404b540aSrobert
645*404b540aSrobert# The INPUT_FILTER tag can be used to specify a program that doxygen should
646*404b540aSrobert# invoke to filter for each input file. Doxygen will invoke the filter program
647*404b540aSrobert# by executing (via popen()) the command <filter> <input-file>, where <filter>
648*404b540aSrobert# is the value of the INPUT_FILTER tag, and <input-file> is the name of an
649*404b540aSrobert# input file. Doxygen will then use the output that the filter program writes
650*404b540aSrobert# to standard output.  If FILTER_PATTERNS is specified, this tag will be
651*404b540aSrobert# ignored.
652*404b540aSrobert
653*404b540aSrobertINPUT_FILTER           =
654*404b540aSrobert
655*404b540aSrobert# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern
656*404b540aSrobert# basis.  Doxygen will compare the file name with each pattern and apply the
657*404b540aSrobert# filter if there is a match.  The filters are a list of the form:
658*404b540aSrobert# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further
659*404b540aSrobert# info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER
660*404b540aSrobert# is applied to all files.
661*404b540aSrobert
662*404b540aSrobertFILTER_PATTERNS        =
663*404b540aSrobert
664*404b540aSrobert# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
665*404b540aSrobert# INPUT_FILTER) will be used to filter the input files when producing source
666*404b540aSrobert# files to browse (i.e. when SOURCE_BROWSER is set to YES).
667*404b540aSrobert
668*404b540aSrobertFILTER_SOURCE_FILES    = NO
669*404b540aSrobert
670*404b540aSrobert#---------------------------------------------------------------------------
671*404b540aSrobert# configuration options related to source browsing
672*404b540aSrobert#---------------------------------------------------------------------------
673*404b540aSrobert
674*404b540aSrobert# If the SOURCE_BROWSER tag is set to YES then a list of source files
675*404b540aSrobert# will be generated. Documented entities will be cross-referenced with
676*404b540aSrobert# these sources.  Note: To get rid of all source code in the generated
677*404b540aSrobert# output, make sure also VERBATIM_HEADERS is set to NO.
678*404b540aSrobert
679*404b540aSrobertSOURCE_BROWSER         = YES
680*404b540aSrobert
681*404b540aSrobert# Setting the INLINE_SOURCES tag to YES will include the body
682*404b540aSrobert# of functions and classes directly in the documentation.
683*404b540aSrobert
684*404b540aSrobertINLINE_SOURCES         = NO
685*404b540aSrobert
686*404b540aSrobert# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct
687*404b540aSrobert# doxygen to hide any special comment blocks from generated source code
688*404b540aSrobert# fragments. Normal C and C++ comments will always remain visible.
689*404b540aSrobert
690*404b540aSrobertSTRIP_CODE_COMMENTS    = NO
691*404b540aSrobert
692*404b540aSrobert# If the REFERENCED_BY_RELATION tag is set to YES (the default)
693*404b540aSrobert# then for each documented function all documented
694*404b540aSrobert# functions referencing it will be listed.
695*404b540aSrobert
696*404b540aSrobertREFERENCED_BY_RELATION = YES
697*404b540aSrobert
698*404b540aSrobert# If the REFERENCES_RELATION tag is set to YES (the default)
699*404b540aSrobert# then for each documented function all documented entities
700*404b540aSrobert# called/used by that function will be listed.
701*404b540aSrobert
702*404b540aSrobertREFERENCES_RELATION    = YES
703*404b540aSrobert
704*404b540aSrobert# If the REFERENCES_LINK_SOURCE tag is set to YES (the default)
705*404b540aSrobert# and SOURCE_BROWSER tag is set to YES, then the hyperlinks from
706*404b540aSrobert# functions in REFERENCES_RELATION and REFERENCED_BY_RELATION lists will
707*404b540aSrobert# link to the source code.  Otherwise they will link to the documentstion.
708*404b540aSrobert
709*404b540aSrobertREFERENCES_LINK_SOURCE = YES
710*404b540aSrobert
711*404b540aSrobert# If the USE_HTAGS tag is set to YES then the references to source code
712*404b540aSrobert# will point to the HTML generated by the htags(1) tool instead of doxygen
713*404b540aSrobert# built-in source browser. The htags tool is part of GNU's global source
714*404b540aSrobert# tagging system (see http://www.gnu.org/software/global/global.html). You
715*404b540aSrobert# will need version 4.8.6 or higher.
716*404b540aSrobert
717*404b540aSrobertUSE_HTAGS              = NO
718*404b540aSrobert
719*404b540aSrobert# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen
720*404b540aSrobert# will generate a verbatim copy of the header file for each class for
721*404b540aSrobert# which an include is specified. Set to NO to disable this.
722*404b540aSrobert
723*404b540aSrobertVERBATIM_HEADERS       = NO
724*404b540aSrobert
725*404b540aSrobert#---------------------------------------------------------------------------
726*404b540aSrobert# configuration options related to the alphabetical class index
727*404b540aSrobert#---------------------------------------------------------------------------
728*404b540aSrobert
729*404b540aSrobert# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index
730*404b540aSrobert# of all compounds will be generated. Enable this if the project
731*404b540aSrobert# contains a lot of classes, structs, unions or interfaces.
732*404b540aSrobert
733*404b540aSrobertALPHABETICAL_INDEX     = YES
734*404b540aSrobert
735*404b540aSrobert# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then
736*404b540aSrobert# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns
737*404b540aSrobert# in which this list will be split (can be a number in the range [1..20])
738*404b540aSrobert
739*404b540aSrobertCOLS_IN_ALPHA_INDEX    = 2
740*404b540aSrobert
741*404b540aSrobert# In case all classes in a project start with a common prefix, all
742*404b540aSrobert# classes will be put under the same header in the alphabetical index.
743*404b540aSrobert# The IGNORE_PREFIX tag can be used to specify one or more prefixes that
744*404b540aSrobert# should be ignored while generating the index headers.
745*404b540aSrobert
746*404b540aSrobert#IGNORE_PREFIX          = std \
747*404b540aSrobert#                         std::tr1 \
748*404b540aSrobert#                         __gnu_cxx \
749*404b540aSrobert#                         __gnu_debug
750*404b540aSrobertIGNORE_PREFIX          =
751*404b540aSrobert
752*404b540aSrobert#---------------------------------------------------------------------------
753*404b540aSrobert# configuration options related to the HTML output
754*404b540aSrobert#---------------------------------------------------------------------------
755*404b540aSrobert
756*404b540aSrobert# If the GENERATE_HTML tag is set to YES (the default) Doxygen will
757*404b540aSrobert# generate HTML output.
758*404b540aSrobert
759*404b540aSrobertGENERATE_HTML          = @do_html@
760*404b540aSrobert
761*404b540aSrobert# The HTML_OUTPUT tag is used to specify where the HTML docs will be put.
762*404b540aSrobert# If a relative path is entered the value of OUTPUT_DIRECTORY will be
763*404b540aSrobert# put in front of it. If left blank `html' will be used as the default path.
764*404b540aSrobert
765*404b540aSrobertHTML_OUTPUT            = @html_output_dir@
766*404b540aSrobert
767*404b540aSrobert# The HTML_FILE_EXTENSION tag can be used to specify the file extension for
768*404b540aSrobert# each generated HTML page (for example: .htm,.php,.asp). If it is left blank
769*404b540aSrobert# doxygen will generate files with .html extension.
770*404b540aSrobert
771*404b540aSrobertHTML_FILE_EXTENSION    = .html
772*404b540aSrobert
773*404b540aSrobert# The HTML_HEADER tag can be used to specify a personal HTML header for
774*404b540aSrobert# each generated HTML page. If it is left blank doxygen will generate a
775*404b540aSrobert# standard header.
776*404b540aSrobert
777*404b540aSrobertHTML_HEADER            =
778*404b540aSrobert
779*404b540aSrobert# The HTML_FOOTER tag can be used to specify a personal HTML footer for
780*404b540aSrobert# each generated HTML page. If it is left blank doxygen will generate a
781*404b540aSrobert# standard footer.
782*404b540aSrobert
783*404b540aSrobertHTML_FOOTER            =
784*404b540aSrobert
785*404b540aSrobert# The HTML_STYLESHEET tag can be used to specify a user-defined cascading
786*404b540aSrobert# style sheet that is used by each HTML page. It can be used to
787*404b540aSrobert# fine-tune the look of the HTML output. If the tag is left blank doxygen
788*404b540aSrobert# will generate a default style sheet. Note that doxygen will try to copy
789*404b540aSrobert# the style sheet file to the HTML output directory, so don't put your own
790*404b540aSrobert# stylesheet in the HTML output directory as well, or it will be erased!
791*404b540aSrobert
792*404b540aSrobertHTML_STYLESHEET        = @srcdir@/docs/doxygen/style.css
793*404b540aSrobert
794*404b540aSrobert# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes,
795*404b540aSrobert# files or namespaces will be aligned in HTML using tables. If set to
796*404b540aSrobert# NO a bullet list will be used.
797*404b540aSrobert
798*404b540aSrobertHTML_ALIGN_MEMBERS     = NO
799*404b540aSrobert
800*404b540aSrobert# If the GENERATE_HTMLHELP tag is set to YES, additional index files
801*404b540aSrobert# will be generated that can be used as input for tools like the
802*404b540aSrobert# Microsoft HTML help workshop to generate a compressed HTML help file (.chm)
803*404b540aSrobert# of the generated HTML documentation.
804*404b540aSrobert
805*404b540aSrobertGENERATE_HTMLHELP      = NO
806*404b540aSrobert
807*404b540aSrobert# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can
808*404b540aSrobert# be used to specify the file name of the resulting .chm file. You
809*404b540aSrobert# can add a path in front of the file if the result should not be
810*404b540aSrobert# written to the html output directory.
811*404b540aSrobert
812*404b540aSrobertCHM_FILE               =
813*404b540aSrobert
814*404b540aSrobert# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can
815*404b540aSrobert# be used to specify the location (absolute path including file name) of
816*404b540aSrobert# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run
817*404b540aSrobert# the HTML help compiler on the generated index.hhp.
818*404b540aSrobert
819*404b540aSrobertHHC_LOCATION           =
820*404b540aSrobert
821*404b540aSrobert# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag
822*404b540aSrobert# controls if a separate .chi index file is generated (YES) or that
823*404b540aSrobert# it should be included in the master .chm file (NO).
824*404b540aSrobert
825*404b540aSrobertGENERATE_CHI           = NO
826*404b540aSrobert
827*404b540aSrobert# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag
828*404b540aSrobert# controls whether a binary table of contents is generated (YES) or a
829*404b540aSrobert# normal table of contents (NO) in the .chm file.
830*404b540aSrobert
831*404b540aSrobertBINARY_TOC             = NO
832*404b540aSrobert
833*404b540aSrobert# The TOC_EXPAND flag can be set to YES to add extra items for group members
834*404b540aSrobert# to the contents of the HTML help documentation and to the tree view.
835*404b540aSrobert
836*404b540aSrobertTOC_EXPAND             = NO
837*404b540aSrobert
838*404b540aSrobert# The DISABLE_INDEX tag can be used to turn on/off the condensed index at
839*404b540aSrobert# top of each HTML page. The value NO (the default) enables the index and
840*404b540aSrobert# the value YES disables it.
841*404b540aSrobert
842*404b540aSrobertDISABLE_INDEX          = YES
843*404b540aSrobert
844*404b540aSrobert# This tag can be used to set the number of enum values (range [1..20])
845*404b540aSrobert# that doxygen will group on one line in the generated HTML documentation.
846*404b540aSrobert
847*404b540aSrobertENUM_VALUES_PER_LINE   = 4
848*404b540aSrobert
849*404b540aSrobert# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be
850*404b540aSrobert# generated containing a tree-like index structure (just like the one that
851*404b540aSrobert# is generated for HTML Help). For this to work a browser that supports
852*404b540aSrobert# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+,
853*404b540aSrobert# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are
854*404b540aSrobert# probably better off using the HTML help feature.
855*404b540aSrobert
856*404b540aSrobertGENERATE_TREEVIEW      = YES
857*404b540aSrobert
858*404b540aSrobert# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be
859*404b540aSrobert# used to set the initial width (in pixels) of the frame in which the tree
860*404b540aSrobert# is shown.
861*404b540aSrobert
862*404b540aSrobertTREEVIEW_WIDTH         = 250
863*404b540aSrobert
864*404b540aSrobert#---------------------------------------------------------------------------
865*404b540aSrobert# configuration options related to the LaTeX output
866*404b540aSrobert#---------------------------------------------------------------------------
867*404b540aSrobert
868*404b540aSrobert# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will
869*404b540aSrobert# generate Latex output.
870*404b540aSrobert
871*404b540aSrobertGENERATE_LATEX         = NO
872*404b540aSrobert
873*404b540aSrobert# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put.
874*404b540aSrobert# If a relative path is entered the value of OUTPUT_DIRECTORY will be
875*404b540aSrobert# put in front of it. If left blank `latex' will be used as the default path.
876*404b540aSrobert
877*404b540aSrobertLATEX_OUTPUT           = latex
878*404b540aSrobert
879*404b540aSrobert# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be
880*404b540aSrobert# invoked. If left blank `latex' will be used as the default command name.
881*404b540aSrobert
882*404b540aSrobertLATEX_CMD_NAME         = latex
883*404b540aSrobert
884*404b540aSrobert# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to
885*404b540aSrobert# generate index for LaTeX. If left blank `makeindex' will be used as the
886*404b540aSrobert# default command name.
887*404b540aSrobert
888*404b540aSrobertMAKEINDEX_CMD_NAME     = makeindex
889*404b540aSrobert
890*404b540aSrobert# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact
891*404b540aSrobert# LaTeX documents. This may be useful for small projects and may help to
892*404b540aSrobert# save some trees in general.
893*404b540aSrobert
894*404b540aSrobertCOMPACT_LATEX          = NO
895*404b540aSrobert
896*404b540aSrobert# The PAPER_TYPE tag can be used to set the paper type that is used
897*404b540aSrobert# by the printer. Possible values are: a4, a4wide, letter, legal and
898*404b540aSrobert# executive. If left blank a4wide will be used.
899*404b540aSrobert
900*404b540aSrobertPAPER_TYPE             = letter
901*404b540aSrobert
902*404b540aSrobert# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX
903*404b540aSrobert# packages that should be included in the LaTeX output.
904*404b540aSrobert
905*404b540aSrobertEXTRA_PACKAGES         = amsmath
906*404b540aSrobert
907*404b540aSrobert# The LATEX_HEADER tag can be used to specify a personal LaTeX header for
908*404b540aSrobert# the generated latex document. The header should contain everything until
909*404b540aSrobert# the first chapter. If it is left blank doxygen will generate a
910*404b540aSrobert# standard header. Notice: only use this tag if you know what you are doing!
911*404b540aSrobert
912*404b540aSrobertLATEX_HEADER           =
913*404b540aSrobert
914*404b540aSrobert# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated
915*404b540aSrobert# is prepared for conversion to pdf (using ps2pdf). The pdf file will
916*404b540aSrobert# contain links (just like the HTML output) instead of page references
917*404b540aSrobert# This makes the output suitable for online browsing using a pdf viewer.
918*404b540aSrobert
919*404b540aSrobertPDF_HYPERLINKS         = NO
920*404b540aSrobert
921*404b540aSrobert# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of
922*404b540aSrobert# plain latex in the generated Makefile. Set this option to YES to get a
923*404b540aSrobert# higher quality PDF documentation.
924*404b540aSrobert
925*404b540aSrobertUSE_PDFLATEX           = NO
926*404b540aSrobert
927*404b540aSrobert# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode.
928*404b540aSrobert# command to the generated LaTeX files. This will instruct LaTeX to keep
929*404b540aSrobert# running if errors occur, instead of asking the user for help.
930*404b540aSrobert# This option is also used when generating formulas in HTML.
931*404b540aSrobert
932*404b540aSrobertLATEX_BATCHMODE        = NO
933*404b540aSrobert
934*404b540aSrobert# If LATEX_HIDE_INDICES is set to YES then doxygen will not
935*404b540aSrobert# include the index chapters (such as File Index, Compound Index, etc.)
936*404b540aSrobert# in the output.
937*404b540aSrobert
938*404b540aSrobertLATEX_HIDE_INDICES     = NO
939*404b540aSrobert
940*404b540aSrobert#---------------------------------------------------------------------------
941*404b540aSrobert# configuration options related to the RTF output
942*404b540aSrobert#---------------------------------------------------------------------------
943*404b540aSrobert
944*404b540aSrobert# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output
945*404b540aSrobert# The RTF output is optimized for Word 97 and may not look very pretty with
946*404b540aSrobert# other RTF readers or editors.
947*404b540aSrobert
948*404b540aSrobertGENERATE_RTF           = NO
949*404b540aSrobert
950*404b540aSrobert# The RTF_OUTPUT tag is used to specify where the RTF docs will be put.
951*404b540aSrobert# If a relative path is entered the value of OUTPUT_DIRECTORY will be
952*404b540aSrobert# put in front of it. If left blank `rtf' will be used as the default path.
953*404b540aSrobert
954*404b540aSrobertRTF_OUTPUT             = rtf
955*404b540aSrobert
956*404b540aSrobert# If the COMPACT_RTF tag is set to YES Doxygen generates more compact
957*404b540aSrobert# RTF documents. This may be useful for small projects and may help to
958*404b540aSrobert# save some trees in general.
959*404b540aSrobert
960*404b540aSrobertCOMPACT_RTF            = NO
961*404b540aSrobert
962*404b540aSrobert# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated
963*404b540aSrobert# will contain hyperlink fields. The RTF file will
964*404b540aSrobert# contain links (just like the HTML output) instead of page references.
965*404b540aSrobert# This makes the output suitable for online browsing using WORD or other
966*404b540aSrobert# programs which support those fields.
967*404b540aSrobert# Note: wordpad (write) and others do not support links.
968*404b540aSrobert
969*404b540aSrobertRTF_HYPERLINKS         = NO
970*404b540aSrobert
971*404b540aSrobert# Load stylesheet definitions from file. Syntax is similar to doxygen's
972*404b540aSrobert# config file, i.e. a series of assignments. You only have to provide
973*404b540aSrobert# replacements, missing definitions are set to their default value.
974*404b540aSrobert
975*404b540aSrobertRTF_STYLESHEET_FILE    =
976*404b540aSrobert
977*404b540aSrobert# Set optional variables used in the generation of an rtf document.
978*404b540aSrobert# Syntax is similar to doxygen's config file.
979*404b540aSrobert
980*404b540aSrobertRTF_EXTENSIONS_FILE    =
981*404b540aSrobert
982*404b540aSrobert#---------------------------------------------------------------------------
983*404b540aSrobert# configuration options related to the man page output
984*404b540aSrobert#---------------------------------------------------------------------------
985*404b540aSrobert
986*404b540aSrobert# If the GENERATE_MAN tag is set to YES (the default) Doxygen will
987*404b540aSrobert# generate man pages
988*404b540aSrobert
989*404b540aSrobertGENERATE_MAN           = @do_man@
990*404b540aSrobert
991*404b540aSrobert# The MAN_OUTPUT tag is used to specify where the man pages will be put.
992*404b540aSrobert# If a relative path is entered the value of OUTPUT_DIRECTORY will be
993*404b540aSrobert# put in front of it. If left blank `man' will be used as the default path.
994*404b540aSrobert
995*404b540aSrobertMAN_OUTPUT             = man
996*404b540aSrobert
997*404b540aSrobert# The MAN_EXTENSION tag determines the extension that is added to
998*404b540aSrobert# the generated man pages (default is the subroutine's section .3)
999*404b540aSrobert
1000*404b540aSrobertMAN_EXTENSION          = .3
1001*404b540aSrobert
1002*404b540aSrobert# If the MAN_LINKS tag is set to YES and Doxygen generates man output,
1003*404b540aSrobert# then it will generate one additional man file for each entity
1004*404b540aSrobert# documented in the real man page(s). These additional files
1005*404b540aSrobert# only source the real man page, but without them the man command
1006*404b540aSrobert# would be unable to find the correct page. The default is NO.
1007*404b540aSrobert
1008*404b540aSrobertMAN_LINKS              = NO
1009*404b540aSrobert
1010*404b540aSrobert#---------------------------------------------------------------------------
1011*404b540aSrobert# configuration options related to the XML output
1012*404b540aSrobert#---------------------------------------------------------------------------
1013*404b540aSrobert
1014*404b540aSrobert# If the GENERATE_XML tag is set to YES Doxygen will
1015*404b540aSrobert# generate an XML file that captures the structure of
1016*404b540aSrobert# the code including all documentation.
1017*404b540aSrobert
1018*404b540aSrobertGENERATE_XML           = YES
1019*404b540aSrobert
1020*404b540aSrobert# The XML_OUTPUT tag is used to specify where the XML pages will be put.
1021*404b540aSrobert# If a relative path is entered the value of OUTPUT_DIRECTORY will be
1022*404b540aSrobert# put in front of it. If left blank `xml' will be used as the default path.
1023*404b540aSrobert
1024*404b540aSrobertXML_OUTPUT             = xml
1025*404b540aSrobert
1026*404b540aSrobert# The XML_SCHEMA tag can be used to specify an XML schema,
1027*404b540aSrobert# which can be used by a validating XML parser to check the
1028*404b540aSrobert# syntax of the XML files.
1029*404b540aSrobert
1030*404b540aSrobertXML_SCHEMA             =
1031*404b540aSrobert
1032*404b540aSrobert# The XML_DTD tag can be used to specify an XML DTD,
1033*404b540aSrobert# which can be used by a validating XML parser to check the
1034*404b540aSrobert# syntax of the XML files.
1035*404b540aSrobert
1036*404b540aSrobertXML_DTD                =
1037*404b540aSrobert
1038*404b540aSrobert# If the XML_PROGRAMLISTING tag is set to YES Doxygen will
1039*404b540aSrobert# dump the program listings (including syntax highlighting
1040*404b540aSrobert# and cross-referencing information) to the XML output. Note that
1041*404b540aSrobert# enabling this will significantly increase the size of the XML output.
1042*404b540aSrobert
1043*404b540aSrobertXML_PROGRAMLISTING     = YES
1044*404b540aSrobert
1045*404b540aSrobert#---------------------------------------------------------------------------
1046*404b540aSrobert# configuration options for the AutoGen Definitions output
1047*404b540aSrobert#---------------------------------------------------------------------------
1048*404b540aSrobert
1049*404b540aSrobert# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will
1050*404b540aSrobert# generate an AutoGen Definitions (see autogen.sf.net) file
1051*404b540aSrobert# that captures the structure of the code including all
1052*404b540aSrobert# documentation. Note that this feature is still experimental
1053*404b540aSrobert# and incomplete at the moment.
1054*404b540aSrobert
1055*404b540aSrobertGENERATE_AUTOGEN_DEF   = NO
1056*404b540aSrobert
1057*404b540aSrobert#---------------------------------------------------------------------------
1058*404b540aSrobert# configuration options related to the Perl module output
1059*404b540aSrobert#---------------------------------------------------------------------------
1060*404b540aSrobert
1061*404b540aSrobert# If the GENERATE_PERLMOD tag is set to YES Doxygen will
1062*404b540aSrobert# generate a Perl module file that captures the structure of
1063*404b540aSrobert# the code including all documentation. Note that this
1064*404b540aSrobert# feature is still experimental and incomplete at the
1065*404b540aSrobert# moment.
1066*404b540aSrobert
1067*404b540aSrobertGENERATE_PERLMOD       = NO
1068*404b540aSrobert
1069*404b540aSrobert# If the PERLMOD_LATEX tag is set to YES Doxygen will generate
1070*404b540aSrobert# the necessary Makefile rules, Perl scripts and LaTeX code to be able
1071*404b540aSrobert# to generate PDF and DVI output from the Perl module output.
1072*404b540aSrobert
1073*404b540aSrobertPERLMOD_LATEX          = NO
1074*404b540aSrobert
1075*404b540aSrobert# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be
1076*404b540aSrobert# nicely formatted so it can be parsed by a human reader.  This is useful
1077*404b540aSrobert# if you want to understand what is going on.  On the other hand, if this
1078*404b540aSrobert# tag is set to NO the size of the Perl module output will be much smaller
1079*404b540aSrobert# and Perl will parse it just the same.
1080*404b540aSrobert
1081*404b540aSrobertPERLMOD_PRETTY         = YES
1082*404b540aSrobert
1083*404b540aSrobert# The names of the make variables in the generated doxyrules.make file
1084*404b540aSrobert# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX.
1085*404b540aSrobert# This is useful so different doxyrules.make files included by the same
1086*404b540aSrobert# Makefile don't overwrite each other's variables.
1087*404b540aSrobert
1088*404b540aSrobertPERLMOD_MAKEVAR_PREFIX =
1089*404b540aSrobert
1090*404b540aSrobert#---------------------------------------------------------------------------
1091*404b540aSrobert# Configuration options related to the preprocessor
1092*404b540aSrobert#---------------------------------------------------------------------------
1093*404b540aSrobert
1094*404b540aSrobert# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will
1095*404b540aSrobert# evaluate all C-preprocessor directives found in the sources and include
1096*404b540aSrobert# files.
1097*404b540aSrobert
1098*404b540aSrobertENABLE_PREPROCESSING   = YES
1099*404b540aSrobert
1100*404b540aSrobert# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro
1101*404b540aSrobert# names in the source code. If set to NO (the default) only conditional
1102*404b540aSrobert# compilation will be performed. Macro expansion can be done in a controlled
1103*404b540aSrobert# way by setting EXPAND_ONLY_PREDEF to YES.
1104*404b540aSrobert# GLIBCXX NOTE: Necessary for namespaces to be sorted correctly.
1105*404b540aSrobert
1106*404b540aSrobertMACRO_EXPANSION        = YES
1107*404b540aSrobert
1108*404b540aSrobert# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES
1109*404b540aSrobert# then the macro expansion is limited to the macros specified with the
1110*404b540aSrobert# PREDEFINED and EXPAND_AS_DEFINED tags.
1111*404b540aSrobert
1112*404b540aSrobertEXPAND_ONLY_PREDEF     = NO
1113*404b540aSrobert
1114*404b540aSrobert# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files
1115*404b540aSrobert# in the INCLUDE_PATH (see below) will be search if a #include is found.
1116*404b540aSrobert
1117*404b540aSrobertSEARCH_INCLUDES        = YES
1118*404b540aSrobert
1119*404b540aSrobert# The INCLUDE_PATH tag can be used to specify one or more directories that
1120*404b540aSrobert# contain include files that are not input files but should be processed by
1121*404b540aSrobert# the preprocessor.
1122*404b540aSrobert
1123*404b540aSrobertINCLUDE_PATH           =
1124*404b540aSrobert
1125*404b540aSrobert# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard
1126*404b540aSrobert# patterns (like *.h and *.hpp) to filter out the header-files in the
1127*404b540aSrobert# directories. If left blank, the patterns specified with FILE_PATTERNS will
1128*404b540aSrobert# be used.
1129*404b540aSrobert
1130*404b540aSrobertINCLUDE_FILE_PATTERNS  =
1131*404b540aSrobert
1132*404b540aSrobert# The PREDEFINED tag can be used to specify one or more macro names
1133*404b540aSrobert# that are defined before the preprocessor is started (similar to the
1134*404b540aSrobert# -D option of gcc). The argument of the tag is a list of macros of
1135*404b540aSrobert# the form: name or name=definition (no spaces). If the definition and
1136*404b540aSrobert# the = are omitted =1 is assumed. To prevent a macro definition from
1137*404b540aSrobert# being undefined via #undef or recursively expanded use the :=
1138*404b540aSrobert# operator instead of the = operator.
1139*404b540aSrobert
1140*404b540aSrobertPREDEFINED             = __GTHREADS \
1141*404b540aSrobert                         _GLIBCXX_STD=std \
1142*404b540aSrobert                         "_GLIBCXX_BEGIN_NAMESPACE(name)=namespace name {" \
1143*404b540aSrobert             "_GLIBCXX_BEGIN_NESTED_NAMESPACE(name, unused)=namespace name {" \
1144*404b540aSrobert                         _GLIBCXX_END_NAMESPACE=} \
1145*404b540aSrobert                         _GLIBCXX_END_NESTED_NAMESPACE=} \
1146*404b540aSrobert                         "_GLIBCXX_TEMPLATE_ARGS=..." \
1147*404b540aSrobert                         _GLIBCXX_DEPRECATED \
1148*404b540aSrobert                         _GLIBCXX_USE_WCHAR_T \
1149*404b540aSrobert                         _GLIBCXX_USE_LONG_LONG \
1150*404b540aSrobert                         __glibcxx_function_requires=// \
1151*404b540aSrobert                         __glibcxx_class_requires=// \
1152*404b540aSrobert                         __glibcxx_class_requires2=// \
1153*404b540aSrobert                         __glibcxx_class_requires3=// \
1154*404b540aSrobert                         __glibcxx_class_requires4=//
1155*404b540aSrobert
1156*404b540aSrobert# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES
1157*404b540aSrobert# then this tag can be used to specify a list of macro names that
1158*404b540aSrobert# should be expanded.  The macro definition that is found in the
1159*404b540aSrobert# sources will be used.  Use the PREDEFINED tag if you want to use a
1160*404b540aSrobert# different macro definition.
1161*404b540aSrobert
1162*404b540aSrobertEXPAND_AS_DEFINED      =
1163*404b540aSrobert
1164*404b540aSrobert# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then
1165*404b540aSrobert# doxygen's preprocessor will remove all function-like macros that are alone
1166*404b540aSrobert# on a line, have an all uppercase name, and do not end with a semicolon. Such
1167*404b540aSrobert# function macros are typically used for boiler-plate code, and will confuse
1168*404b540aSrobert# the parser if not removed.
1169*404b540aSrobert
1170*404b540aSrobertSKIP_FUNCTION_MACROS   = YES
1171*404b540aSrobert
1172*404b540aSrobert#---------------------------------------------------------------------------
1173*404b540aSrobert# Configuration::additions related to external references
1174*404b540aSrobert#---------------------------------------------------------------------------
1175*404b540aSrobert
1176*404b540aSrobert# The TAGFILES option can be used to specify one or more tagfiles.
1177*404b540aSrobert# Optionally an initial location of the external documentation
1178*404b540aSrobert# can be added for each tagfile. The format of a tag file without
1179*404b540aSrobert# this location is as follows:
1180*404b540aSrobert#   TAGFILES = file1 file2 ...
1181*404b540aSrobert# Adding location for the tag files is done as follows:
1182*404b540aSrobert#   TAGFILES = file1=loc1 "file2 = loc2" ...
1183*404b540aSrobert# where "loc1" and "loc2" can be relative or absolute paths or
1184*404b540aSrobert# URLs. If a location is present for each tag, the installdox tool
1185*404b540aSrobert# does not have to be run to correct the links.
1186*404b540aSrobert# Note that each tag file must have a unique name
1187*404b540aSrobert# (where the name does NOT include the path)
1188*404b540aSrobert# If a tag file is not located in the directory in which doxygen
1189*404b540aSrobert# is run, you must also specify the path to the tagfile here.
1190*404b540aSrobert
1191*404b540aSrobertTAGFILES               =
1192*404b540aSrobert
1193*404b540aSrobert# When a file name is specified after GENERATE_TAGFILE, doxygen will create
1194*404b540aSrobert# a tag file that is based on the input files it reads.
1195*404b540aSrobert
1196*404b540aSrobertGENERATE_TAGFILE       = @generate_tagfile@
1197*404b540aSrobert
1198*404b540aSrobert# If the ALLEXTERNALS tag is set to YES all external classes will be listed
1199*404b540aSrobert# in the class index. If set to NO only the inherited external classes
1200*404b540aSrobert# will be listed.
1201*404b540aSrobert
1202*404b540aSrobertALLEXTERNALS           = YES
1203*404b540aSrobert
1204*404b540aSrobert# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed
1205*404b540aSrobert# in the modules index. If set to NO, only the current project's groups will
1206*404b540aSrobert# be listed.
1207*404b540aSrobert
1208*404b540aSrobertEXTERNAL_GROUPS        = YES
1209*404b540aSrobert
1210*404b540aSrobert# The PERL_PATH should be the absolute path and name of the perl script
1211*404b540aSrobert# interpreter (i.e. the result of `which perl').
1212*404b540aSrobert
1213*404b540aSrobertPERL_PATH              = /usr/bin/perl
1214*404b540aSrobert
1215*404b540aSrobert#---------------------------------------------------------------------------
1216*404b540aSrobert# Configuration options related to the dot tool
1217*404b540aSrobert#---------------------------------------------------------------------------
1218*404b540aSrobert
1219*404b540aSrobert# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will
1220*404b540aSrobert# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes
1221*404b540aSrobert# with base or super classes. Setting the tag to NO turns the diagrams
1222*404b540aSrobert# off. Note that this option is superseded by the HAVE_DOT option
1223*404b540aSrobert# below. This is only a fallback. It is recommended to install and use
1224*404b540aSrobert# dot, since it yields more powerful graphs.
1225*404b540aSrobert
1226*404b540aSrobertCLASS_DIAGRAMS         = YES
1227*404b540aSrobert
1228*404b540aSrobert# If set to YES, the inheritance and collaboration graphs will hide
1229*404b540aSrobert# inheritance and usage relations if the target is undocumented
1230*404b540aSrobert# or is not a class.
1231*404b540aSrobert
1232*404b540aSrobertHIDE_UNDOC_RELATIONS   = NO
1233*404b540aSrobert
1234*404b540aSrobert# If you set the HAVE_DOT tag to YES then doxygen will assume the dot
1235*404b540aSrobert# tool is available from the path. This tool is part of Graphviz, a
1236*404b540aSrobert# graph visualization toolkit from AT&T and Lucent Bell Labs. The
1237*404b540aSrobert# other options in this section have no effect if this option is set
1238*404b540aSrobert# to NO (the default)
1239*404b540aSrobert
1240*404b540aSrobertHAVE_DOT               = YES
1241*404b540aSrobert
1242*404b540aSrobert# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen
1243*404b540aSrobert# will generate a graph for each documented class showing the direct and
1244*404b540aSrobert# indirect inheritance relations. Setting this tag to YES will force the
1245*404b540aSrobert# the CLASS_DIAGRAMS tag to NO.
1246*404b540aSrobert
1247*404b540aSrobertCLASS_GRAPH            = YES
1248*404b540aSrobert
1249*404b540aSrobert# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen
1250*404b540aSrobert# will generate a graph for each documented class showing the direct and
1251*404b540aSrobert# indirect implementation dependencies (inheritance, containment, and
1252*404b540aSrobert# class references variables) of the class with other documented classes.
1253*404b540aSrobert
1254*404b540aSrobertCOLLABORATION_GRAPH    = NO
1255*404b540aSrobert
1256*404b540aSrobert# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen
1257*404b540aSrobert# will generate a graph for groups, showing the direct groups dependencies
1258*404b540aSrobert
1259*404b540aSrobertGROUP_GRAPHS           = YES
1260*404b540aSrobert
1261*404b540aSrobert# If the UML_LOOK tag is set to YES doxygen will generate inheritance and
1262*404b540aSrobert# collaboration diagrams in a style similar to the OMG's Unified Modeling
1263*404b540aSrobert# Language.
1264*404b540aSrobert
1265*404b540aSrobertUML_LOOK               = NO
1266*404b540aSrobert
1267*404b540aSrobert# If set to YES, the inheritance and collaboration graphs will show the
1268*404b540aSrobert# relations between templates and their instances.
1269*404b540aSrobert
1270*404b540aSrobert#TEMPLATE_RELATIONS     = YES
1271*404b540aSrobertTEMPLATE_RELATIONS     = NO
1272*404b540aSrobert
1273*404b540aSrobert# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT
1274*404b540aSrobert# tags are set to YES then doxygen will generate a graph for each documented
1275*404b540aSrobert# file showing the direct and indirect include dependencies of the file with
1276*404b540aSrobert# other documented files.
1277*404b540aSrobert
1278*404b540aSrobertINCLUDE_GRAPH          = NO
1279*404b540aSrobert
1280*404b540aSrobert# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and
1281*404b540aSrobert# HAVE_DOT tags are set to YES then doxygen will generate a graph for each
1282*404b540aSrobert# documented header file showing the documented files that directly or
1283*404b540aSrobert# indirectly include this file.
1284*404b540aSrobert
1285*404b540aSrobertINCLUDED_BY_GRAPH      = NO
1286*404b540aSrobert
1287*404b540aSrobert# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will
1288*404b540aSrobert# generate a call dependency graph for every global function or class
1289*404b540aSrobert# method.  Note that enabling this option will significantly increase
1290*404b540aSrobert# the time of a run.  So in most cases it will be better to enable
1291*404b540aSrobert# call graphs for selected functions only using the \callgraph
1292*404b540aSrobert# command.
1293*404b540aSrobert
1294*404b540aSrobertCALL_GRAPH             = NO
1295*404b540aSrobert
1296*404b540aSrobert# If the CALLER_GRAPH and HAVE_DOT tags are set to YES then doxygen
1297*404b540aSrobert# will generate a caller dependency graph for every global function or
1298*404b540aSrobert# class method.  Note that enabling this option will significantly
1299*404b540aSrobert# increase the time of a run.  So in most cases it will be better to
1300*404b540aSrobert# enable caller graphs for selected functions only using the
1301*404b540aSrobert# \callergraph command.
1302*404b540aSrobert
1303*404b540aSrobertCALLER_GRAPH           = NO
1304*404b540aSrobert
1305*404b540aSrobert# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen
1306*404b540aSrobert# will graphical hierarchy of all classes instead of a textual one.
1307*404b540aSrobert
1308*404b540aSrobertGRAPHICAL_HIERARCHY    = YES
1309*404b540aSrobert
1310*404b540aSrobert# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES
1311*404b540aSrobert# then doxygen will show the dependencies a directory has on other directories
1312*404b540aSrobert# in a graphical way. The dependency relations are determined by the #include
1313*404b540aSrobert# relations between the files in the directories.
1314*404b540aSrobert
1315*404b540aSrobertDIRECTORY_GRAPH        = YES
1316*404b540aSrobert
1317*404b540aSrobert# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
1318*404b540aSrobert# generated by dot. Possible values are png, jpg, or gif
1319*404b540aSrobert# If left blank png will be used.
1320*404b540aSrobert
1321*404b540aSrobert#DOT_IMAGE_FORMAT       = svg
1322*404b540aSrobertDOT_IMAGE_FORMAT       = png
1323*404b540aSrobert
1324*404b540aSrobert# The tag DOT_PATH can be used to specify the path where the dot tool can be
1325*404b540aSrobert# found. If left blank, it is assumed the dot tool can be found in the path.
1326*404b540aSrobert
1327*404b540aSrobertDOT_PATH               =
1328*404b540aSrobert
1329*404b540aSrobert# The DOTFILE_DIRS tag can be used to specify one or more directories that
1330*404b540aSrobert# contain dot files that are included in the documentation (see the
1331*404b540aSrobert# \dotfile command).
1332*404b540aSrobert
1333*404b540aSrobertDOTFILE_DIRS           =
1334*404b540aSrobert
1335*404b540aSrobert# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width
1336*404b540aSrobert# (in pixels) of the graphs generated by dot. If a graph becomes larger than
1337*404b540aSrobert# this value, doxygen will try to truncate the graph, so that it fits within
1338*404b540aSrobert# the specified constraint. Beware that most browsers cannot cope with very
1339*404b540aSrobert# large images.
1340*404b540aSrobert
1341*404b540aSrobertMAX_DOT_GRAPH_WIDTH    = 1024
1342*404b540aSrobert
1343*404b540aSrobert# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height
1344*404b540aSrobert# (in pixels) of the graphs generated by dot. If a graph becomes larger than
1345*404b540aSrobert# this value, doxygen will try to truncate the graph, so that it fits within
1346*404b540aSrobert# the specified constraint. Beware that most browsers cannot cope with very
1347*404b540aSrobert# large images.
1348*404b540aSrobert
1349*404b540aSrobertMAX_DOT_GRAPH_HEIGHT   = 1024
1350*404b540aSrobert
1351*404b540aSrobert# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of
1352*404b540aSrobert# the graphs generated by dot. A depth value of 3 means that only
1353*404b540aSrobert# nodes reachable from the root by following a path via at most 3
1354*404b540aSrobert# edges will be shown. Nodes that lay further from the root node will
1355*404b540aSrobert# be omitted. Note that setting this option to 1 or 2 may greatly
1356*404b540aSrobert# reduce the computation time needed for large code bases. Also note
1357*404b540aSrobert# that a graph may be further truncated if the graph's image
1358*404b540aSrobert# dimensions are not sufficient to fit the graph (see
1359*404b540aSrobert# MAX_DOT_GRAPH_WIDTH and MAX_DOT_GRAPH_HEIGHT). If 0 is used for the
1360*404b540aSrobert# depth value (the default), the graph is not depth-constrained.
1361*404b540aSrobert
1362*404b540aSrobertMAX_DOT_GRAPH_DEPTH    = 0
1363*404b540aSrobert
1364*404b540aSrobert# Set the DOT_TRANSPARENT tag to YES to generate images with a
1365*404b540aSrobert# transparent background. This is disabled by default, which results
1366*404b540aSrobert# in a white background.  Warning: Depending on the platform used,
1367*404b540aSrobert# enabling this option may lead to badly anti-aliased labels on the
1368*404b540aSrobert# edges of a graph (i.e. they become hard to read).
1369*404b540aSrobert
1370*404b540aSrobertDOT_TRANSPARENT        = NO
1371*404b540aSrobert
1372*404b540aSrobert# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output
1373*404b540aSrobert# files in one run (i.e. multiple -o and -T options on the command line). This
1374*404b540aSrobert# makes dot run faster, but since only newer versions of dot (>1.8.10)
1375*404b540aSrobert# support this, this feature is disabled by default.
1376*404b540aSrobert
1377*404b540aSrobertDOT_MULTI_TARGETS      = YES
1378*404b540aSrobert
1379*404b540aSrobert# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will
1380*404b540aSrobert# generate a legend page explaining the meaning of the various boxes and
1381*404b540aSrobert# arrows in the dot generated graphs.
1382*404b540aSrobert
1383*404b540aSrobertGENERATE_LEGEND        = NO
1384*404b540aSrobert
1385*404b540aSrobert# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will
1386*404b540aSrobert# remove the intermediate dot files that are used to generate
1387*404b540aSrobert# the various graphs.
1388*404b540aSrobert
1389*404b540aSrobertDOT_CLEANUP            = YES
1390*404b540aSrobert
1391*404b540aSrobert#---------------------------------------------------------------------------
1392*404b540aSrobert# Configuration::additions related to the search engine
1393*404b540aSrobert#---------------------------------------------------------------------------
1394*404b540aSrobert
1395*404b540aSrobert# The SEARCHENGINE tag specifies whether or not a search engine should be
1396*404b540aSrobert# used. If set to NO the values of all tags below this one will be ignored.
1397*404b540aSrobert
1398*404b540aSrobertSEARCHENGINE           = NO
1399