Mercurial > hg > octave-nkf
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 |