Include the whole src directory in apidoc and make source files browsable
authorTobias Brunner <tobias@strongswan.org>
Sat, 2 Mar 2013 13:58:33 +0000 (14:58 +0100)
committerTobias Brunner <tobias@strongswan.org>
Sat, 2 Mar 2013 17:31:53 +0000 (18:31 +0100)
But still only scan header files as Doxygen can't figure out how they
are related to source files (at least not for class methods).

Doxyfile.in

index 9a44df8..ac0a96c 100644 (file)
@@ -557,7 +557,7 @@ SHOW_USED_FILES        = NO
 # This will remove the Files entry from the Quick Index and from the
 # Folder Tree View (if specified). The default is YES.
 
-SHOW_FILES             = NO
+SHOW_FILES             = YES
 
 # Set the SHOW_NAMESPACES tag to NO to disable the generation of the
 # Namespaces page.
@@ -629,7 +629,7 @@ WARN_IF_DOC_ERROR      = YES
 # wrong or incomplete parameter documentation, but not about the absence of
 # documentation.
 
-WARN_NO_PARAMDOC       = NO
+WARN_NO_PARAMDOC       = YES
 
 # The WARN_FORMAT tag determines the format of the warning messages that
 # doxygen can produce. The string should contain the $file, $line, and $text
@@ -655,17 +655,7 @@ WARN_LOGFILE           =
 # directories like "/usr/src/myproject". Separate the files or directories
 # with spaces.
 
-INPUT                  = @SRC_DIR@/src/libstrongswan \
-                         @SRC_DIR@/src/libhydra \
-                         @SRC_DIR@/src/libcharon \
-                         @SRC_DIR@/src/libipsec \
-                         @SRC_DIR@/src/libsimaka \
-                         @SRC_DIR@/src/libtls \
-                         @SRC_DIR@/src/libradius \
-                         @SRC_DIR@/src/libtnccs \
-                         @SRC_DIR@/src/libtncif \
-                         @SRC_DIR@/src/libfast \
-                         @SRC_DIR@/src/manager
+INPUT                  = @SRC_DIR@/src/
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding, which is
@@ -697,13 +687,13 @@ RECURSIVE              = YES
 # Note that relative paths are relative to the directory from which doxygen is
 # run.
 
-EXCLUDE                =
+EXCLUDE                = @SRC_DIR@/src/include
 
 # The EXCLUDE_SYMLINKS tag can be used to select whether or not files or
 # directories that are symbolic links (a Unix file system feature) are excluded
 # from the input.
 
-EXCLUDE_SYMLINKS       = NO
+EXCLUDE_SYMLINKS       = YES
 
 # If the value of the INPUT tag contains directories, you can use the
 # EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude
@@ -792,7 +782,7 @@ FILTER_SOURCE_PATTERNS =
 # Note: To get rid of all source code in the generated output, make sure also
 # VERBATIM_HEADERS is set to NO.
 
-SOURCE_BROWSER         = NO
+SOURCE_BROWSER         = YES
 
 # Setting the INLINE_SOURCES tag to YES will include the body
 # of functions and classes directly in the documentation.
@@ -955,7 +945,7 @@ HTML_TIMESTAMP         = YES
 # documentation will contain sections that can be hidden and shown after the
 # page has loaded.
 
-HTML_DYNAMIC_SECTIONS  = NO
+HTML_DYNAMIC_SECTIONS  = YES
 
 # With HTML_INDEX_NUM_ENTRIES one can control the preferred number of
 # entries shown in the various tree structured indices initially; the user