a2a0a8e0d5
The older install_files command uses a leading slash in front of the destination directory, whereas the modern signature does not. Use the modern signature since that's what the CMake devs are now used to.
159 lines
6.9 KiB
CMake
159 lines
6.9 KiB
CMake
#=============================================================================
|
|
# CMake - Cross Platform Makefile Generator
|
|
# Copyright 2000-2009 Kitware, Inc., Insight Software Consortium
|
|
#
|
|
# Distributed under the OSI-approved BSD License (the "License");
|
|
# see accompanying file Copyright.txt for details.
|
|
#
|
|
# This software is distributed WITHOUT ANY WARRANTY; without even the
|
|
# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
|
# See the License for more information.
|
|
#=============================================================================
|
|
SUBDIRS(Doxygen KWStyle)
|
|
|
|
MAKE_DIRECTORY(${CMake_BINARY_DIR}/Docs)
|
|
|
|
# Add a documentation target.
|
|
SET(DOC_FILES "")
|
|
|
|
SET(MAN_FILES
|
|
${CMake_BINARY_DIR}/Docs/cmake.1
|
|
${CMake_BINARY_DIR}/Docs/cmakecommands.1
|
|
${CMake_BINARY_DIR}/Docs/cmakecompat.1
|
|
${CMake_BINARY_DIR}/Docs/cmakeprops.1
|
|
${CMake_BINARY_DIR}/Docs/cmakepolicies.1
|
|
${CMake_BINARY_DIR}/Docs/cmakevars.1
|
|
${CMake_BINARY_DIR}/Docs/cmakemodules.1
|
|
)
|
|
SET(TEXT_FILES
|
|
${CMake_BINARY_DIR}/Docs/cmake.txt
|
|
${CMake_BINARY_DIR}/Docs/cmake.docbook
|
|
${CMake_BINARY_DIR}/Docs/cmake-policies.txt
|
|
${CMake_BINARY_DIR}/Docs/cmake-properties.txt
|
|
${CMake_BINARY_DIR}/Docs/cmake-variables.txt
|
|
${CMake_BINARY_DIR}/Docs/cmake-modules.txt
|
|
${CMake_BINARY_DIR}/Docs/cmake-commands.txt
|
|
${CMake_BINARY_DIR}/Docs/cmake-compatcommands.txt
|
|
)
|
|
SET(HTML_FILES
|
|
${CMake_BINARY_DIR}/Docs/cmake.html
|
|
${CMake_BINARY_DIR}/Docs/cmake-policies.html
|
|
${CMake_BINARY_DIR}/Docs/cmake-properties.html
|
|
${CMake_BINARY_DIR}/Docs/cmake-variables.html
|
|
${CMake_BINARY_DIR}/Docs/cmake-modules.html
|
|
${CMake_BINARY_DIR}/Docs/cmake-commands.html
|
|
${CMake_BINARY_DIR}/Docs/cmake-compatcommands.html
|
|
)
|
|
|
|
MACRO(ADD_DOCS target dependency)
|
|
# Generate documentation for "ctest" executable.
|
|
GET_TARGET_PROPERTY(CMD ${target} LOCATION)
|
|
# only generate the documentation if the target is actually built
|
|
IF(CMD)
|
|
ADD_CUSTOM_COMMAND(
|
|
OUTPUT ${CMake_BINARY_DIR}/Docs/${target}.txt
|
|
${${target}-PATH} # Possibly set PATH, see below.
|
|
COMMAND ${CMD}
|
|
ARGS --help-full ${CMake_BINARY_DIR}/Docs/${target}.txt
|
|
--help-full ${CMake_BINARY_DIR}/Docs/${target}.html
|
|
--help-full ${CMake_BINARY_DIR}/Docs/${target}.1
|
|
--help-full ${CMake_BINARY_DIR}/Docs/${target}.docbook
|
|
DEPENDS ${target}
|
|
MAIN_DEPENDENCY ${dependency}
|
|
)
|
|
SET(DOC_FILES ${DOC_FILES} ${CMake_BINARY_DIR}/Docs/${target}.txt)
|
|
LIST(APPEND MAN_FILES ${CMake_BINARY_DIR}/Docs/${target}.1)
|
|
LIST(APPEND TEXT_FILES
|
|
${CMake_BINARY_DIR}/Docs/${target}.txt
|
|
${CMake_BINARY_DIR}/Docs/${target}.docbook
|
|
)
|
|
LIST(APPEND HTML_FILES ${CMake_BINARY_DIR}/Docs/${target}.html)
|
|
ENDIF(CMD)
|
|
ENDMACRO(ADD_DOCS target dependency)
|
|
|
|
# Help cmake-gui find the Qt DLLs on Windows.
|
|
SET(WIN_SHELL_GENS "Visual Studio|NMake|MinGW|Watcom|Borland")
|
|
IF(BUILD_QtDialog AND "${CMAKE_GENERATOR}" MATCHES "${WIN_SHELL_GENS}"
|
|
AND EXISTS "${QT_QMAKE_EXECUTABLE}" AND NOT CMAKE_NO_AUTO_QT_ENV)
|
|
GET_FILENAME_COMPONENT(Qt_BIN_DIR "${QT_QMAKE_EXECUTABLE}" PATH)
|
|
IF(EXISTS "${Qt_BIN_DIR}/QtCore4.dll")
|
|
# Tell the macro to set the path before running cmake-gui.
|
|
STRING(REPLACE ";" "\\;" _PATH "PATH=${Qt_BIN_DIR};%PATH%")
|
|
SET(cmake-gui-PATH COMMAND set "${_PATH}")
|
|
ENDIF(EXISTS "${Qt_BIN_DIR}/QtCore4.dll")
|
|
ENDIF(BUILD_QtDialog AND "${CMAKE_GENERATOR}" MATCHES "${WIN_SHELL_GENS}"
|
|
AND EXISTS "${QT_QMAKE_EXECUTABLE}" AND NOT CMAKE_NO_AUTO_QT_ENV)
|
|
|
|
# add the docs for the executables
|
|
ADD_DOCS(ctest ${CMake_SOURCE_DIR}/Utilities/Doxygen/authors.txt)
|
|
ADD_DOCS(cpack ${CMake_SOURCE_DIR}/Utilities/Doxygen/authors.txt)
|
|
ADD_DOCS(ccmake ${CMake_SOURCE_DIR}/Utilities/Doxygen/authors.txt)
|
|
ADD_DOCS(CMakeSetup ${CMake_SOURCE_DIR}/Utilities/Doxygen/doxyfile.in)
|
|
ADD_DOCS(cmake-gui ${CMake_SOURCE_DIR}/Utilities/Doxygen/doxyfile.in)
|
|
|
|
# add the documentation for cmake itself
|
|
|
|
GET_TARGET_PROPERTY(CMD cmake LOCATION)
|
|
ADD_CUSTOM_COMMAND(
|
|
OUTPUT ${CMake_BINARY_DIR}/Docs/cmake.txt
|
|
COMMAND ${CMD}
|
|
ARGS --copyright ${CMake_BINARY_DIR}/Docs/Copyright.txt
|
|
--help-full ${CMake_BINARY_DIR}/Docs/cmake.txt
|
|
--help-full ${CMake_BINARY_DIR}/Docs/cmake.html
|
|
--help-full ${CMake_BINARY_DIR}/Docs/cmake.1
|
|
--help-full ${CMake_BINARY_DIR}/Docs/cmake.docbook
|
|
--help-policies ${CMake_BINARY_DIR}/Docs/cmake-policies.txt
|
|
--help-policies ${CMake_BINARY_DIR}/Docs/cmake-policies.html
|
|
--help-policies ${CMake_BINARY_DIR}/Docs/cmakepolicies.1
|
|
--help-properties ${CMake_BINARY_DIR}/Docs/cmake-properties.txt
|
|
--help-properties ${CMake_BINARY_DIR}/Docs/cmake-properties.html
|
|
--help-properties ${CMake_BINARY_DIR}/Docs/cmakeprops.1
|
|
--help-variables ${CMake_BINARY_DIR}/Docs/cmake-variables.txt
|
|
--help-variables ${CMake_BINARY_DIR}/Docs/cmake-variables.html
|
|
--help-variables ${CMake_BINARY_DIR}/Docs/cmakevars.1
|
|
--help-modules ${CMake_BINARY_DIR}/Docs/cmake-modules.txt
|
|
--help-modules ${CMake_BINARY_DIR}/Docs/cmake-modules.html
|
|
--help-modules ${CMake_BINARY_DIR}/Docs/cmakemodules.1
|
|
--help-commands ${CMake_BINARY_DIR}/Docs/cmake-commands.txt
|
|
--help-commands ${CMake_BINARY_DIR}/Docs/cmake-commands.html
|
|
--help-commands ${CMake_BINARY_DIR}/Docs/cmakecommands.1
|
|
--help-compatcommands ${CMake_BINARY_DIR}/Docs/cmake-compatcommands.txt
|
|
--help-compatcommands ${CMake_BINARY_DIR}/Docs/cmake-compatcommands.html
|
|
--help-compatcommands ${CMake_BINARY_DIR}/Docs/cmakecompat.1
|
|
DEPENDS cmake
|
|
MAIN_DEPENDENCY ${CMake_SOURCE_DIR}/Utilities/Doxygen/authors.txt
|
|
)
|
|
|
|
INSTALL_FILES(${CMAKE_MAN_DIR}/man1 FILES ${MAN_FILES})
|
|
INSTALL_FILES(${CMAKE_DOC_DIR} FILES ${HTML_FILES} ${TEXT_FILES})
|
|
INSTALL(FILES cmake.m4 DESTINATION share/aclocal)
|
|
|
|
# Drive documentation generation.
|
|
ADD_CUSTOM_TARGET(documentation ALL DEPENDS ${DOC_FILES} ${CMake_BINARY_DIR}/Docs/cmake.txt )
|
|
|
|
# Documentation testing.
|
|
if(BUILD_TESTING)
|
|
find_package(LibXml2 QUIET)
|
|
if(NOT DEFINED LIBXML2_XMLLINT_EXECUTABLE)
|
|
find_program(LIBXML2_XMLLINT_EXECUTABLE xmllint)
|
|
endif()
|
|
mark_as_advanced(LIBXML2_XMLLINT_EXECUTABLE)
|
|
if(LIBXML2_XMLLINT_EXECUTABLE)
|
|
execute_process(COMMAND ${LIBXML2_XMLLINT_EXECUTABLE} --help
|
|
OUTPUT_VARIABLE _help ERROR_VARIABLE _err)
|
|
if("${_help}" MATCHES "--path" AND "${_help}" MATCHES "--nonet")
|
|
# We provide the XHTML DTD and its dependencies in the 'xml'
|
|
# directory so that xmllint can run without network access.
|
|
# However, it's --path option accepts a space-separated list of
|
|
# paths so it cannot handle spaces in the path to the source tree.
|
|
# Therefore we run the tool with the current work directory set to
|
|
# the 'xml' directory and use '.' as the path.
|
|
add_test(CMake.HTML
|
|
${CMAKE_CMAKE_COMMAND} -E chdir ${CMAKE_CURRENT_SOURCE_DIR}/xml
|
|
${LIBXML2_XMLLINT_EXECUTABLE} --valid --noout --nonet --path .
|
|
${HTML_FILES}
|
|
)
|
|
endif()
|
|
endif()
|
|
endif()
|