Statistics
| Branch: | Tag: | Revision:

amiro-lld / docs / Doxyfile @ f125ae07

History | View | Annotate | Download (73.819 KB)

1
# Doxyfile 1.7.6.1
2

    
3
# This file describes the settings to be used by the documentation system
4
# doxygen (www.doxygen.org) for a project.
5
#
6
# All text after a hash (#) is considered a comment and will be ignored.
7
# The format is:
8
#       TAG = value [value, ...]
9
# For lists items can also be appended using:
10
#       TAG += value [value, ...]
11
# Values that contain spaces should be placed between quotes (" ").
12

    
13
#---------------------------------------------------------------------------
14
# Project related configuration options
15
#---------------------------------------------------------------------------
16

    
17
# This tag specifies the encoding used for all characters in the config file
18
# that follow. The default is UTF-8 which is also the encoding used for all
19
# text before the first occurrence of this tag. Doxygen uses libiconv (or the
20
# iconv built into libc) for the transcoding. See
21
# http://www.gnu.org/software/libiconv for the list of possible encodings.
22

    
23
DOXYFILE_ENCODING      = UTF-8
24

    
25
# The PROJECT_NAME tag is a single word (or sequence of words) that should
26
# identify the project. Note that if you do not use Doxywizard you need
27
# to put quotes around the project name if it contains spaces.
28

    
29
PROJECT_NAME           = "AMiRo-LLD"
30

    
31
# The PROJECT_NUMBER tag can be used to enter a project or revision number.
32
# This could be handy for archiving the generated documentation or
33
# if some version control system is used.
34

    
35
PROJECT_NUMBER         = 1.0
36

    
37
# Using the PROJECT_BRIEF tag one can provide an optional one line description
38
# for a project that appears at the top of each page and should give viewer
39
# a quick idea about the purpose of the project. Keep the description short.
40

    
41
PROJECT_BRIEF          = AMiRo Low Level Drivers
42

    
43
# With the PROJECT_LOGO tag one can specify an logo or icon that is
44
# included in the documentation. The maximum height of the logo should not
45
# exceed 55 pixels and the maximum width should not exceed 200 pixels.
46
# Doxygen will copy the logo to the output directory.
47

    
48
PROJECT_LOGO           =
49

    
50
# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
51
# base path where the generated documentation will be put.
52
# If a relative path is entered, it will be relative to the location
53
# where doxygen was started. If left blank the current directory will be used.
54

    
55
OUTPUT_DIRECTORY       = doxygen
56

    
57
# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create
58
# 4096 sub-directories (in 2 levels) under the output directory of each output
59
# format and will distribute the generated files over these directories.
60
# Enabling this option can be useful when feeding doxygen a huge amount of
61
# source files, where putting all generated files in the same directory would
62
# otherwise cause performance problems for the file system.
63

    
64
CREATE_SUBDIRS         = NO
65

    
66
# The OUTPUT_LANGUAGE tag is used to specify the language in which all
67
# documentation generated by doxygen is written. Doxygen will use this
68
# information to generate all constant output in the proper language.
69
# The default language is English, other supported languages are:
70
# Afrikaans, Arabic, Brazilian, Catalan, Chinese, Chinese-Traditional,
71
# Croatian, Czech, Danish, Dutch, Esperanto, Farsi, Finnish, French, German,
72
# Greek, Hungarian, Italian, Japanese, Japanese-en (Japanese with English
73
# messages), Korean, Korean-en, Lithuanian, Norwegian, Macedonian, Persian,
74
# Polish, Portuguese, Romanian, Russian, Serbian, Serbian-Cyrillic, Slovak,
75
# Slovene, Spanish, Swedish, Ukrainian, and Vietnamese.
76

    
77
OUTPUT_LANGUAGE        = English
78

    
79
# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will
80
# include brief member descriptions after the members that are listed in
81
# the file and class documentation (similar to JavaDoc).
82
# Set to NO to disable this.
83

    
84
BRIEF_MEMBER_DESC      = YES
85

    
86
# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend
87
# the brief description of a member or function before the detailed description.
88
# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
89
# brief descriptions will be completely suppressed.
90

    
91
REPEAT_BRIEF           = YES
92

    
93
# This tag implements a quasi-intelligent brief description abbreviator
94
# that is used to form the text in various listings. Each string
95
# in this list, if found as the leading text of the brief description, will be
96
# stripped from the text and the result after processing the whole list, is
97
# used as the annotated text. Otherwise, the brief description is used as-is.
98
# If left blank, the following values are used ("$name" is automatically
99
# replaced with the name of the entity): "The $name class" "The $name widget"
100
# "The $name file" "is" "provides" "specifies" "contains"
101
# "represents" "a" "an" "the"
102

    
103
ABBREVIATE_BRIEF       =
104

    
105
# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
106
# Doxygen will generate a detailed section even if there is only a brief
107
# description.
108

    
109
ALWAYS_DETAILED_SEC    = NO
110

    
111
# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
112
# inherited members of a class in the documentation of that class as if those
113
# members were ordinary class members. Constructors, destructors and assignment
114
# operators of the base classes will not be shown.
115

    
116
INLINE_INHERITED_MEMB  = NO
117

    
118
# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full
119
# path before files name in the file list and in the header files. If set
120
# to NO the shortest path that makes the file name unique will be used.
121

    
122
FULL_PATH_NAMES        = YES
123

    
124
# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag
125
# can be used to strip a user-defined part of the path. Stripping is
126
# only done if one of the specified strings matches the left-hand part of
127
# the path. The tag can be used to show relative paths in the file list.
128
# If left blank the directory from which doxygen is run is used as the
129
# path to strip.
130

    
131
STRIP_FROM_PATH        =
132

    
133
# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of
134
# the path mentioned in the documentation of a class, which tells
135
# the reader which header file to include in order to use a class.
136
# If left blank only the name of the header file containing the class
137
# definition is used. Otherwise one should specify the include paths that
138
# are normally passed to the compiler using the -I flag.
139

    
140
STRIP_FROM_INC_PATH    =
141

    
142
# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter
143
# (but less readable) file names. This can be useful if your file system
144
# doesn't support long names like on DOS, Mac, or CD-ROM.
145

    
146
SHORT_NAMES            = NO
147

    
148
# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen
149
# will interpret the first line (until the first dot) of a JavaDoc-style
150
# comment as the brief description. If set to NO, the JavaDoc
151
# comments will behave just like regular Qt-style comments
152
# (thus requiring an explicit @brief command for a brief description.)
153

    
154
JAVADOC_AUTOBRIEF      = NO
155

    
156
# If the QT_AUTOBRIEF tag is set to YES then Doxygen will
157
# interpret the first line (until the first dot) of a Qt-style
158
# comment as the brief description. If set to NO, the comments
159
# will behave just like regular Qt-style comments (thus requiring
160
# an explicit \brief command for a brief description.)
161

    
162
QT_AUTOBRIEF           = NO
163

    
164
# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen
165
# treat a multi-line C++ special comment block (i.e. a block of //! or ///
166
# comments) as a brief description. This used to be the default behaviour.
167
# The new default is to treat a multi-line C++ comment block as a detailed
168
# description. Set this tag to YES if you prefer the old behaviour instead.
169

    
170
MULTILINE_CPP_IS_BRIEF = NO
171

    
172
# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented
173
# member inherits the documentation from any documented member that it
174
# re-implements.
175

    
176
INHERIT_DOCS           = YES
177

    
178
# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce
179
# a new page for each member. If set to NO, the documentation of a member will
180
# be part of the file/class/namespace that contains it.
181

    
182
SEPARATE_MEMBER_PAGES  = NO
183

    
184
# The TAB_SIZE tag can be used to set the number of spaces in a tab.
185
# Doxygen uses this value to replace tabs by spaces in code fragments.
186

    
187
TAB_SIZE               = 8
188

    
189
# This tag can be used to specify a number of aliases that acts
190
# as commands in the documentation. An alias has the form "name=value".
191
# For example adding "sideeffect=\par Side Effects:\n" will allow you to
192
# put the command \sideeffect (or @sideeffect) in the documentation, which
193
# will result in a user-defined paragraph with heading "Side Effects:".
194
# You can put \n's in the value part of an alias to insert newlines.
195

    
196
ALIASES                =
197

    
198
# This tag can be used to specify a number of word-keyword mappings (TCL only).
199
# A mapping has the form "name=value". For example adding
200
# "class=itcl::class" will allow you to use the command class in the
201
# itcl::class meaning.
202

    
203
TCL_SUBST              =
204

    
205
# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C
206
# sources only. Doxygen will then generate output that is more tailored for C.
207
# For instance, some of the names that are used will be different. The list
208
# of all members will be omitted, etc.
209

    
210
OPTIMIZE_OUTPUT_FOR_C  = YES
211

    
212
# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java
213
# sources only. Doxygen will then generate output that is more tailored for
214
# Java. For instance, namespaces will be presented as packages, qualified
215
# scopes will look different, etc.
216

    
217
OPTIMIZE_OUTPUT_JAVA   = NO
218

    
219
# Set the OPTIMIZE_FOR_FORTRAN tag to YES if your project consists of Fortran
220
# sources only. Doxygen will then generate output that is more tailored for
221
# Fortran.
222

    
223
OPTIMIZE_FOR_FORTRAN   = NO
224

    
225
# Set the OPTIMIZE_OUTPUT_VHDL tag to YES if your project consists of VHDL
226
# sources. Doxygen will then generate output that is tailored for
227
# VHDL.
228

    
229
OPTIMIZE_OUTPUT_VHDL   = NO
230

    
231
# Doxygen selects the parser to use depending on the extension of the files it
232
# parses. With this tag you can assign which parser to use for a given extension.
233
# Doxygen has a built-in mapping, but you can override or extend it using this
234
# tag. The format is ext=language, where ext is a file extension, and language
235
# is one of the parsers supported by doxygen: IDL, Java, Javascript, CSharp, C,
236
# C++, D, PHP, Objective-C, Python, Fortran, VHDL, C, C++. For instance to make
237
# doxygen treat .inc files as Fortran files (default is PHP), and .f files as C
238
# (default is Fortran), use: inc=Fortran f=C. Note that for custom extensions
239
# you also need to set FILE_PATTERNS otherwise the files are not read by doxygen.
240

    
241
EXTENSION_MAPPING      =
242

    
243
# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want
244
# to include (a tag file for) the STL sources as input, then you should
245
# set this tag to YES in order to let doxygen match functions declarations and
246
# definitions whose arguments contain STL classes (e.g. func(std::string); v.s.
247
# func(std::string) {}). This also makes the inheritance and collaboration
248
# diagrams that involve STL classes more complete and accurate.
249

    
250
BUILTIN_STL_SUPPORT    = NO
251

    
252
# If you use Microsoft's C++/CLI language, you should set this option to YES to
253
# enable parsing support.
254

    
255
CPP_CLI_SUPPORT        = NO
256

    
257
# Set the SIP_SUPPORT tag to YES if your project consists of sip sources only.
258
# Doxygen will parse them like normal C++ but will assume all classes use public
259
# instead of private inheritance when no explicit protection keyword is present.
260

    
261
SIP_SUPPORT            = NO
262

    
263
# For Microsoft's IDL there are propget and propput attributes to indicate getter
264
# and setter methods for a property. Setting this option to YES (the default)
265
# will make doxygen replace the get and set methods by a property in the
266
# documentation. This will only work if the methods are indeed getting or
267
# setting a simple type. If this is not the case, or you want to show the
268
# methods anyway, you should set this option to NO.
269

    
270
IDL_PROPERTY_SUPPORT   = YES
271

    
272
# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
273
# tag is set to YES, then doxygen will reuse the documentation of the first
274
# member in the group (if any) for the other members of the group. By default
275
# all members of a group must be documented explicitly.
276

    
277
DISTRIBUTE_GROUP_DOC   = NO
278

    
279
# Set the SUBGROUPING tag to YES (the default) to allow class member groups of
280
# the same type (for instance a group of public functions) to be put as a
281
# subgroup of that type (e.g. under the Public Functions section). Set it to
282
# NO to prevent subgrouping. Alternatively, this can be done per class using
283
# the \nosubgrouping command.
284

    
285
SUBGROUPING            = YES
286

    
287
# When the INLINE_GROUPED_CLASSES tag is set to YES, classes, structs and
288
# unions are shown inside the group in which they are included (e.g. using
289
# @ingroup) instead of on a separate page (for HTML and Man pages) or
290
# section (for LaTeX and RTF).
291

    
292
INLINE_GROUPED_CLASSES = NO
293

    
294
# When the INLINE_SIMPLE_STRUCTS tag is set to YES, structs, classes, and
295
# unions with only public data fields will be shown inline in the documentation
296
# of the scope in which they are defined (i.e. file, namespace, or group
297
# documentation), provided this scope is documented. If set to NO (the default),
298
# structs, classes, and unions are shown on a separate page (for HTML and Man
299
# pages) or section (for LaTeX and RTF).
300

    
301
INLINE_SIMPLE_STRUCTS  = NO
302

    
303
# When TYPEDEF_HIDES_STRUCT is enabled, a typedef of a struct, union, or enum
304
# is documented as struct, union, or enum with the name of the typedef. So
305
# typedef struct TypeS {} TypeT, will appear in the documentation as a struct
306
# with name TypeT. When disabled the typedef will appear as a member of a file,
307
# namespace, or class. And the struct will be named TypeS. This can typically
308
# be useful for C code in case the coding convention dictates that all compound
309
# types are typedef'ed and only the typedef is referenced, never the tag name.
310

    
311
TYPEDEF_HIDES_STRUCT   = YES
312

    
313
# The SYMBOL_CACHE_SIZE determines the size of the internal cache use to
314
# determine which symbols to keep in memory and which to flush to disk.
315
# When the cache is full, less often used symbols will be written to disk.
316
# For small to medium size projects (<1000 input files) the default value is
317
# probably good enough. For larger projects a too small cache size can cause
318
# doxygen to be busy swapping symbols to and from disk most of the time
319
# causing a significant performance penalty.
320
# If the system has enough physical memory increasing the cache will improve the
321
# performance by keeping more symbols in memory. Note that the value works on
322
# a logarithmic scale so increasing the size by one will roughly double the
323
# memory usage. The cache size is given by this formula:
324
# 2^(16+SYMBOL_CACHE_SIZE). The valid range is 0..9, the default is 0,
325
# corresponding to a cache size of 2^16 = 65536 symbols.
326

    
327
SYMBOL_CACHE_SIZE      = 0
328

    
329
# Similar to the SYMBOL_CACHE_SIZE the size of the symbol lookup cache can be
330
# set using LOOKUP_CACHE_SIZE. This cache is used to resolve symbols given
331
# their name and scope. Since this can be an expensive process and often the
332
# same symbol appear multiple times in the code, doxygen keeps a cache of
333
# pre-resolved symbols. If the cache is too small doxygen will become slower.
334
# If the cache is too large, memory is wasted. The cache size is given by this
335
# formula: 2^(16+LOOKUP_CACHE_SIZE). The valid range is 0..9, the default is 0,
336
# corresponding to a cache size of 2^16 = 65536 symbols.
337

    
338
LOOKUP_CACHE_SIZE      = 0
339

    
340
#---------------------------------------------------------------------------
341
# Build related configuration options
342
#---------------------------------------------------------------------------
343

    
344
# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
345
# documentation are documented, even if no documentation was available.
346
# Private class members and static file members will be hidden unless
347
# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES
348

    
349
EXTRACT_ALL            = YES
350

    
351
# If the EXTRACT_PRIVATE tag is set to YES all private members of a class
352
# will be included in the documentation.
353

    
354
EXTRACT_PRIVATE        = NO
355

    
356
# If the EXTRACT_STATIC tag is set to YES all static members of a file
357
# will be included in the documentation.
358

    
359
EXTRACT_STATIC         = NO
360

    
361
# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs)
362
# defined locally in source files will be included in the documentation.
363
# If set to NO only classes defined in header files are included.
364

    
365
EXTRACT_LOCAL_CLASSES  = YES
366

    
367
# This flag is only useful for Objective-C code. When set to YES local
368
# methods, which are defined in the implementation section but not in
369
# the interface are included in the documentation.
370
# If set to NO (the default) only methods in the interface are included.
371

    
372
EXTRACT_LOCAL_METHODS  = NO
373

    
374
# If this flag is set to YES, the members of anonymous namespaces will be
375
# extracted and appear in the documentation as a namespace called
376
# 'anonymous_namespace{file}', where file will be replaced with the base
377
# name of the file that contains the anonymous namespace. By default
378
# anonymous namespaces are hidden.
379

    
380
EXTRACT_ANON_NSPACES   = NO
381

    
382
# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all
383
# undocumented members of documented classes, files or namespaces.
384
# If set to NO (the default) these members will be included in the
385
# various overviews, but no documentation section is generated.
386
# This option has no effect if EXTRACT_ALL is enabled.
387

    
388
HIDE_UNDOC_MEMBERS     = NO
389

    
390
# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all
391
# undocumented classes that are normally visible in the class hierarchy.
392
# If set to NO (the default) these classes will be included in the various
393