c6555f16ea82c40c3613a540e0fa51caf78c88a8
[alexxy/gromacs.git] / docs / doxygen / Doxyfile-common.cmakein
1 PROJECT_NAME           = @CMAKE_PROJECT_NAME@
2 @INCLUDE               = Doxyfile-version
3 LAYOUT_FILE            = @CMAKE_CURRENT_SOURCE_DIR@/DoxygenLayout.xml
4 INPUT                  = @CMAKE_CURRENT_SOURCE_DIR@ \
5                          @CMAKE_SOURCE_DIR@/src \
6                          @CMAKE_SOURCE_DIR@/share/template
7 FILE_PATTERNS          = *.c *.cpp *.h *.md
8 # CUDA files could be included like this, but currently produce a lot of
9 # warnings.
10 # FILE_PATTERNS         += *.cu *.cuh
11 EXAMPLE_PATH           = @CMAKE_SOURCE_DIR@
12 RECURSIVE              = YES
13 EXCLUDE                = @CMAKE_CURRENT_SOURCE_DIR@/examples \
14                          @CMAKE_SOURCE_DIR@/src/contrib \
15                          @CMAKE_SOURCE_DIR@/src/external \
16                          @CMAKE_SOURCE_DIR@/src/gromacs/selection/parser.cpp \
17                          @CMAKE_SOURCE_DIR@/src/gromacs/selection/parser.h \
18                          @CMAKE_SOURCE_DIR@/src/gromacs/selection/scanner.cpp @NB_KERNEL_DIRS_TO_IGNORE_IN_DOXYGEN@
19 EXCLUDE_SYMBOLS        = YY* yy* _gmx_sel_yy*
20 EXCLUDE_SYMBOLS       += __STDC*
21 EXCLUDE_SYMBOLS       += TEST TEST_F TEST_P TYPED_TEST_CASE TYPED_TEST INSTANTIATE_TEST_CASE_P
22 EXCLUDE_SYMBOLS       += MOCK_METHOD* MOCK_CONST_METHOD*
23 FULL_PATH_NAMES        = YES
24 STRIP_FROM_PATH        = @CMAKE_SOURCE_DIR@
25 STRIP_FROM_INC_PATH    = @CMAKE_SOURCE_DIR@/src
26 INCLUDE_PATH           = @CMAKE_SOURCE_DIR@/src
27 HAVE_DOT               = @DOXYGEN_DOT_FOUND@
28 DOT_PATH               = @DOXYGEN_DOT_PATH@
29 MSCGEN_PATH            = @DOXYGEN_MSCGEN_PATH@
30 @DOXYGEN_EXTRA_SETTINGS@
31
32 ENABLED_SECTIONS       = @DOXYGEN_SECTIONS@
33
34 MACRO_EXPANSION        = YES
35 # Extract documentation also for code in headers within #ifdef __cplusplus
36 PREDEFINED             = __cplusplus
37 # This is for cases where \cond does not work, so that #ifndef can also be used.
38 # thread_mpi also uses this, but it is now excluded from the documentation.
39 PREDEFINED            += DOXYGEN
40 # This makes 'static gmx_inline' functions appear better in the documentation.
41 PREDEFINED            += gmx_inline=inline
42 # This is for parser.cpp to make it produce code that Doxygen understands
43 # and that does not have unnecessary function declarations.
44 PREDEFINED            += __STDC__ YYMALLOC=malloc YYFREE=free
45
46 JAVADOC_AUTOBRIEF      = YES
47 BUILTIN_STL_SUPPORT    = YES
48 INLINE_INHERITED_MEMB  = YES
49 SORT_BY_SCOPE_NAME     = YES
50 ALPHABETICAL_INDEX     = YES
51 HTML_DYNAMIC_SECTIONS  = YES
52 GENERATE_LATEX         = NO
53 # Setting this to NO has a side effect to hide undocumented headers from the
54 # file list, which makes it generally look nicer.
55 VERBATIM_HEADERS       = NO
56 STRIP_CODE_COMMENTS    = NO
57
58 EXTRACT_LOCAL_CLASSES  = NO
59 # This includes 'static inline' functions from headers in the documentation.
60 EXTRACT_STATIC         = YES
61
62 ALIASES               += Gromacs=GROMACS
63
64 DOT_IMAGE_FORMAT       = svg
65 DOT_MULTI_TARGETS      = YES
66 # According to Doxygen docs, this is required for svg support on IE
67 HTML_FILE_EXTENSION    = .xhtml
68
69 OUTPUT_DIRECTORY       = @HTML_OUTPUT_DIR@/doxygen