source: trunk/src/xmlpatterns/Doxyfile@ 166

Last change on this file since 166 was 2, checked in by Dmitry A. Kuminov, 16 years ago

Initially imported qt-all-opensource-src-4.5.1 from Trolltech.

File size: 47.7 KB
Line 
1# Doxyfile 1.4.5
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# The PROJECT_NAME tag is a single word (or a sequence of words surrounded
18# by quotes) that should identify the project.
19
20PROJECT_NAME = QtXmlPatterns
21
22# The PROJECT_NUMBER tag can be used to enter a project or revision number.
23# This could be handy for archiving the generated documentation or
24# if some version control system is used.
25
26PROJECT_NUMBER =
27
28# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
29# base path where the generated documentation will be put.
30# If a relative path is entered, it will be relative to the location
31# where doxygen was started. If left blank the current directory will be used.
32
33OUTPUT_DIRECTORY = internal-docs
34
35# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create
36# 4096 sub-directories (in 2 levels) under the output directory of each output
37# format and will distribute the generated files over these directories.
38# Enabling this option can be useful when feeding doxygen a huge amount of
39# source files, where putting all generated files in the same directory would
40# otherwise cause performance problems for the file system.
41
42CREATE_SUBDIRS = NO
43
44# The OUTPUT_LANGUAGE tag is used to specify the language in which all
45# documentation generated by doxygen is written. Doxygen will use this
46# information to generate all constant output in the proper language.
47# The default language is English, other supported languages are:
48# Brazilian, Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish,
49# Dutch, Finnish, French, German, Greek, Hungarian, Italian, Japanese,
50# Japanese-en (Japanese with English messages), Korean, Korean-en, Norwegian,
51# Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovene, Spanish,
52# Swedish, and Ukrainian.
53
54OUTPUT_LANGUAGE = English
55
56# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will
57# include brief member descriptions after the members that are listed in
58# the file and class documentation (similar to JavaDoc).
59# Set to NO to disable this.
60
61BRIEF_MEMBER_DESC = YES
62
63# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend
64# the brief description of a member or function before the detailed description.
65# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
66# brief descriptions will be completely suppressed.
67
68REPEAT_BRIEF = YES
69
70# This tag implements a quasi-intelligent brief description abbreviator
71# that is used to form the text in various listings. Each string
72# in this list, if found as the leading text of the brief description, will be
73# stripped from the text and the result after processing the whole list, is
74# used as the annotated text. Otherwise, the brief description is used as-is.
75# If left blank, the following values are used ("$name" is automatically
76# replaced with the name of the entity): "The $name class" "The $name widget"
77# "The $name file" "is" "provides" "specifies" "contains"
78# "represents" "a" "an" "the"
79
80ABBREVIATE_BRIEF =
81
82# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
83# Doxygen will generate a detailed section even if there is only a brief
84# description.
85
86ALWAYS_DETAILED_SEC = NO
87
88# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all
89# inherited members of a class in the documentation of that class as if those
90# members were ordinary class members. Constructors, destructors and assignment
91# operators of the base classes will not be shown.
92
93INLINE_INHERITED_MEMB = NO
94
95# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full
96# path before files name in the file list and in the header files. If set
97# to NO the shortest path that makes the file name unique will be used.
98
99FULL_PATH_NAMES = YES
100
101# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag
102# can be used to strip a user-defined part of the path. Stripping is
103# only done if one of the specified strings matches the left-hand part of
104# the path. The tag can be used to show relative paths in the file list.
105# If left blank the directory from which doxygen is run is used as the
106# path to strip.
107
108STRIP_FROM_PATH =
109
110# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of
111# the path mentioned in the documentation of a class, which tells
112# the reader which header file to include in order to use a class.
113# If left blank only the name of the header file containing the class
114# definition is used. Otherwise one should specify the include paths that
115# are normally passed to the compiler using the -I flag.
116
117STRIP_FROM_INC_PATH =
118
119# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter
120# (but less readable) file names. This can be useful is your file systems
121# doesn't support long names like on DOS, Mac, or CD-ROM.
122
123SHORT_NAMES = NO
124
125# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen
126# will interpret the first line (until the first dot) of a JavaDoc-style
127# comment as the brief description. If set to NO, the JavaDoc
128# comments will behave just like the Qt-style comments (thus requiring an
129# explicit @brief command for a brief description.
130
131JAVADOC_AUTOBRIEF = NO
132
133# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen
134# treat a multi-line C++ special comment block (i.e. a block of //! or ///
135# comments) as a brief description. This used to be the default behaviour.
136# The new default is to treat a multi-line C++ comment block as a detailed
137# description. Set this tag to YES if you prefer the old behaviour instead.
138
139MULTILINE_CPP_IS_BRIEF = NO
140
141# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented
142# member inherits the documentation from any documented member that it
143# re-implements.
144
145INHERIT_DOCS = YES
146
147# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce
148# a new page for each member. If set to NO, the documentation of a member will
149# be part of the file/class/namespace that contains it.
150
151SEPARATE_MEMBER_PAGES = NO
152
153# The TAB_SIZE tag can be used to set the number of spaces in a tab.
154# Doxygen uses this value to replace tabs by spaces in code fragments.
155
156TAB_SIZE = 4
157
158# This tag can be used to specify a number of aliases that acts
159# as commands in the documentation. An alias has the form "name=value".
160# For example adding "sideeffect=\par Side Effects:\n" will allow you to
161# put the command \sideeffect (or @sideeffect) in the documentation, which
162# will result in a user-defined paragraph with heading "Side Effects:".
163# You can put \n's in the value part of an alias to insert newlines.
164
165ALIASES =
166
167# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C
168# sources only. Doxygen will then generate output that is more tailored for C.
169# For instance, some of the names that are used will be different. The list
170# of all members will be omitted, etc.
171
172OPTIMIZE_OUTPUT_FOR_C = NO
173
174# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java
175# sources only. Doxygen will then generate output that is more tailored for Java.
176# For instance, namespaces will be presented as packages, qualified scopes
177# will look different, etc.
178
179OPTIMIZE_OUTPUT_JAVA = NO
180
181# If you use STL classes (i.e. std::string, std::vector, etc.) but do not want to
182# include (a tag file for) the STL sources as input, then you should
183# set this tag to YES in order to let doxygen match functions declarations and
184# definitions whose arguments contain STL classes (e.g. func(std::string); v.s.
185# func(std::string) {}). This also make the inheritance and collaboration
186# diagrams that involve STL classes more complete and accurate.
187
188BUILTIN_STL_SUPPORT = YES
189
190# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
191# tag is set to YES, then doxygen will reuse the documentation of the first
192# member in the group (if any) for the other members of the group. By default
193# all members of a group must be documented explicitly.
194
195DISTRIBUTE_GROUP_DOC = NO
196
197# Set the SUBGROUPING tag to YES (the default) to allow class member groups of
198# the same type (for instance a group of public functions) to be put as a
199# subgroup of that type (e.g. under the Public Functions section). Set it to
200# NO to prevent subgrouping. Alternatively, this can be done per class using
201# the \nosubgrouping command.
202
203SUBGROUPING = YES
204
205#---------------------------------------------------------------------------
206# Build related configuration options
207#---------------------------------------------------------------------------
208
209# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
210# documentation are documented, even if no documentation was available.
211# Private class members and static file members will be hidden unless
212# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES
213
214EXTRACT_ALL = YES
215
216# If the EXTRACT_PRIVATE tag is set to YES all private members of a class