3 # This file is part of OpenTTD.
4 # OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
5 # OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
6 # See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
8 #---------------------------------------------------------------------------
9 # Project related configuration options
10 #---------------------------------------------------------------------------
11 DOXYFILE_ENCODING = UTF-8
12 PROJECT_NAME = OpenTTD
16 OUTPUT_DIRECTORY = docs/source/
18 ALLOW_UNICODE_NAMES = NO
19 OUTPUT_LANGUAGE = English
20 BRIEF_MEMBER_DESC = YES
22 ABBREVIATE_BRIEF = "The $name class" \
33 ALWAYS_DETAILED_SEC = NO
34 INLINE_INHERITED_MEMB = NO
39 JAVADOC_AUTOBRIEF = YES
41 MULTILINE_CPP_IS_BRIEF = NO
43 SEPARATE_MEMBER_PAGES = NO
47 OPTIMIZE_OUTPUT_FOR_C = YES
48 OPTIMIZE_OUTPUT_JAVA = NO
49 OPTIMIZE_FOR_FORTRAN = NO
50 OPTIMIZE_OUTPUT_VHDL = NO
52 MARKDOWN_SUPPORT = YES
53 TOC_INCLUDE_HEADINGS = 0
54 AUTOLINK_SUPPORT = YES
55 BUILTIN_STL_SUPPORT = NO
58 IDL_PROPERTY_SUPPORT = YES
59 DISTRIBUTE_GROUP_DOC = NO
60 GROUP_NESTED_COMPOUNDS = NO
62 INLINE_GROUPED_CLASSES = NO
63 INLINE_SIMPLE_STRUCTS = NO
64 TYPEDEF_HIDES_STRUCT = NO
66 #---------------------------------------------------------------------------
67 # Build related configuration options
68 #---------------------------------------------------------------------------
73 EXTRACT_LOCAL_CLASSES = YES
74 EXTRACT_LOCAL_METHODS = YES
75 EXTRACT_ANON_NSPACES = YES
76 HIDE_UNDOC_MEMBERS = NO
77 HIDE_UNDOC_CLASSES = NO
78 HIDE_FRIEND_COMPOUNDS = NO
79 HIDE_IN_BODY_DOCS = NO
81 CASE_SENSE_NAMES = YES
83 HIDE_COMPOUND_REFERENCE= NO
84 SHOW_INCLUDE_FILES = YES
85 SHOW_GROUPED_MEMB_INC = NO
86 FORCE_LOCAL_INCLUDES = NO
88 SORT_MEMBER_DOCS = YES
90 SORT_MEMBERS_CTORS_1ST = NO
92 SORT_BY_SCOPE_NAME = NO
93 STRICT_PROTO_MATCHING = NO
94 GENERATE_TODOLIST = YES
95 GENERATE_TESTLIST = YES
96 GENERATE_BUGLIST = YES
97 GENERATE_DEPRECATEDLIST= YES
99 MAX_INITIALIZER_LINES = 30
100 SHOW_USED_FILES = YES
102 SHOW_NAMESPACES = YES
103 FILE_VERSION_FILTER =
106 #---------------------------------------------------------------------------
107 # Configuration options related to warning and progress messages
108 #---------------------------------------------------------------------------
111 WARN_IF_UNDOCUMENTED = YES
112 WARN_IF_DOC_ERROR = YES
113 WARN_NO_PARAMDOC = NO
115 WARN_FORMAT = "$file:$line: $text"
117 #---------------------------------------------------------------------------
118 # Configuration options related to the input files
119 #---------------------------------------------------------------------------
121 INPUT_ENCODING = UTF-8
122 FILE_PATTERNS = *.c \
131 EXCLUDE_SYMLINKS = NO
132 EXCLUDE_PATTERNS = */3rdparty \
137 EXAMPLE_RECURSIVE = NO
141 FILTER_SOURCE_FILES = NO
142 FILTER_SOURCE_PATTERNS =
143 USE_MDFILE_AS_MAINPAGE =
144 #---------------------------------------------------------------------------
145 # Configuration options related to source browsing
146 #---------------------------------------------------------------------------
149 STRIP_CODE_COMMENTS = YES
150 REFERENCED_BY_RELATION = YES
151 REFERENCES_RELATION = YES
152 REFERENCES_LINK_SOURCE = YES
153 SOURCE_TOOLTIPS = YES
155 VERBATIM_HEADERS = YES
156 #---------------------------------------------------------------------------
157 # Configuration options related to the alphabetical class index
158 #---------------------------------------------------------------------------
159 ALPHABETICAL_INDEX = NO
160 COLS_IN_ALPHA_INDEX = 5
162 #---------------------------------------------------------------------------
163 # Configuration options related to the HTML output
164 #---------------------------------------------------------------------------
167 HTML_FILE_EXTENSION = .html
171 HTML_EXTRA_STYLESHEET =
173 HTML_COLORSTYLE_HUE = 220
174 HTML_COLORSTYLE_SAT = 100
175 HTML_COLORSTYLE_GAMMA = 80
177 HTML_DYNAMIC_MENUS = YES
178 HTML_DYNAMIC_SECTIONS = NO
179 HTML_INDEX_NUM_ENTRIES = 100
181 DOCSET_FEEDNAME = "Doxygen generated docs"
182 DOCSET_BUNDLE_ID = org.doxygen.Project
183 DOCSET_PUBLISHER_ID = org.doxygen.Publisher
184 DOCSET_PUBLISHER_NAME = Publisher
185 GENERATE_HTMLHELP = NO
194 QHP_NAMESPACE = org.doxygen.Project
195 QHP_VIRTUAL_FOLDER = doc
196 QHP_CUST_FILTER_NAME =
197 QHP_CUST_FILTER_ATTRS =
198 QHP_SECT_FILTER_ATTRS =
200 GENERATE_ECLIPSEHELP = NO
201 ECLIPSE_DOC_ID = org.doxygen.Project
203 GENERATE_TREEVIEW = YES
204 ENUM_VALUES_PER_LINE = 4
206 EXT_LINKS_IN_WINDOW = NO
207 FORMULA_FONTSIZE = 10
208 FORMULA_TRANSPARENT = YES
210 MATHJAX_FORMAT = HTML-CSS
211 MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/
215 SERVER_BASED_SEARCH = NO
218 SEARCHDATA_FILE = searchdata.xml
220 EXTRA_SEARCH_MAPPINGS =
221 #---------------------------------------------------------------------------
222 # Configuration options related to the LaTeX output
223 #---------------------------------------------------------------------------
226 LATEX_CMD_NAME = latex
227 MAKEINDEX_CMD_NAME = makeindex
233 LATEX_EXTRA_STYLESHEET =
238 LATEX_HIDE_INDICES = NO
239 LATEX_SOURCE_CODE = NO
240 LATEX_BIB_STYLE = plain
242 #---------------------------------------------------------------------------
243 # Configuration options related to the RTF output
244 #---------------------------------------------------------------------------
249 RTF_STYLESHEET_FILE =
250 RTF_EXTENSIONS_FILE =
252 #---------------------------------------------------------------------------
253 # Configuration options related to the man page output
254 #---------------------------------------------------------------------------
260 #---------------------------------------------------------------------------
261 # Configuration options related to the XML output
262 #---------------------------------------------------------------------------
265 XML_PROGRAMLISTING = YES
266 #---------------------------------------------------------------------------
267 # Configuration options related to the DOCBOOK output
268 #---------------------------------------------------------------------------
269 GENERATE_DOCBOOK = NO
270 DOCBOOK_OUTPUT = docbook
271 DOCBOOK_PROGRAMLISTING = NO
272 #---------------------------------------------------------------------------
273 # Configuration options for the AutoGen Definitions output
274 #---------------------------------------------------------------------------
275 GENERATE_AUTOGEN_DEF = NO
276 #---------------------------------------------------------------------------
277 # Configuration options related to the Perl module output
278 #---------------------------------------------------------------------------
279 GENERATE_PERLMOD = NO
282 PERLMOD_MAKEVAR_PREFIX =
283 #---------------------------------------------------------------------------
284 # Configuration options related to the preprocessor
285 #---------------------------------------------------------------------------
286 ENABLE_PREPROCESSING = YES
287 MACRO_EXPANSION = YES
288 EXPAND_ONLY_PREDEF = YES
289 SEARCH_INCLUDES = YES
291 INCLUDE_FILE_PATTERNS =
292 PREDEFINED = WITH_ZLIB \
306 SKIP_FUNCTION_MACROS = YES
307 #---------------------------------------------------------------------------
308 # Configuration options related to external references
309 #---------------------------------------------------------------------------
311 GENERATE_TAGFILE = objs/openttd.tag
313 EXTERNAL_GROUPS = YES
315 PERL_PATH = /usr/bin/perl
316 #---------------------------------------------------------------------------
317 # Configuration options related to the dot tool
318 #---------------------------------------------------------------------------
322 HIDE_UNDOC_RELATIONS = YES
325 DOT_FONTNAME = Helvetica
329 COLLABORATION_GRAPH = YES
332 UML_LIMIT_NUM_FIELDS = 10
333 TEMPLATE_RELATIONS = NO
335 INCLUDED_BY_GRAPH = YES
338 GRAPHICAL_HIERARCHY = YES
339 DIRECTORY_GRAPH = YES
340 DOT_IMAGE_FORMAT = png
348 PLANTUML_INCLUDE_PATH =
349 DOT_GRAPH_MAX_NODES = 50
350 MAX_DOT_GRAPH_DEPTH = 1000
352 DOT_MULTI_TARGETS = NO
353 GENERATE_LEGEND = YES