comparison doc/doxyhtml/Doxyfile.in @ 17106:054905bfc306

maint: Non-trivial merge of stable to default * Doxyfile.in: Change input directories to use libinterp and libgui * main.c: Delete * main.cc: Put the Doxygen docs here instead * Makefile.am: Add doxyhtml target * configure.ac: Add doc/doxyhtml/Doxyfile configuration file
author Jordi Gutiérrez Hermoso <jordigh@octave.org>
date Mon, 29 Jul 2013 15:04:52 -0400
parents c48625614ea6
children 1c421f01b737
comparison
equal deleted inserted replaced
17105:7870c65bba67 17106:054905bfc306
1 # -*- mode: conf; -*-
2
3 # Doxyfile for Doxygen 1.7.1
4
5 # This file describes the settings to be used by the documentation system
6 # doxygen (www.doxygen.org) for GNU Octave.
7 #
8 # All text after a hash (#) is considered a comment and will be ignored
9 # The format is:
10 # TAG = value [value, ...]
11 # For lists items can also be appended using:
12 # TAG += value [value, ...]
13 # Values that contain spaces should be placed between quotes (" ")
14
15 #---------------------------------------------------------------------------
16 # Project related configuration options
17 #---------------------------------------------------------------------------
18
19 # This tag specifies the encoding used for all characters in the
20 # config file that follow. We don't use anything but ASCII, but
21 # there's no problem using UTF-8 from now on
22
23 DOXYFILE_ENCODING = UTF-8
24
25 # Who we are. :-)
26
27 PROJECT_NAME = "GNU Octave"
28
29 PROJECT_BRIEF = "A high-level interpreted language, primarily intended for numerical computations, mostly compatible with Matlab"
30
31 # The public stable API version (unrelated to the internal API
32 # version).
33
34 PROJECT_NUMBER = @PACKAGE_VERSION@
35
36 # Our logo!
37
38 PROJECT_LOGO = @top_srcdir@/doc/icons/octave-logo.png
39
40 # The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute)
41 # base path where the generated documentation will be put.
42
43 OUTPUT_DIRECTORY = @abs_top_builddir@/doc
44
45 # Create 4096 sub-directories (in 2 levels) under the output directory
46 # of each output format and will distribute the generated files over
47 # these directories. Enabling this option is useful for us, since
48 # feeding doxygen a huge amount of source files would put all
49 # generated files in the same directory would otherwise cause
50 # performance problems for the file system.
51
52 CREATE_SUBDIRS = YES
53
54 # The OUTPUT_LANGUAGE tag is used to specify the language in which all
55 # documentation generated by doxygen is written.
56
57 OUTPUT_LANGUAGE = English
58
59 # Include brief member descriptions after the members that are listed
60 # in the file and class documentation (similar to JavaDoc). Set to NO
61 # to disable this.
62
63 BRIEF_MEMBER_DESC = YES
64
65 # Prepend the brief description of a member or function before the
66 # detailed description. Note: if both HIDE_UNDOC_MEMBERS and
67 # BRIEF_MEMBER_DESC are set to NO, the brief descriptions will be
68 # completely suppressed.
69
70 REPEAT_BRIEF = YES
71
72 # If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then
73 # Doxygen will generate a detailed section even if there is only a brief
74 # description.
75
76 ALWAYS_DETAILED_SEC = NO
77
78 # Show inherited members as if they were part of the current class
79
80 INLINE_INHERITED_MEMB = YES
81
82 # Prepend the full path before files name in the file list and in the
83 # header files.
84
85 FULL_PATH_NAMES = YES
86
87 # Remove from the full path names the absolute prefix
88
89 STRIP_FROM_PATH = @top_srcdir@
90
91 # Interpret the first line (until the first dot) of a JavaDoc-style
92 # comment as the brief description (without needing the @brief
93 # command).
94
95 JAVADOC_AUTOBRIEF = YES
96
97 # Interpret the first line (until the first dot) of a Qt-style comment
98 # as the brief descriptio (without needing the \brief command).
99
100 QT_AUTOBRIEF = NO
101
102 # Undocumented member inherits the documentation from any documented
103 # member that it re-implements.
104
105 INHERIT_DOCS = YES
106
107 # If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce
108 # a new page for each member. If set to NO, the documentation of a member will
109 # be part of the file/class/namespace that contains it.
110
111 SEPARATE_MEMBER_PAGES = NO
112
113 # The TAB_SIZE tag can be used to set the number of spaces in a tab.
114 # Doxygen uses this value to replace tabs by spaces in code fragments.
115 # We shouldn't have any tabs in the source code to begin with, however.
116
117 TAB_SIZE = 2
118
119 # Figure out C++ stdlib classes without needing to parse those files.
120
121 BUILTIN_STL_SUPPORT = YES
122
123 #---------------------------------------------------------------------------
124 # Build related configuration options
125 #---------------------------------------------------------------------------
126
127 # Assume all entities in documentation are documented, even if no
128 # documentation was available.
129
130 EXTRACT_ALL = YES
131
132 # Include all private members of a class.
133
134 EXTRACT_PRIVATE = YES
135
136 # Include all static members of a file.
137
138 EXTRACT_STATIC = YES
139
140 # Include classes (and structs) defined locally in source files in the
141 # documentation.
142
143 EXTRACT_LOCAL_CLASSES = YES
144
145 # We have very few namespaces, so show the ones we have
146
147 SHOW_NAMESPACES = YES
148
149 # We don't use namespaces, but if we did, this would extract the
150 # anonymous one.
151
152 EXTRACT_ANON_NSPACES = YES
153
154 # Hide internal docs, those with the \internal command.
155
156 INTERNAL_DOCS = NO
157
158 # Case-sensitive filenames
159
160 CASE_SENSE_NAMES = YES
161
162 # List include files with double quotes in the documentation rather
163 # than with sharp brackets.
164
165 FORCE_LOCAL_INCLUDES = YES
166
167 # Show members alphabetically
168
169 SORT_MEMBER_DOCS = YES
170
171 # Also sort the brief descriptions
172
173 SORT_BRIEF_DOCS = YES
174
175 # Put ctors first.
176
177 SORT_MEMBERS_CTORS_1ST = YES
178
179 # Expand the DEFUN family of macros
180
181 MACRO_EXPANSION = YES
182 EXPAND_ONLY_PREDEF = YES
183 EXPAND_AS_DEFINED = DEFUN DEFUN_DLD # As defined in the Octave source
184 # code, i.e. not overriden by this
185 # config file
186
187 #---------------------------------------------------------------------------
188 # configuration options related to the input files
189 #---------------------------------------------------------------------------
190
191 # Which directories contain Octave source code
192
193 INPUT = @top_srcdir@/src/ @top_srcdir@/liboctave/
194 INPUT += @top_srcdir@/libinterp @top_srcdir@/libgui
195
196 # Search subdirectories for input.
197
198 RECURSIVE = YES
199
200 # Our examples.
201
202 EXAMPLE_PATH = @top_srcdir@/examples/
203
204 # If the value of the EXAMPLE_PATH tag contains directories, you can use the
205 # EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp
206 # and *.h) to filter out the source-files in the directories. If left
207 # blank all files are included.
208
209 EXAMPLE_PATTERNS =
210
211 # There are no extra C++ files in the examples subdir
212
213 EXAMPLE_RECURSIVE = NO
214
215 #---------------------------------------------------------------------------
216 # configuration options related to source browsing
217 #---------------------------------------------------------------------------
218
219 # Generate a list of source files will be generated.
220
221 SOURCE_BROWSER = YES
222
223 # Setting the INLINE_SOURCES tag to YES will include the body
224 # of functions and classes directly in the documentation.
225
226 INLINE_SOURCES = NO
227
228 # Don't hide the special Doxygen comment blocks
229
230 STRIP_CODE_COMMENTS = NO
231
232 # For each documented function, list all documented functions
233 # referencing it.
234
235 REFERENCED_BY_RELATION = YES
236
237 # For each documented function all documented entities called/used by
238 # that function will be listed.
239
240 REFERENCES_RELATION = YES
241
242 # References link to documentation, not source code.
243
244 REFERENCES_LINK_SOURCE = NO
245
246 #---------------------------------------------------------------------------
247 # configuration options related to the HTML output
248 #---------------------------------------------------------------------------
249
250 # Generate HTML
251
252 GENERATE_HTML = YES
253
254 # i.e. @abs_top_builddir@/doc/doxyhtml
255
256 HTML_OUTPUT = doxyhtml
257
258 #---------------------------------------------------------------------------
259 # configuration options related to the LaTeX output
260 #---------------------------------------------------------------------------
261
262 # No LaTeX
263
264 GENERATE_LATEX = NO
265
266 #---------------------------------------------------------------------------
267 # Configuration options related to the dot tool
268 #---------------------------------------------------------------------------
269
270 # Show undocumented relations
271
272 HIDE_UNDOC_RELATIONS = NO
273
274 # Use dot from graphviz to generate class diagrams.
275
276 HAVE_DOT = YES
277
278 # Remove intermediate dot files.
279
280 DOT_CLEANUP = YES
281
282 # Some of our dependency graphs are really huge...
283
284 DOT_GRAPH_MAX_NODES = 100