Blame docs/CMakeLists.txt

Packit Service 569379
if(ENABLE_DOCS)
Packit Service 569379
    add_custom_target(docs ALL
Packit Service 569379
        COMMENT "Generating documentation and manuals in HTML format"
Packit Service 569379
    )
Packit Service 569379
Packit Service 569379
    if(DOXYGEN_FOUND)
Packit Service 569379
        # set input and output files
Packit Service 569379
        set(DOXYGEN_IN ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in)
Packit Service 569379
        set(DOXYGEN_OUT ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
Packit Service 569379
Packit Service 569379
        # request to configure the file
Packit Service 569379
        configure_file(${DOXYGEN_IN} ${DOXYGEN_OUT} @ONLY)
Packit Service 569379
Packit Service 569379
        # note the option ALL which allows to build the docs together with the application
Packit Service 569379
        add_custom_command(
Packit Service 569379
            OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/html"
Packit Service 569379
            DEPENDS ${DOXYGEN_OUT}
Packit Service 569379
            COMMAND "${DOXYGEN_EXECUTABLE}" "${DOXYGEN_OUT}"
Packit Service 569379
            WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}"
Packit Service 569379
            COMMENT "Generating API documentation with Doxygen"
Packit Service 569379
        )
Packit Service 569379
        add_custom_target(
Packit Service 569379
            doxygen_docs
Packit Service 569379
            DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/html"
Packit Service 569379
        )
Packit Service 569379
        add_dependencies(docs doxygen_docs)
Packit Service 569379
        install(DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/html"
Packit Service 569379
            DESTINATION "${CMAKE_INSTALL_DOCDIR}"
Packit Service 569379
        )
Packit Service 569379
    endif()
Packit Service 569379
Packit Service 569379
    if(ASCIIDOC_EXECUTABLE)
Packit Service 569379
        add_custom_command(
Packit Service 569379
            OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/manual/manual.html"
Packit Service 569379
            DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/manual/manual.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/manual/images"
Packit Service 569379
            COMMAND ${CMAKE_COMMAND} -E make_directory "${CMAKE_CURRENT_BINARY_DIR}/manual"
Packit Service 569379
            COMMAND "${ASCIIDOC_EXECUTABLE}" -b html5 -o "${CMAKE_CURRENT_BINARY_DIR}/manual/manual.html" "${CMAKE_CURRENT_SOURCE_DIR}/manual/manual.adoc"
Packit Service 569379
            COMMAND ${CMAKE_COMMAND} -E copy_directory "${CMAKE_CURRENT_SOURCE_DIR}/manual/images" "${CMAKE_CURRENT_BINARY_DIR}/manual/images"
Packit Service 569379
            COMMENT "Generating OpenSCAP User Manual in HTML format"
Packit Service 569379
        )
Packit Service 569379
        add_custom_target(
Packit Service 569379
            user_manual
Packit Service 569379
            DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/manual/manual.html"
Packit Service 569379
        )
Packit Service 569379
        install(DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}/manual"
Packit Service 569379
            DESTINATION "${CMAKE_INSTALL_DOCDIR}"
Packit Service 569379
        )
Packit Service 569379
Packit Service 569379
        add_custom_command(
Packit Service 569379
            OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/developer/developer.html"
Packit Service 569379
            DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/developer/developer.adoc"
Packit Service 569379
            COMMAND ${CMAKE_COMMAND} -E make_directory "${CMAKE_CURRENT_BINARY_DIR}/developer"
Packit Service 569379
            COMMAND "${ASCIIDOC_EXECUTABLE}" -b html5 -o "${CMAKE_CURRENT_BINARY_DIR}/developer/developer.html" "${CMAKE_CURRENT_SOURCE_DIR}/developer/developer.adoc"
Packit Service 569379
            COMMENT "Generating OpenSCAP Developer Manual in HTML format"
Packit Service 569379
        )
Packit Service 569379
        add_custom_target(
Packit Service 569379
            developer_manual
Packit Service 569379
            DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/developer/developer.html"
Packit Service 569379
        )
Packit Service 569379
        # We are not installing the OpenSCAP Developer manual because it does not
Packit Service 569379
        # make any sense to install this for end-users.
Packit Service 569379
Packit Service 569379
        add_custom_command(
Packit Service 569379
            OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/contribute/contribute.html" "${CMAKE_CURRENT_BINARY_DIR}/contribute/testing.html" "${CMAKE_CURRENT_BINARY_DIR}/contribute/versioning.html"
Packit Service 569379
            DEPENDS "${CMAKE_CURRENT_SOURCE_DIR}/contribute/contribute.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/contribute/testing.adoc" "${CMAKE_CURRENT_SOURCE_DIR}/contribute/versioning.adoc"
Packit Service 569379
            COMMAND ${CMAKE_COMMAND} -E make_directory "${CMAKE_CURRENT_BINARY_DIR}/contribute"
Packit Service 569379
            COMMAND "${ASCIIDOC_EXECUTABLE}" -b html5 -o "${CMAKE_CURRENT_BINARY_DIR}/contribute/contribute.html" "${CMAKE_CURRENT_SOURCE_DIR}/contribute/contribute.adoc"
Packit Service 569379
            COMMAND "${ASCIIDOC_EXECUTABLE}" -b html5 -o "${CMAKE_CURRENT_BINARY_DIR}/contribute/testing.html" "${CMAKE_CURRENT_SOURCE_DIR}/contribute/testing.adoc"
Packit Service 569379
            COMMAND "${ASCIIDOC_EXECUTABLE}" -b html5 -o "${CMAKE_CURRENT_BINARY_DIR}/contribute/versioning.html" "${CMAKE_CURRENT_SOURCE_DIR}/contribute/versioning.adoc"
Packit Service 569379
            COMMENT "Generating contribute documentation in HTML format"
Packit Service 569379
        )
Packit Service 569379
        add_custom_target(
Packit Service 569379
            contribute_docs
Packit Service 569379
            DEPENDS "${CMAKE_CURRENT_BINARY_DIR}/contribute/contribute.html" "${CMAKE_CURRENT_BINARY_DIR}/contribute/testing.html" "${CMAKE_CURRENT_BINARY_DIR}/contribute/versioning.html"
Packit Service 569379
        )
Packit Service 569379
        # We are not installing the contribute documentation because it does not
Packit Service 569379
        # make any sense to install this for end-users.
Packit Service 569379
Packit Service 569379
        add_dependencies(docs user_manual developer_manual contribute_docs)
Packit Service 569379
    endif()
Packit Service 569379
endif()