1 # This file is part of OpenTTD.
2 # 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.
3 # 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.
4 # 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 Source"
13 PROJECT_NUMBER = ${REV_VERSION}
16 OUTPUT_DIRECTORY = ${CPACK_BINARY_DIR}/docs/source/
18 CREATE_SUBDIRS_LEVEL = 8
19 ALLOW_UNICODE_NAMES = NO
20 OUTPUT_LANGUAGE = English
21 BRIEF_MEMBER_DESC = YES
23 ABBREVIATE_BRIEF = "The $name class" \
34 ALWAYS_DETAILED_SEC = NO
35 INLINE_INHERITED_MEMB = NO
40 JAVADOC_AUTOBRIEF = YES
43 MULTILINE_CPP_IS_BRIEF = NO
44 PYTHON_DOCSTRING = YES
46 SEPARATE_MEMBER_PAGES = NO
49 OPTIMIZE_OUTPUT_FOR_C = YES
50 OPTIMIZE_OUTPUT_JAVA = NO
51 OPTIMIZE_FOR_FORTRAN = NO
52 OPTIMIZE_OUTPUT_VHDL = NO
53 OPTIMIZE_OUTPUT_SLICE = NO
55 MARKDOWN_SUPPORT = YES
56 TOC_INCLUDE_HEADINGS = 0
57 AUTOLINK_SUPPORT = YES
58 BUILTIN_STL_SUPPORT = NO
61 IDL_PROPERTY_SUPPORT = YES
62 DISTRIBUTE_GROUP_DOC = NO
63 GROUP_NESTED_COMPOUNDS = NO
65 INLINE_GROUPED_CLASSES = NO
66 INLINE_SIMPLE_STRUCTS = NO
67 TYPEDEF_HIDES_STRUCT = NO
70 #---------------------------------------------------------------------------
71 # Build related configuration options
72 #---------------------------------------------------------------------------
75 EXTRACT_PRIV_VIRTUAL = NO
78 EXTRACT_LOCAL_CLASSES = YES
79 EXTRACT_LOCAL_METHODS = YES
80 EXTRACT_ANON_NSPACES = YES
81 RESOLVE_UNNAMED_PARAMS = YES
82 HIDE_UNDOC_MEMBERS = NO
83 HIDE_UNDOC_CLASSES = NO
84 HIDE_FRIEND_COMPOUNDS = NO
85 HIDE_IN_BODY_DOCS = NO
87 CASE_SENSE_NAMES = YES
89 HIDE_COMPOUND_REFERENCE= NO
91 SHOW_INCLUDE_FILES = YES
92 SHOW_GROUPED_MEMB_INC = NO
93 FORCE_LOCAL_INCLUDES = NO
95 SORT_MEMBER_DOCS = YES
97 SORT_MEMBERS_CTORS_1ST = NO
99 SORT_BY_SCOPE_NAME = NO
100 STRICT_PROTO_MATCHING = NO
101 GENERATE_TODOLIST = YES
102 GENERATE_TESTLIST = YES
103 GENERATE_BUGLIST = YES
104 GENERATE_DEPRECATEDLIST= YES
106 MAX_INITIALIZER_LINES = 30
107 SHOW_USED_FILES = YES
109 SHOW_NAMESPACES = YES
110 FILE_VERSION_FILTER =
113 #---------------------------------------------------------------------------
114 # Configuration options related to warning and progress messages
115 #---------------------------------------------------------------------------
118 WARN_IF_UNDOCUMENTED = YES
119 WARN_IF_DOC_ERROR = YES
120 WARN_IF_INCOMPLETE_DOC = YES
121 WARN_NO_PARAMDOC = NO
123 WARN_FORMAT = "$file:$line: $text"
124 WARN_LINE_FORMAT = "at line $line of file $file"
126 #---------------------------------------------------------------------------
127 # Configuration options related to the input files
128 #---------------------------------------------------------------------------
130 INPUT_ENCODING = UTF-8
131 FILE_PATTERNS = *.c \
140 EXCLUDE_SYMLINKS = NO
141 EXCLUDE_PATTERNS = */3rdparty \
146 EXAMPLE_RECURSIVE = NO
150 FILTER_SOURCE_FILES = NO
151 FILTER_SOURCE_PATTERNS =
152 USE_MDFILE_AS_MAINPAGE =
153 #---------------------------------------------------------------------------
154 # Configuration options related to source browsing
155 #---------------------------------------------------------------------------
158 STRIP_CODE_COMMENTS = YES
159 REFERENCED_BY_RELATION = YES
160 REFERENCES_RELATION = YES
161 REFERENCES_LINK_SOURCE = YES
162 SOURCE_TOOLTIPS = YES
164 VERBATIM_HEADERS = YES
165 CLANG_ASSISTED_PARSING = NO
166 CLANG_ADD_INC_PATHS = YES
168 CLANG_DATABASE_PATH =
169 #---------------------------------------------------------------------------
170 # Configuration options related to the alphabetical class index
171 #---------------------------------------------------------------------------
172 ALPHABETICAL_INDEX = NO
174 #---------------------------------------------------------------------------
175 # Configuration options related to the HTML output
176 #---------------------------------------------------------------------------
179 HTML_FILE_EXTENSION = .html
183 HTML_EXTRA_STYLESHEET =
185 HTML_COLORSTYLE_HUE = 220
186 HTML_COLORSTYLE_SAT = 100
187 HTML_COLORSTYLE_GAMMA = 80
189 HTML_DYNAMIC_MENUS = YES
190 HTML_DYNAMIC_SECTIONS = NO
191 HTML_INDEX_NUM_ENTRIES = 100
193 DOCSET_FEEDNAME = "Doxygen generated docs"
195 DOCSET_BUNDLE_ID = org.doxygen.Project
196 DOCSET_PUBLISHER_ID = org.doxygen.Publisher
197 DOCSET_PUBLISHER_NAME = Publisher
198 GENERATE_HTMLHELP = NO
207 QHP_NAMESPACE = org.doxygen.Project
208 QHP_VIRTUAL_FOLDER = doc
209 QHP_CUST_FILTER_NAME =
210 QHP_CUST_FILTER_ATTRS =
211 QHP_SECT_FILTER_ATTRS =
213 GENERATE_ECLIPSEHELP = NO
214 ECLIPSE_DOC_ID = org.doxygen.Project
216 GENERATE_TREEVIEW = YES
218 ENUM_VALUES_PER_LINE = 4
220 EXT_LINKS_IN_WINDOW = NO
221 OBFUSCATE_EMAILS = YES
222 HTML_FORMULA_FORMAT = png
223 FORMULA_FONTSIZE = 10
224 FORMULA_TRANSPARENT = YES
227 MATHJAX_VERSION = MathJax_2
228 MATHJAX_FORMAT = HTML-CSS
229 MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2/
233 SERVER_BASED_SEARCH = NO
236 SEARCHDATA_FILE = searchdata.xml
238 EXTRA_SEARCH_MAPPINGS =
239 #---------------------------------------------------------------------------
240 # Configuration options related to the LaTeX output
241 #---------------------------------------------------------------------------
244 LATEX_CMD_NAME = latex
245 MAKEINDEX_CMD_NAME = makeindex
246 LATEX_MAKEINDEX_CMD = makeindex
252 LATEX_EXTRA_STYLESHEET =
257 LATEX_HIDE_INDICES = NO
258 LATEX_BIB_STYLE = plain
260 LATEX_EMOJI_DIRECTORY =
261 #---------------------------------------------------------------------------
262 # Configuration options related to the RTF output
263 #---------------------------------------------------------------------------
268 RTF_STYLESHEET_FILE =
269 RTF_EXTENSIONS_FILE =
270 #---------------------------------------------------------------------------
271 # Configuration options related to the man page output
272 #---------------------------------------------------------------------------
278 #---------------------------------------------------------------------------
279 # Configuration options related to the XML output
280 #---------------------------------------------------------------------------
283 XML_PROGRAMLISTING = YES
284 XML_NS_MEMB_FILE_SCOPE = NO
285 #---------------------------------------------------------------------------
286 # Configuration options related to the DOCBOOK output
287 #---------------------------------------------------------------------------
288 GENERATE_DOCBOOK = NO
289 DOCBOOK_OUTPUT = docbook
290 #---------------------------------------------------------------------------
291 # Configuration options for the AutoGen Definitions output
292 #---------------------------------------------------------------------------
293 GENERATE_AUTOGEN_DEF = NO
294 #---------------------------------------------------------------------------
295 # Configuration options related to the Perl module output
296 #---------------------------------------------------------------------------
297 GENERATE_PERLMOD = NO
300 PERLMOD_MAKEVAR_PREFIX =
301 #---------------------------------------------------------------------------
302 # Configuration options related to the preprocessor
303 #---------------------------------------------------------------------------
304 ENABLE_PREPROCESSING = YES
305 MACRO_EXPANSION = YES
306 EXPAND_ONLY_PREDEF = YES
307 SEARCH_INCLUDES = YES
309 INCLUDE_FILE_PATTERNS =
310 PREDEFINED = WITH_ZLIB \
324 SKIP_FUNCTION_MACROS = YES
325 #---------------------------------------------------------------------------
326 # Configuration options related to external references
327 #---------------------------------------------------------------------------
329 GENERATE_TAGFILE = ${CPACK_BINARY_DIR}/docs/openttd.tag
331 EXTERNAL_GROUPS = YES
333 #---------------------------------------------------------------------------
334 # Configuration options related to the dot tool
335 #---------------------------------------------------------------------------
337 HIDE_UNDOC_RELATIONS = YES
340 DOT_FONTNAME = Helvetica
344 COLLABORATION_GRAPH = YES
347 UML_LIMIT_NUM_FIELDS = 10
349 DOT_WRAP_THRESHOLD = 17
350 TEMPLATE_RELATIONS = NO
352 INCLUDED_BY_GRAPH = YES
355 GRAPHICAL_HIERARCHY = YES
356 DIRECTORY_GRAPH = YES
357 DIR_GRAPH_MAX_DEPTH = 1
358 DOT_IMAGE_FORMAT = png
366 PLANTUML_INCLUDE_PATH =
367 DOT_GRAPH_MAX_NODES = 50
368 MAX_DOT_GRAPH_DEPTH = 1000
370 DOT_MULTI_TARGETS = NO
371 GENERATE_LEGEND = YES