fmt/doc/CMakeLists.txt

find_program(DOXYGEN doxygen)
if (NOT DOXYGEN)
  message(STATUS "Target 'doc' disabled (requires doxygen)")
  return ()
endif ()

find_package(PythonInterp
  QUIET REQUIRED)
find_program(SPHINX_EXECUTABLE
  NAMES sphinx-build sphinx-build-3)
add_custom_target(doc
  COMMAND ${CMAKE_COMMAND} -E env SPHINX_EXECUTABLE=${SPHINX_EXECUTABLE}
    ${PYTHON_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/build.py ${FMT_VERSION}
  SOURCES api.rst syntax.rst build.py conf.py _templates/layout.html)

install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/
        DESTINATION share/doc/fmt OPTIONAL)
Make documentation builds more reproducible by using virtualenv 2015-04-10 15:39:09 +00:00			`find_program(DOXYGEN doxygen)`
			`if (NOT DOXYGEN)`
			`message(STATUS "Target 'doc' disabled (requires doxygen)")`
Only enable doc target if breathe is available 2015-03-02 00:35:29 +00:00			`return ()`
			`endif ()`

use found python executable for launching sphinx-build there is chance that the distro install python as python3, in that case the shebang of ``` ``` in build.py won't work. Signed-off-by: Kefu Chai <tchaikov@gmail.com> 2018-10-12 13:09:44 +00:00			`find_package(PythonInterp`
			`QUIET REQUIRED)`
find sphinx-build before calling build.py this allows us to use sphinx-build-3, as user might already in a python3 world, and distros, like fedora 28, tend to add a "-3" suffix to sphinx-build. Signed-off-by: Kefu Chai <tchaikov@gmail.com> 2018-10-12 08:01:54 +00:00			`find_program(SPHINX_EXECUTABLE`
			`NAMES sphinx-build sphinx-build-3)`
Pass version from CMake to Sphinx 2015-11-23 16:10:02 +00:00			`add_custom_target(doc`
find sphinx-build before calling build.py this allows us to use sphinx-build-3, as user might already in a python3 world, and distros, like fedora 28, tend to add a "-3" suffix to sphinx-build. Signed-off-by: Kefu Chai <tchaikov@gmail.com> 2018-10-12 08:01:54 +00:00			`COMMAND ${CMAKE_COMMAND} -E env SPHINX_EXECUTABLE=${SPHINX_EXECUTABLE}`
use found python executable for launching sphinx-build there is chance that the distro install python as python3, in that case the shebang of ``` ``` in build.py won't work. Signed-off-by: Kefu Chai <tchaikov@gmail.com> 2018-10-12 13:09:44 +00:00			`${PYTHON_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/build.py ${FMT_VERSION}`
Add syntax.rst to build 2018-01-21 01:55:43 +00:00			`SOURCES api.rst syntax.rst build.py conf.py _templates/layout.html)`
Only add the doc target if doxygen and sphinx-build are available 2015-01-30 20:53:52 +00:00
Make documentation installation optional (#333) 2016-05-24 14:03:08 +00:00			`install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/`
			`DESTINATION share/doc/fmt OPTIONAL)`