doxygen: doc generation fixed

Doxygen skips undesired directories and files now. In addition, the
documentation of the "fail" namespace has been fixed. Note that there
are still several warnings (due to incomplete documentations) in the
Doxygen output.

Change-Id: Idad4f1ecff453765b307fa40a5c1cebc0c2ce2bb

cmake/Doxyfile.in

@@ -576,7 +576,7 @@ WARN_LOGFILE           =
 # directories like "/usr/src/myproject". Separate the files or directories
 # with spaces.
 
-INPUT                  = @CMAKE_CURRENT_SOURCE_DIR@
+INPUT                  = @FAIL_DOC_SOURCE@
 
 # 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
@@ -605,7 +605,7 @@ RECURSIVE              = YES
 # excluded from the INPUT source files. This way you can easily exclude a
 # subdirectory from a directory tree whose root is specified with the INPUT tag.
 
-EXCLUDE                = @FAIL_DOC_EXCLUDE@
+EXCLUDE                =
 
 # The EXCLUDE_SYMLINKS tag can be used select whether or not files or
 # directories that are symbolic links (a Unix filesystem feature) are excluded
@@ -619,7 +619,7 @@ EXCLUDE_SYMLINKS       = NO
 # against the file with absolute path, so to exclude all test directories
 # for example use the pattern */test/*
 
-EXCLUDE_PATTERNS       =
+EXCLUDE_PATTERNS       = @FAIL_DOC_EXCLUDE_PATTERNS@
 
 # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
 # (namespaces, classes, functions, etc.) that should be excluded from the

cmake/doxygen.cmake

@@ -6,20 +6,28 @@ if(DOXYGEN_FOUND)
 # into the doxyfile.  For example, CMake will replace @PROJECT_NAME@ in
 # a configured file with the CMake PROJECT_NAME variable's value.
 
-set(FAIL_DOC_OUTPUT "${PROJECT_BINARY_DIR}/doc")
-set(FAIL_DOC_EXCLUDE  "${PROJECT_SOURCE_DIR}/simulators ${PROJECT_SOURCE_DIR}/build ${PROJECT_SOURCE_DIR}/src/core/util/pstream.h")
+set(FAIL_DOC_OUTPUT  "${PROJECT_BINARY_DIR}/doc")
+execute_process(COMMAND find "${PROJECT_SOURCE_DIR}/src/core/" -type d -printf "%p "
+                OUTPUT_VARIABLE FAIL_DOC_SOURCE)
+set(FAIL_DOC_EXCLUDE_PATTERNS "*/util/pstream.h */util/optionparser/optionparser.h")
 file(MAKE_DIRECTORY ${FAIL_DOC_OUTPUT})
+# FIXME: The find command does not quote the paths to be processed by doxygen. That
+#        means, the path to your Fail* directory should not contain any blanks.
 
 configure_file(${PROJECT_SOURCE_DIR}/cmake/Doxyfile.in
 		${PROJECT_BINARY_DIR}/Doxyfile @ONLY}
 )
 
 ## call make doc to generate documentation
+set(line0 "[${PROJECT_NAME}] Generating Fail* documentation with Doxygen")
+set(line1 "       Directories: ${FAIL_DOC_SOURCE}")
+set(line2 "       Excluded patterns: ${FAIL_DOC_EXCLUDE_PATTERNS}")
 add_custom_target(doc
 		${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
 		DEPENDS ${PROJECT_BINARY_DIR}/Doxyfile
 		WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
-		COMMENT "[${PROJECT_NAME}] Generating Fail* documentation with Doxygen" VERBATIM
+		COMMENT "${line0}\n${line1}\n${line2}" VERBATIM
 )
+
 endif(DOXYGEN_FOUND)
 

cmake/gem5.cmake

@@ -40,7 +40,7 @@ if(BUILD_GEM5)
   add_custom_target(gem5-allclean
     COMMAND @echo "Cleaning Fail* and gem5 ..."
     COMMAND cd "${PROJECT_BINARY_DIR}/" && make clean
-    COMMAND cd "${gem5_src_dir}/" && scons -c
+    COMMAND cd "${gem5_src_dir}/" && scons -c build/ARM
   )
 
   # Build "fail" library first (will be statically linked to gem5)