|
Packit |
534379 |
## Copyright(c) 2017-2020, Intel Corporation
|
|
Packit |
534379 |
##
|
|
Packit |
534379 |
## Redistribution and use in source and binary forms, with or without
|
|
Packit |
534379 |
## modification, are permitted provided that the following conditions are met:
|
|
Packit |
534379 |
##
|
|
Packit |
534379 |
## * Redistributions of source code must retain the above copyright notice,
|
|
Packit |
534379 |
## this list of conditions and the following disclaimer.
|
|
Packit |
534379 |
## * Redistributions in binary form must reproduce the above copyright notice,
|
|
Packit |
534379 |
## this list of conditions and the following disclaimer in the documentation
|
|
Packit |
534379 |
## and/or other materials provided with the distribution.
|
|
Packit |
534379 |
## * Neither the name of Intel Corporation nor the names of its contributors
|
|
Packit |
534379 |
## may be used to endorse or promote products derived from this software
|
|
Packit |
534379 |
## without specific prior written permission.
|
|
Packit |
534379 |
##
|
|
Packit |
534379 |
## THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
Packit |
534379 |
## AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
Packit |
534379 |
## IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
Packit |
534379 |
## ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
|
|
Packit |
534379 |
## LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
|
Packit |
534379 |
## CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
|
Packit |
534379 |
## SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
Packit |
534379 |
## INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
|
Packit |
534379 |
## CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
Packit |
534379 |
## ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
|
Packit |
534379 |
## POSSIBILITY OF SUCH DAMAGE.
|
|
Packit |
534379 |
|
|
Packit |
534379 |
project(sphinx)
|
|
Packit |
534379 |
|
|
Packit |
534379 |
# configured documentation tools and intermediate build results
|
|
Packit |
534379 |
set(BINARY_BUILD_DIR "${CMAKE_BINARY_DIR}/sphinx/_build")
|
|
Packit |
534379 |
|
|
Packit |
534379 |
# Sphinx cache with pickled ReST documents
|
|
Packit |
534379 |
set(SPHINX_CACHE_DIR "${CMAKE_BINARY_DIR}/sphinx/_doctrees")
|
|
Packit |
534379 |
|
|
Packit |
534379 |
# Documentation number
|
|
Packit |
534379 |
if(HASH_ARCHIVES)
|
|
Packit |
534379 |
set(SPHINX_DOC_RELEASE "${OPAE_VERSION}.${OPAE_GIT_COMMIT_HASH}")
|
|
Packit |
534379 |
else()
|
|
Packit |
534379 |
set(SPHINX_DOC_RELEASE "${OPAE_VERSION}")
|
|
Packit |
534379 |
endif()
|
|
Packit |
534379 |
|
|
Packit |
534379 |
# HTML output directory
|
|
Packit |
534379 |
set(SPHINX_HTML_DIR "${CMAKE_BINARY_DIR}/sphinx/html/${SPHINX_DOC_RELEASE}")
|
|
Packit |
534379 |
|
|
Packit |
534379 |
# MAN output directory
|
|
Packit |
534379 |
set(SPHINX_MAN_DIR "${CMAKE_BINARY_DIR}/sphinx/man/${SPHINX_DOC_RELEASE}")
|
|
Packit |
534379 |
|
|
Packit |
534379 |
configure_file(
|
|
Packit |
534379 |
"${CMAKE_CURRENT_SOURCE_DIR}/conf.py.in"
|
|
Packit |
534379 |
"${BINARY_BUILD_DIR}/conf.py"
|
|
Packit |
534379 |
@ONLY)
|
|
Packit |
534379 |
|
|
Packit |
534379 |
configure_file(
|
|
Packit |
534379 |
"${CMAKE_CURRENT_SOURCE_DIR}/index.rst.in"
|
|
Packit |
534379 |
"${BINARY_BUILD_DIR}/index.rst"
|
|
Packit |
534379 |
@ONLY)
|
|
Packit |
534379 |
|
|
Packit |
534379 |
add_custom_target(copy-doxygen-files ALL
|
|
Packit |
534379 |
COMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_BINARY_DIR}/doc/xml ${BINARY_BUILD_DIR}/doxygen_xml
|
|
Packit |
534379 |
DEPENDS doxygen)
|
|
Packit |
534379 |
|
|
Packit |
534379 |
add_custom_target(copy-markdown-files ALL
|
|
Packit |
534379 |
COMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_SOURCE_DIR}/doc/src ${BINARY_BUILD_DIR}/docs)
|
|
Packit |
534379 |
|
|
Packit |
534379 |
add_custom_target(copy-include-files ALL
|
|
Packit |
534379 |
COMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_SOURCE_DIR}/opae-libs/include ${BINARY_BUILD_DIR}/docs/fpga_api/include
|
|
Packit |
534379 |
DEPENDS copy-markdown-files)
|
|
Packit |
534379 |
|
|
Packit |
534379 |
add_custom_target(copy-sample-files ALL
|
|
Packit |
534379 |
COMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_SOURCE_DIR}/samples ${BINARY_BUILD_DIR}/docs/fpga_api/samples
|
|
Packit |
534379 |
DEPENDS copy-include-files)
|
|
Packit |
534379 |
|
|
Packit |
534379 |
add_custom_target(copy-python-files ALL
|
|
Packit |
534379 |
COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_SOURCE_DIR}/opae-libs/pyopae/README.md ${BINARY_BUILD_DIR}/docs/README.md
|
|
Packit |
534379 |
DEPENDS copy-markdown-files)
|
|
Packit |
534379 |
|
|
Packit |
534379 |
|
|
Packit |
534379 |
add_custom_target(docs ALL
|
|
Packit |
534379 |
COMMAND ${CMAKE_COMMAND} -E env "PYTHONPATH=${LIBRARY_OUTPUT_PATH}/python${OPAE_PYTHON_VERSION}"
|
|
Packit |
534379 |
${SPHINX_EXECUTABLE}
|
|
Packit |
534379 |
-q -b html
|
|
Packit |
534379 |
-c "${BINARY_BUILD_DIR}"
|
|
Packit |
534379 |
-d "${SPHINX_CACHE_DIR}"
|
|
Packit |
534379 |
"${BINARY_BUILD_DIR}"
|
|
Packit |
534379 |
"${SPHINX_HTML_DIR}"
|
|
Packit |
534379 |
WORKING_DIRECTORY "${BINARY_BUILD_DIR}"
|
|
Packit |
534379 |
COMMENT "Building HTML documentation with Sphinx")
|
|
Packit |
534379 |
|
|
Packit |
534379 |
add_custom_target(manpages ALL
|
|
Packit |
534379 |
COMMAND ${CMAKE_COMMAND} -E env "PYTHONPATH=${LIBRARY_OUTPUT_PATH}/python${OPAE_PYTHON_VERSION}"
|
|
Packit |
534379 |
${SPHINX_EXECUTABLE}
|
|
Packit |
534379 |
-q -b man
|
|
Packit |
534379 |
-c "${BINARY_BUILD_DIR}"
|
|
Packit |
534379 |
-d "${SPHINX_CACHE_DIR}"
|
|
Packit |
534379 |
"${BINARY_BUILD_DIR}"
|
|
Packit |
534379 |
"${SPHINX_MAN_DIR}"
|
|
Packit |
534379 |
WORKING_DIRECTORY "${BINARY_BUILD_DIR}"
|
|
Packit |
534379 |
COMMENT "Building manpages with Sphinx")
|
|
Packit |
534379 |
|
|
Packit |
534379 |
add_dependencies(docs
|
|
Packit |
534379 |
copy-doxygen-files
|
|
Packit |
534379 |
copy-markdown-files
|
|
Packit |
534379 |
copy-include-files
|
|
Packit |
534379 |
copy-sample-files
|
|
Packit |
534379 |
copy-python-files
|
|
Packit |
534379 |
doxygen
|
|
Packit |
534379 |
_opae)
|