60 lines
2.4 KiB
CMake
60 lines
2.4 KiB
CMake
# repurposed from libnoise: http://github.com/qknight/libnoise/tree/master/doc/
|
|
# following code and comments is by the original author, with some changes by
|
|
# me (peterix)
|
|
# ------------------------------------------------------------------------------
|
|
#
|
|
# many thanks go to Philippe Poilbarbe for writing the code this file is based on
|
|
# http://www.cmake.org/pipermail/cmake/2006-August/010794.html
|
|
#
|
|
# much later i also found this:
|
|
# http://tobias.rautenkranz.ch/cmake/doxygen/
|
|
# but it is hard to understand...
|
|
|
|
FIND_PACKAGE(Doxygen QUIET)
|
|
|
|
IF(DOXYGEN_FOUND)
|
|
SET(DOXYGEN_LANGUAGE "English" CACHE STRING "Language used by doxygen")
|
|
MARK_AS_ADVANCED(DOXYGEN_LANGUAGE)
|
|
|
|
# you could also set the version with this, see Doxygen.in
|
|
# there you will find a line like this:
|
|
# PROJECT_NUMBER = @DFHACK_VERSION@
|
|
# @DFHACK_VERSION@ is then replaced by our global DFHACK_VERSION
|
|
#
|
|
# for instance you could uncomment the next 3 lines and change the version for testing
|
|
# SET(DFHACK_VERSION
|
|
# "1.2.3-foo500"
|
|
# )
|
|
|
|
# doxygen can reference external images with IMAGE_PATH, this is how we set it dynamically
|
|
SET( CMAKE_DOXYGEN_IMAGE_PATH
|
|
"${CMAKE_CURRENT_SOURCE_DIR}/img"
|
|
)
|
|
|
|
# doxygen searches for source code (defined in FILE_PATTERNS, for example: *.cpp *.h)
|
|
# with DOXYGEN_SOURCE_DIR we fill a list of directories and later we write it into
|
|
# the Doxyfile with a REGEX REPLACE (see below)
|
|
SET( DOXYGEN_SOURCE_DIR
|
|
"${dfhack_SOURCE_DIR}/doc/index.dxgen"
|
|
"${dfhack_SOURCE_DIR}/library/include"
|
|
"${dfhack_SOURCE_DIR}/library/include/dfhack"
|
|
"${dfhack_SOURCE_DIR}/library/include/dfhack/modules"
|
|
"${dfhack_SOURCE_DIR}/library/include/dfhack-c"
|
|
"${dfhack_SOURCE_DIR}/library/include/dfhack-c/modules"
|
|
)
|
|
|
|
STRING(REGEX REPLACE ";" " " CMAKE_DOXYGEN_INPUT_LIST "${DOXYGEN_SOURCE_DIR}")
|
|
set(DOXYFILE_DOT "NO")
|
|
if(DOXYGEN_DOT_EXECUTABLE)
|
|
set(DOXYFILE_DOT "YES")
|
|
endif()
|
|
CONFIGURE_FILE(Doxyfile.in ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
|
|
ADD_CUSTOM_TARGET(doxygen ALL
|
|
${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
|
|
DEPENDS ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
|
|
|
|
INSTALL( DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/html/" DESTINATION ${DFHACK_DOXYGEN_DESTINATION} )
|
|
INSTALL( FILES "Doxygen.html" DESTINATION ${DFHACK_DEVDOC_DESTINATION})
|
|
ELSE(DOXYGEN_FOUND)
|
|
MESSAGE (WARNING "Doxygen binary couldn't be found. Can't build development documentation.'")
|
|
ENDIF(DOXYGEN_FOUND) |