From a9aacd4d48c3a5887267366c2ef643e953975792 Mon Sep 17 00:00:00 2001 From: Michal Cmarada Date: Mon, 11 Mar 2019 13:29:57 +0100 Subject: add documentation generator Enables generating of HTML documentation. It depends on sphinx generator. During configuration if sphinx is detected it will generate "docs" target for make. To build the documentation use "make docs", which will build the HTML documentation in build-root/html. Change-Id: Ia627f7d26c954a2341e13a54006955d21d162802 Signed-off-by: Michal Cmarada --- modules/FindSphinx.cmake | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 modules/FindSphinx.cmake (limited to 'modules') diff --git a/modules/FindSphinx.cmake b/modules/FindSphinx.cmake new file mode 100644 index 0000000..cb68e51 --- /dev/null +++ b/modules/FindSphinx.cmake @@ -0,0 +1,21 @@ +find_program(SPHINX_EXECUTABLE NAMES sphinx-build + HINTS + $ENV{SPHINX_DIR} + PATH_SUFFIXES bin + DOC "Sphinx documentation generator" + ) + +include(FindPackageHandleStandardArgs) + +if(NOT SPHINX_EXECUTABLE) + message(STATUS "Sphinx generator not found! Skipping setup for documentation generator.") + set(SPHINX_FOUND false) +else() + find_package_handle_standard_args(Sphinx DEFAULT_MSG + SPHINX_EXECUTABLE + ) + + mark_as_advanced(SPHINX_EXECUTABLE) + set(SPHINX_FOUND true) +endif() + -- cgit 1.2.3-korg