BUGFIX: CMake documentation generation bugfix

- Products of the custom command to generate documentation were not properly listed
- Now, make clean will clean the documentation directory without use of `set_directory_properties()`
- ROBODoc outputs dynamically computed at CMake configuration time. Fixes #17
- Change in ROBODoc Headers or new source files will no longers require manual update of the outputs

Author: zbeekman

CMakeLists.txt

@@ -119,18 +119,23 @@ if ( NOT ROBODOC_SKIP_DOC_GEN )
       --src "${CMAKE_SOURCE_DIR}/src" --doc "${DOC_DIR}"
       --multidoc --html --ignore_case_when_linking
       --documenttitle "${CMAKE_PROJECT_NAME}" )
-    set ( ROBODOC_OUPUTS json_example_f90.html masterindex.html robo_functions.html robo_sourcefiles.html
-      toc_index.html json_module_f90.html robo_classes.html robo_modules.html robodoc.css )
-    foreach ( ARG ${ROBODOC_OUPUTS} )
-      set ( ROBO_OUTPUTS "${DOC_DIR}/${ARG}" )
-    endforeach ( ARG ${ROBODOC_OUPUTS} )
-    add_custom_command ( OUTPUT ${ROBO_OUTPUTS}
+    # Dynamically generate the ROBODoc outputs list
+    message ( STATUS "Dynamically computing ROBODoc output information..." )
+    execute_process ( COMMAND ${CMAKE_COMMAND} -E remove_directory ${DOC_DIR} 
+      COMMAND ${CMAKE_COMMAND} -E make_directory ${DOC_DIR}
+      COMMAND "${ROBODOC}" ${REQUIRED_ROBODOC_OPTIONS} ${ROBODOC_OPTIONS} )
+    file ( GLOB_RECURSE ROBODOC_OUTPUTS
+      "${DOC_DIR}/*" )
+    execute_process ( COMMAND ${CMAKE_COMMAND} -E remove_directory ${DOC_DIR} )
+    message ( STATUS "Done dynamically computing ROBODoc outputs." )
+
+    add_custom_command ( OUTPUT ${ROBODOC_OUTPUTS}
       COMMAND "${CMAKE_COMMAND}" -E make_directory "${DOC_DIR}" # Ensure DOC_DIR exists at build time
       COMMAND "${ROBODOC}" ${REQUIRED_ROBODOC_OPTIONS} ${ROBODOC_OPTIONS}
       DEPENDS "${CMAKE_SOURCE_DIR}/${JF_LIB_SRCS}"
       COMMENT "Building HTML documentation for ${CMAKE_PROJECT_NAME} using ROBODoc" )
     add_custom_target ( documentation ALL
-      DEPENDS ${ROBO_OUTPUTS} )
+      DEPENDS ${ROBODOC_OUTPUTS} )
   else ( ROBODOC ) # Not found
     message ( WARNING
       "ROBODoc not found! Please set the CMake cache variable ROBODOC to point to the installed ROBODoc binary, and reconfigure or disable building the documentation. ROBODoc can be installed from: http://www.xs4all.nl/~rfsber/Robo/ If you do not wish to install ROBODoc and build the json-fortran documentation, then please set the CMake cache variable SKIP_DOCUMENTATION_GENERATION to FALSE." )