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 AI API"
13 PROJECT_NUMBER = ${REV_VERSION}
16 OUTPUT_DIRECTORY = ${CPACK_BINARY_DIR}/docs/ai-api/
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 = 5
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 = NO
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 = YES
87 CASE_SENSE_NAMES = YES
89 HIDE_COMPOUND_REFERENCE= NO
91 SHOW_INCLUDE_FILES = NO
92 SHOW_GROUPED_MEMB_INC = NO
93 FORCE_LOCAL_INCLUDES = NO
95 SORT_MEMBER_DOCS = YES
97 SORT_MEMBERS_CTORS_1ST = NO
98 SORT_GROUP_NAMES = YES
99 SORT_BY_SCOPE_NAME = NO
100 STRICT_PROTO_MATCHING = NO
101 GENERATE_TODOLIST = NO
102 GENERATE_TESTLIST = NO
103 GENERATE_BUGLIST = NO
104 GENERATE_DEPRECATEDLIST= NO
106 MAX_INITIALIZER_LINES = 30
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 = YES
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 ${FIND_VERSION_BINARY_DIR}/script/api
131 INPUT_ENCODING = UTF-8
132 FILE_PATTERNS = script_*.hpp \
136 EXCLUDE_SYMLINKS = NO
137 EXCLUDE_PATTERNS = ai_includes.hpp
138 EXCLUDE_SYMBOLS = GetClassName \
139 DECLARE_ENUM_AS_BIT_SET \
140 DECLARE_POSTFIX_INCREMENT
143 EXAMPLE_RECURSIVE = NO
145 INPUT_FILTER = "./doxygen_filter.sh AI"
147 FILTER_SOURCE_FILES = NO
148 FILTER_SOURCE_PATTERNS =
149 USE_MDFILE_AS_MAINPAGE =
150 #---------------------------------------------------------------------------
151 # Configuration options related to source browsing
152 #---------------------------------------------------------------------------
155 STRIP_CODE_COMMENTS = YES
156 REFERENCED_BY_RELATION = NO
157 REFERENCES_RELATION = NO
158 REFERENCES_LINK_SOURCE = YES
159 SOURCE_TOOLTIPS = YES
161 VERBATIM_HEADERS = NO
162 CLANG_ASSISTED_PARSING = NO
163 CLANG_ADD_INC_PATHS = YES
165 CLANG_DATABASE_PATH =
166 #---------------------------------------------------------------------------
167 # Configuration options related to the alphabetical class index
168 #---------------------------------------------------------------------------
169 ALPHABETICAL_INDEX = NO
171 #---------------------------------------------------------------------------
172 # Configuration options related to the HTML output
173 #---------------------------------------------------------------------------
176 HTML_FILE_EXTENSION = .html
180 HTML_EXTRA_STYLESHEET =
182 HTML_COLORSTYLE_HUE = 220
183 HTML_COLORSTYLE_SAT = 100
184 HTML_COLORSTYLE_GAMMA = 80
186 HTML_DYNAMIC_MENUS = YES
187 HTML_DYNAMIC_SECTIONS = NO
188 HTML_INDEX_NUM_ENTRIES = 100
190 DOCSET_FEEDNAME = "Doxygen generated docs"
192 DOCSET_BUNDLE_ID = org.doxygen.Project
193 DOCSET_PUBLISHER_ID = org.doxygen.Publisher
194 DOCSET_PUBLISHER_NAME = Publisher
195 GENERATE_HTMLHELP = NO
204 QHP_NAMESPACE = org.doxygen.Project
205 QHP_VIRTUAL_FOLDER = doc
206 QHP_CUST_FILTER_NAME =
207 QHP_CUST_FILTER_ATTRS =
208 QHP_SECT_FILTER_ATTRS =
210 GENERATE_ECLIPSEHELP = NO
211 ECLIPSE_DOC_ID = org.doxygen.Project
213 GENERATE_TREEVIEW = NO
215 ENUM_VALUES_PER_LINE = 1
217 EXT_LINKS_IN_WINDOW = NO
218 OBFUSCATE_EMAILS = YES
219 HTML_FORMULA_FORMAT = png
220 FORMULA_FONTSIZE = 10
221 FORMULA_TRANSPARENT = YES
224 MATHJAX_VERSION = MathJax_2
225 MATHJAX_FORMAT = HTML-CSS
230 SERVER_BASED_SEARCH = NO
233 SEARCHDATA_FILE = searchdata.xml
235 EXTRA_SEARCH_MAPPINGS =
236 #---------------------------------------------------------------------------
237 # Configuration options related to the LaTeX output
238 #---------------------------------------------------------------------------
241 LATEX_CMD_NAME = latex
242 MAKEINDEX_CMD_NAME = makeindex
243 LATEX_MAKEINDEX_CMD = makeindex
249 LATEX_EXTRA_STYLESHEET =
254 LATEX_HIDE_INDICES = NO
255 LATEX_BIB_STYLE = plain
257 LATEX_EMOJI_DIRECTORY =
258 #---------------------------------------------------------------------------
259 # Configuration options related to the RTF output
260 #---------------------------------------------------------------------------
265 RTF_STYLESHEET_FILE =
266 RTF_EXTENSIONS_FILE =
267 #---------------------------------------------------------------------------
268 # Configuration options related to the man page output
269 #---------------------------------------------------------------------------
275 #---------------------------------------------------------------------------
276 # Configuration options related to the XML output
277 #---------------------------------------------------------------------------
280 XML_PROGRAMLISTING = YES
281 XML_NS_MEMB_FILE_SCOPE = NO
282 #---------------------------------------------------------------------------
283 # Configuration options related to the DOCBOOK output
284 #---------------------------------------------------------------------------
285 GENERATE_DOCBOOK = NO
286 DOCBOOK_OUTPUT = docbook
287 #---------------------------------------------------------------------------
288 # Configuration options for the AutoGen Definitions output
289 #---------------------------------------------------------------------------
290 GENERATE_AUTOGEN_DEF = NO
291 #---------------------------------------------------------------------------
292 # Configuration options related to the Perl module output
293 #---------------------------------------------------------------------------
294 GENERATE_PERLMOD = NO
297 PERLMOD_MAKEVAR_PREFIX =
298 #---------------------------------------------------------------------------
299 # Configuration options related to the preprocessor
300 #---------------------------------------------------------------------------
301 ENABLE_PREPROCESSING = YES
302 MACRO_EXPANSION = YES
303 EXPAND_ONLY_PREDEF = YES
304 SEARCH_INCLUDES = YES
306 INCLUDE_FILE_PATTERNS =
307 PREDEFINED = DOXYGEN_API
308 EXPAND_AS_DEFINED = DEF_COMMAND
309 SKIP_FUNCTION_MACROS = YES
310 #---------------------------------------------------------------------------
311 # Configuration options related to external references
312 #---------------------------------------------------------------------------
314 GENERATE_TAGFILE = ${CPACK_BINARY_DIR}/docs/openttd_ai_api.tag
316 EXTERNAL_GROUPS = YES
318 #---------------------------------------------------------------------------
319 # Configuration options related to the dot tool
320 #---------------------------------------------------------------------------
322 HIDE_UNDOC_RELATIONS = YES
325 DOT_FONTNAME = Helvetica
329 COLLABORATION_GRAPH = YES
332 UML_LIMIT_NUM_FIELDS = 10
334 DOT_WRAP_THRESHOLD = 17
335 TEMPLATE_RELATIONS = NO
337 INCLUDED_BY_GRAPH = YES
340 GRAPHICAL_HIERARCHY = YES
341 DIRECTORY_GRAPH = YES
342 DIR_GRAPH_MAX_DEPTH = 1
343 DOT_IMAGE_FORMAT = png
351 PLANTUML_INCLUDE_PATH =
352 DOT_GRAPH_MAX_NODES = 50
353 MAX_DOT_GRAPH_DEPTH = 1000
355 DOT_MULTI_TARGETS = NO