fmt/doc/CMakeLists.txt

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

add_custom_target(doc
  COMMAND ${CMAKE_CURRENT_SOURCE_DIR}/build.py ${FMT_VERSION}
  SOURCES api.rst syntax.rst usage.rst build.py conf.py _templates/layout.html)

install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/
        DESTINATION share/doc/fmt OPTIONAL
        PATTERN ".doctrees" EXCLUDE)
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 ()`

Pass version from CMake to Sphinx 2015-11-23 16:10:02 +00:00			`add_custom_target(doc`
Revert "find sphinx-build before calling build.py" This reverts commit 07200f445a64c73c153ec8835f4c1460d2bca377 because the latter doesn't work with virtualenv correctly. 2018-10-28 16:26:21 +00:00			`COMMAND ${CMAKE_CURRENT_SOURCE_DIR}/build.py ${FMT_VERSION}`
Improve docs 2018-12-28 23:05:42 +00:00			`SOURCES api.rst syntax.rst usage.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/`
Don't install sphinx cache files When building documentation sphinx creates cached files in the .doctrees directory and aren't required for viewing documentation only for building. As added benefit this makes fmt reprodcubile as the cached files are different when the build environment is varied. 2020-05-29 21:19:16 +00:00			`DESTINATION share/doc/fmt OPTIONAL`
			`PATTERN ".doctrees" EXCLUDE)`