3
0
mirror of https://github.com/triqs/dft_tools synced 2024-07-11 05:43:48 +02:00

[doc] Major cleaning of doc targets and CMakeLists.txt

This commit is contained in:
Nils Wentzell 2019-04-26 12:40:44 -04:00
parent c387828bd2
commit c492078f77
3 changed files with 35 additions and 29 deletions

View File

@ -31,7 +31,7 @@ find_package(Cpp2Py 1.6 REQUIRED)
# Default Install directory to TRIQS_ROOT if not given or invalid. # Default Install directory to TRIQS_ROOT if not given or invalid.
if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT OR (NOT IS_ABSOLUTE ${CMAKE_INSTALL_PREFIX})) if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT OR (NOT IS_ABSOLUTE ${CMAKE_INSTALL_PREFIX}))
message(STATUS " No install prefix given (or invalid). Defaulting to TRIQS_ROOT") message(STATUS "No install prefix given (or invalid). Defaulting to TRIQS_ROOT")
set(CMAKE_INSTALL_PREFIX ${TRIQS_ROOT} CACHE PATH "default install path" FORCE) set(CMAKE_INSTALL_PREFIX ${TRIQS_ROOT} CACHE PATH "default install path" FORCE)
endif() endif()
message(STATUS "-------- CMAKE_INSTALL_PREFIX: ${CMAKE_INSTALL_PREFIX} --------") message(STATUS "-------- CMAKE_INSTALL_PREFIX: ${CMAKE_INSTALL_PREFIX} --------")

View File

@ -5,7 +5,7 @@ add_library(app4triqs_c ${sources})
target_link_libraries(app4triqs_c PUBLIC triqs) target_link_libraries(app4triqs_c PUBLIC triqs)
# Configure compilation # Configure compilation
target_compile_options(app4triqs_c PUBLIC -std=c++17 -fPIC) target_compile_options(app4triqs_c PUBLIC -fPIC)
target_include_directories(app4triqs_c PUBLIC $<BUILD_INTERFACE:${CMAKE_SOURCE_DIR}/c++>) target_include_directories(app4triqs_c PUBLIC $<BUILD_INTERFACE:${CMAKE_SOURCE_DIR}/c++>)
target_compile_definitions(app4triqs_c PUBLIC target_compile_definitions(app4triqs_c PUBLIC
APP4TRIQS_GIT_HASH=${APP4TRIQS_GIT_HASH} APP4TRIQS_GIT_HASH=${APP4TRIQS_GIT_HASH}

View File

@ -4,42 +4,48 @@ configure_file(${CMAKE_CURRENT_SOURCE_DIR}/conf.py.in ${CMAKE_CURRENT_BINARY_DIR
# --------------------------------- # ---------------------------------
# Top Sphinx target # Top Sphinx target
# --------------------------------- # ---------------------------------
# Sources # Sphinx has internal caching, always run it
file(GLOB_RECURSE sources *.rst) add_custom_target(docs_sphinx ALL)
add_custom_command(
TARGET docs_sphinx
COMMAND PYTHONPATH=${CMAKE_BINARY_DIR}/python:$ENV{PYTHONPATH} ${TRIQS_SPHINXBUILD_EXECUTABLE} -c . -j8 -b html ${CMAKE_CURRENT_SOURCE_DIR} html
)
set(sphinx_top ${CMAKE_CURRENT_BINARY_DIR}/html/contents.html) # Autodoc usage requires the python modules to be built first
add_custom_command(OUTPUT ${sphinx_top} DEPENDS ${sources} get_property(CPP2PY_MODULES_LIST GLOBAL PROPERTY CPP2PY_MODULES_LIST)
COMMAND PYTHONPATH=${CMAKE_BINARY_DIR}/python:$ENV{PYTHONPATH} ${TRIQS_SPHINXBUILD_EXECUTABLE} -c . -j8 -b html ${CMAKE_CURRENT_SOURCE_DIR} html) add_dependencies(docs_sphinx ${CPP2PY_MODULES_LIST})
add_custom_target(docs_sphinx ALL DEPENDS ${sphinx_top} ${CMAKE_CURRENT_BINARY_DIR})
# Application must be compiled first
add_dependencies(docs_sphinx app4triqs_c toto_module)
# ----------------------------------------------------------------------------- # -----------------------------------------------------------------------------
# Make an optional target that allows us to regenerate the C++ doc with c++2rst # Create an optional target that allows us to regenerate the C++ doc with c++2rst
# ----------------------------------------------------------------------------- # -----------------------------------------------------------------------------
add_custom_target(docs_cpp2rst) foreach(t app4triqs_c triqs)
get_property(INCLUDE_DIRS TARGET ${t} PROPERTY INTERFACE_INCLUDE_DIRECTORIES)
get_property(TRIQS_INCLUDE_DIRS TARGET triqs PROPERTY INTERFACE_INCLUDE_DIRECTORIES) get_property(SYSTEM_INCLUDE_DIRS TARGET ${t} PROPERTY INTERFACE_SYSTEM_INCLUDE_DIRECTORIES)
get_property(APP4TRIQS_INCLUDE_DIRS TARGET app4triqs_c PROPERTY INTERFACE_INCLUDE_DIRECTORIES) if(SYTEM_INCLUDE_DIRS)
set(CPP2RST_INCLUDE_DIRS ${TRIQS_INCLUDE_DIRS} ${APP4TRIQS_INCLUDE_DIRS}) list(REMOVE_ITEM INCLUDE_DIRS ${SYSTEM_INCLUDE_DIRS})
endif()
foreach(I ${CPP2RST_INCLUDE_DIRS}) foreach(DIR ${INCLUDE_DIRS})
set (CPP2RST_INCLUDE_COMMAND ${CPP2RST_INCLUDE_COMMAND} --includes ${I}) set(CPP2RST_INCLUDE_FLAGS ${CPP2RST_INCLUDE_FLAGS} -I${DIR})
endforeach()
foreach(DIR ${SYSTEM_INCLUDE_DIRS})
set(CPP2RST_INCLUDE_FLAGS ${CPP2RST_INCLUDE_FLAGS} -isystem=${DIR})
endforeach()
get_property(COMPILE_OPTIONS TARGET ${t} PROPERTY INTERFACE_COMPILE_OPTIONS)
set(CPP2RST_CXXFLAGS ${CPP2RST_CXXFLAGS} ${COMPILE_OPTIONS})
endforeach() endforeach()
add_custom_target(docs_cpp2rst)
macro(generate_docs header_file) macro(generate_docs header_file)
add_custom_command( add_custom_command(
TARGET docs_cpp2rst TARGET docs_cpp2rst
COMMAND c++2rst COMMAND rm -rf ${CMAKE_CURRENT_SOURCE_DIR}/cpp2rst_generated
${header_file} COMMAND
-N app4triqs c++2rst
--output_directory ${CMAKE_CURRENT_SOURCE_DIR}/cpp2rst_generated ${header_file}
${CPP2RST_INCLUDE_COMMAND} -N app4triqs
--cxxflags="-std=c++17" --output_directory ${CMAKE_CURRENT_SOURCE_DIR}/cpp2rst_generated
-I ${CMAKE_SOURCE_DIR}/c++ --cxxflags="${CPP2RST_CXXFLAGS}"
-I ${TRIQS_ROOT}/include ${CPP2RST_INCLUDE_FLAGS}
2>&1 >> cpp2rst.log
) )
endmacro(generate_docs) endmacro(generate_docs)