20a03e069fd4594b10202233c2c42d45b8eaad15
[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
31 ENABLED_SECTIONS       = @DOXYGEN_SECTIONS@
32
33 MACRO_EXPANSION        = YES
34 # Extract documentation also for code in headers within #ifdef __cplusplus
35 PREDEFINED             = __cplusplus
36 # This is for cases where \cond does not work, so that #ifndef can also be used.
37 # thread_mpi also uses this, but it is now excluded from the documentation.
38 PREDEFINED            += DOXYGEN
39 # This makes 'static gmx_inline' functions appear better in the documentation.
40 PREDEFINED            += gmx_inline=inline
41 # This is for parser.cpp to make it produce code that Doxygen understands
42 # and that does not have unnecessary function declarations.
43 PREDEFINED            += __STDC__ YYMALLOC=malloc YYFREE=free
44
45 JAVADOC_AUTOBRIEF      = YES
46 BUILTIN_STL_SUPPORT    = YES
47 INLINE_INHERITED_MEMB  = YES
48 SORT_BY_SCOPE_NAME     = YES
49 ALPHABETICAL_INDEX     = YES
50 HTML_DYNAMIC_SECTIONS  = YES
51 GENERATE_LATEX         = NO
52 # Setting this to NO has a side effect to hide undocumented headers from the
53 # file list, which makes it generally look nicer.
54 VERBATIM_HEADERS       = NO
55 STRIP_CODE_COMMENTS    = NO
56
57 EXTRACT_LOCAL_CLASSES  = NO
58 # This includes 'static inline' functions from headers in the documentation.
59 EXTRACT_STATIC         = YES
60
61 ALIASES               += Gromacs=GROMACS
62
63 DOT_IMAGE_FORMAT       = svg
64 DOT_MULTI_TARGETS      = YES
65 # According to Doxygen docs, this is required for svg support on IE
66 HTML_FILE_EXTENSION    = .xhtml
67
68 OUTPUT_DIRECTORY       = @HTML_OUTPUT_DIR@/doxygen