X-Git-Url: https://git.m6w6.name/?a=blobdiff_plain;f=docs%2FCMakeLists.txt;h=c2d6325ab75a0e7a57460de651184058be6c99aa;hb=e4dc06e9f89a6aa678e2973898ae75faa80bc0c2;hp=07709dd07b69a117bf0ccf234af0f747bbe437b2;hpb=c97065e8f496be4d36ffe020fba19c6be4c2a04e;p=awesomized%2Flibmemcached diff --git a/docs/CMakeLists.txt b/docs/CMakeLists.txt index 07709dd0..c2d6325a 100644 --- a/docs/CMakeLists.txt +++ b/docs/CMakeLists.txt @@ -2,7 +2,7 @@ find_package(Sphinx) if(NOT SPHINX_EXECUTABLE) - message(WARNING "The sphinx-build command is required to build manpages.") + message(WARNING "The sphinx-build command is required to build documentation.") else() @@ -29,55 +29,83 @@ else() # MAN output directory set(SPHINX_MAN_DIR "${SPHINX_BUILD_DIR}/man") - configure_file( - "${SPHINX_SOURCE_DIR}/conf.py.in" - "${SPHINX_BUILD_DIR}/conf.py" - @ONLY) - - add_custom_target(html - ${SPHINX_EXECUTABLE} - -q -b html - -c "${SPHINX_BUILD_DIR}" - -d "${SPHINX_CACHE_DIR}" - ${SPHINX_OPTIONS} - "${SPHINX_SOURCE_DIR}" - "${SPHINX_HTML_DIR}" - BYPRODUCTS ${SPHINX_HTML_DIR} - ) - add_custom_target(man ALL - ${SPHINX_EXECUTABLE} - -q -b man - -c "${SPHINX_BUILD_DIR}" - -d "${SPHINX_CACHE_DIR}" - ${SPHINX_OPTIONS} - "${SPHINX_SOURCE_DIR}" - "${SPHINX_MAN_DIR}" - BYPRODUCTS ${SPHINX_MAN_DIR} - ) - - set(MAN_EXT "") - if(GZIP_MAN) - find_program(PIGZ pigz) - if(PIGZ) - set(GZIP ${PIGZ}) - else() - find_package(UnixCommands) - endif() - if(GZIP) - set(MAN_EXT ".gz") - add_custom_target(man_gz ALL - ${GZIP} -rkf ${SPHINX_MAN_DIR} - DEPENDS man - ) + configure_file("conf.py.in" "conf.py" @ONLY) + add_subdirectory(source) + + file(GLOB_RECURSE DOCS_SOURCE + CONFIGURE_DEPENDS + "*.rst") + + if(BUILD_DOCS_HTML) + add_custom_command( + OUTPUT "${SPHINX_HTML_DIR}" + COMMAND + ${SPHINX_EXECUTABLE} + -q -b html + -c "${SPHINX_BUILD_DIR}" + -d "${SPHINX_CACHE_DIR}" + ${SPHINX_OPTIONS} + "${SPHINX_SOURCE_DIR}" + "${SPHINX_HTML_DIR}" + COMMAND + ${CMAKE_COMMAND} -E touch "${SPHINX_HTML_DIR}" + BYPRODUCTS ${SPHINX_HTML_DIR} + DEPENDS "${DOCS_SOURCE}" + ) + add_custom_target(html ALL DEPENDS "${SPHINX_HTML_DIR}") + + install(DIRECTORY ${SPHINX_HTML_DIR}/ + COMPONENT doc + DESTINATION ${CMAKE_INSTALL_DOCDIR}/html) + endif() + + if(BUILD_DOCS_MAN) + add_custom_command( + OUTPUT ${SPHINX_MAN_DIR} + COMMAND + ${SPHINX_EXECUTABLE} + -q -b man + -c "${SPHINX_BUILD_DIR}" + -d "${SPHINX_CACHE_DIR}" + ${SPHINX_OPTIONS} + "${SPHINX_SOURCE_DIR}" + "${SPHINX_MAN_DIR}" + COMMAND + ${CMAKE_COMMAND} -E touch "${SPHINX_MAN_DIR}" + BYPRODUCTS ${SPHINX_MAN_DIR} + DEPENDS "${DOCS_SOURCE}" + ) + add_custom_target(man ALL DEPENDS "${SPHINX_MAN_DIR}") + + set(MAN_EXT "") + if(BUILD_DOCS_MANGZ) + find_program(PIGZ pigz) + if(PIGZ) + set(GZIP ${PIGZ}) + else() + find_package(UnixCommands) + endif() + if(GZIP) + set(MAN_EXT ".gz") + add_custom_target(man_gz ALL + COMMAND ${GZIP} -kf + ${SPHINX_MAN_DIR}/*.1 + ${SPHINX_MAN_DIR}/*.3 + DEPENDS ${SPHINX_MAN_DIR} + ) # some shells do not support braced glob patterns + endif() endif() + + install(DIRECTORY ${SPHINX_MAN_DIR}/ + COMPONENT doc + DESTINATION ${CMAKE_INSTALL_MANDIR}/man1 + FILES_MATCHING PATTERN *.1${MAN_EXT} + ) + install(DIRECTORY ${SPHINX_MAN_DIR}/ + COMPONENT doc + DESTINATION ${CMAKE_INSTALL_MANDIR}/man3 + FILES_MATCHING PATTERN *.3${MAN_EXT} + ) endif() - install(DIRECTORY ${SPHINX_MAN_DIR}/ - DESTINATION ${CMAKE_INSTALL_MANDIR}/man1 - FILES_MATCHING PATTERN *.1${MAN_EXT} - ) - install(DIRECTORY ${SPHINX_MAN_DIR}/ - DESTINATION ${CMAKE_INSTALL_MANDIR}/man3 - FILES_MATCHING PATTERN *.3${MAN_EXT} - ) endif()