1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86
|
#
# Build the documentation
#
find_package(Doxygen REQUIRED)
find_package(Perl REQUIRED)
find_package(HTMLHelp)
option(DOXYGEN_SHORT_NAMES "Build Doxygen of VTK using short file names" OFF)
option(DOXYGEN_KEEP_TEMP "Do not delete the temporary Doxygen headers" OFF)
option(DOXYGEN_GENERATE_HTMLHELP "Generate HTML help (CHM) files" ON)
mark_as_advanced(DOXYGEN_SHORT_NAMES DOXYGEN_KEEP_TEMP DOXYGEN_GENERATE_HTMLHELP)
if(DOXYGEN_SHORT_NAMES)
set(DOXYGEN_SHORT_NAMES YES)
else()
set(DOXYGEN_SHORT_NAMES NO)
endif()
if(DOXYGEN_GENERATE_HTMLHELP)
set(DOXYGEN_GENERATE_HTMLHELP YES)
else()
set(DOXYGEN_GENERATE_HTMLHELP NO)
endif()
#
# Configure the script and the doxyfile, then add target
#
set(HAVE_DOT_YESNO NO)
if(DOT)
set(HAVE_DOT_YESNO YES)
if(NOT DOT_PATH)
get_filename_component(DOT_PATH ${DOT} PATH)
endif()
endif()
# Build up a list of all module source directories. Note that this should be
# all source directories and so does not use the normal variables.
set(VTK_MODULE_DIRS_DOXYGEN "")
foreach(module IN LISTS vtk_module_files)
file(RELATIVE_PATH module_dir "${VTK_SOURCE_DIR}" "${module}")
get_filename_component(module_BASE ${module_dir} PATH)
if(module_BASE MATCHES "^Utilities" OR module_BASE MATCHES "^ThirdParty")
# Skip the utilities and third parties directories.
continue()
endif ()
# Use both the source and binary directories, this ensures that
# generated files will be included, but they may then be architecture,
# build configuration and/or compiler specific. All source directories
# are included whether the module is enabled or not.
string(APPEND VTK_MODULE_DIRS_DOXYGEN
"\"${VTK_SOURCE_DIR}/${module_BASE}\"
\"${VTK_BINARY_DIR}/${module_BASE}\"
")
endforeach()
configure_file(
${VTK_SOURCE_DIR}/Utilities/Doxygen/doxyfile.in
${VTK_BINARY_DIR}/Utilities/Doxygen/doxyfile)
configure_file(
${VTK_SOURCE_DIR}/Utilities/Doxygen/doc_makeall.cmake.in
${VTK_BINARY_DIR}/Utilities/Doxygen/doc_makeall.cmake
@ONLY)
add_custom_target(DoxygenDoc
${CMAKE_COMMAND}
-P ${VTK_BINARY_DIR}/Utilities/Doxygen/doc_makeall.cmake
DEPENDS ${VTK_BINARY_DIR}/Utilities/Doxygen/doc_makeall.cmake)
if(NOT VTK_INSTALL_NO_DOCUMENTATION)
macro(__vtk_install_documentation_files glob)
file(GLOB __files "${CMAKE_CURRENT_SOURCE_DIR}/${glob}")
install(FILES ${__files}
DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/doc/vtk${vtk_version_suffix}/doxygen"
COMPONENT doxygen)
endmacro()
__vtk_install_documentation_files("*.css")
__vtk_install_documentation_files("*.gif")
__vtk_install_documentation_files("*.html")
__vtk_install_documentation_files("*.pl")
__vtk_install_documentation_files("*.stop")
install(FILES doc_readme.txt
DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/doc/vtk${vtk_version_suffix}/doxygen"
COMPONENT doxygen)
install(DIRECTORY ${VTK_BINARY_DIR}/Utilities/Doxygen/doc/html
DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/doc/vtk${vtk_version_suffix}/doxygen"
COMPONENT doxygen)
endif()
|