This GitLab instance will be migrated to gitlab.mel.vin before 2020-06-01 and will lose the shared runners, setup your own runners if needed.

Commit 17458717 authored by Stefan Schrijvers's avatar Stefan Schrijvers

Merge branch '90-remove-autogenerated-api-build' into 'master'

Resolve "remove autogenerated api build"

Closes #90

See merge request !93
parents b5aad445 b895fa59
if(BREATHE_APIDOC_FOUND)
return()
endif()
find_program(BREATHE_APIDOC_PATH
NAMES breathe-apidoc
DOC "Path to breathe-apidoc.")
if(NOT BREATHE_APIDOC_PATH)
message(FATAL_ERROR "Could not find breathe-apidoc.")
endif()
set(BREATHE_APIDOC_FOUND ON CACHE BOOL "Found breathe-apidoc.")
mark_as_advanced(BREATHE_APIDOC_FOUND)
message(STATUS "Found breathe-apidoc: ${BREATHE_APIDOC_PATH}")
......@@ -66,7 +66,6 @@ else()
unset(SPHINX_WERROR)
endif()
include(breathe_apidoc)
include(plantuml)
configure_file(
......@@ -93,28 +92,11 @@ if(DOC STREQUAL "doxygen")
COMMAND ;
COMMENT "Output at ${DOC_DEST}/html/index.html")
else()
configure_file("${DOC_SRC}/api/file/index.rst.in"
"${DOC_TMP}/api/file/index.rst" @ONLY)
add_custom_target(doc
COMMAND "${CMAKE_COMMAND}" -E echo
"Generating Doxygen XML API documentation"
COMMAND Doxygen::doxygen "${DOC_TMP}/doxygen/doxyfile"
COMMAND "${CMAKE_COMMAND}" -E echo
"Converting Doxygen XML API to RST API documentation"
COMMAND "${CMAKE_COMMAND}" -E env "PYTHONPATH=${PYTHONPATH}"
"${PYTHON_EXECUTABLE}" "${BREATHE_APIDOC_PATH}"
-o "${DOC_TMP}/api/file" -f -g file -q
"${DOC_TMP}/doxygen/xml"
COMMAND "${CMAKE_COMMAND}" -E echo
"Generating sphinx ${DOC} API documentation"
COMMAND "${CMAKE_COMMAND}" -E env "PYTHONPATH=${PYTHONPATH}"
"${PYTHON_EXECUTABLE}" -m sphinx -b "${DOC}" -j auto
-c "${DOC_TMP}/sphinx" -q ${SPHINX_WERROR}
"${DOC_TMP}/api/file" "${DOC_DEST}/api/file"
COMMAND "${CMAKE_COMMAND}" -E echo
"Generating sphinx ${DOC} documentation"
COMMAND "${CMAKE_COMMAND}" -E env "PYTHONPATH=${PYTHONPATH}"
......
API by source file name
=======================
`Return to the main documentation index. <../../index.html>`_
.. toctree::
:caption: Index
:glob:
*
API documentation
=================
API documentation is automatically generated from current sources. There are two
indexes available:
* `By filename <file/index.html>`_
* `By element name <file/genindex.html>`_
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment