buildtools/Cmake/GenerateDevGuide.cmake

   1 #### Generate the html documentation
   2
   3 if(DOXYGEN_PATH)
   4
   5   configure_file(${CMAKE_HOME_DIRECTORY}/doc/dev_guide/doxygen/DevGuideDoxyfile.in ${CMAKE_HOME_DIRECTORY}/doc/dev_guide/doxygen/DevGuideDoxyfile @ONLY)
   6
   7   ADD_CUSTOM_TARGET(dev_guide
   8     COMMENT "Generating the SimGrid dev guide..."
   9     DEPENDS ${DEV_GUIDE_SOURCES}
  10     COMMAND ${CMAKE_COMMAND} -E remove_directory ${CMAKE_HOME_DIRECTORY}/doc/dev_guide/html
  11     COMMAND ${CMAKE_COMMAND} -E make_directory   ${CMAKE_HOME_DIRECTORY}/doc/dev_guide/html
  12     COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_HOME_DIRECTORY}/doc/simgrid.css ${CMAKE_HOME_DIRECTORY}/doc/dev_guide/html/
  13     WORKING_DIRECTORY ${CMAKE_HOME_DIRECTORY}/doc/dev_guide/
  14     )
  15
  16   ADD_CUSTOM_COMMAND(TARGET dev_guide
  17     COMMAND ${CMAKE_COMMAND} -E echo "XX First Doxygen pass"
  18     COMMAND ${DOXYGEN_PATH}/doxygen DevGuideDoxyfile
  19     COMMAND ${CMAKE_HOME_DIRECTORY}/tools/doxygen/index_create.pl ../../shared/doxygen/simgriddevguide.tag index-API.doc
  20
  21     COMMAND ${CMAKE_COMMAND} -E echo "XX Second Doxygen pass"
  22     COMMAND ${DOXYGEN_PATH}/doxygen DevGuideDoxyfile
  23
  24     COMMAND ${CMAKE_COMMAND} -E remove -f ${CMAKE_HOME_DIRECTORY}/doc/dev_guide/html/dir*
  25
  26     WORKING_DIRECTORY ${CMAKE_HOME_DIRECTORY}/doc/dev_guide/doxygen
  27     )
  28
  29 else(DOXYGEN_PATH)
  30
  31   ADD_CUSTOM_TARGET(dev_guide
  32     COMMENT "Generating the SimGrid documentation..."
  33     )
  34
  35   ADD_CUSTOM_COMMAND(TARGET dev_guide
  36     COMMAND ${CMAKE_COMMAND} -E echo "DOXYGEN_PATH     = ${DOXYGEN_PATH}"
  37     COMMAND ${CMAKE_COMMAND} -E echo "IN ORDER TO GENERATE THE DOCUMENTATION YOU NEED ALL TOOLS !!!"
  38     COMMAND ${CMAKE_COMMAND} -E echo "FAIL TO MAKE SIMGRID DOCUMENTATION see previous messages for details ..."
  39     COMMAND false
  40     )
  41
  42 endif(DOXYGEN_PATH)
  43
  44 ##############################################################################"