| |
| # NOTE: The order of this list determines the order of items in the Guides |
| # (i.e. Pages) list in the generated documentation |
| set(source_files |
| main.md |
| news.md |
| quick.md |
| moving.md |
| compile.md |
| build.md |
| intro.md |
| context.md |
| monitor.md |
| window.md |
| input.md |
| vulkan.md |
| compat.md |
| internal.md) |
| |
| set(extra_files DoxygenLayout.xml header.html footer.html extra.css spaces.svg) |
| |
| set(header_paths |
| "${GLFW_SOURCE_DIR}/include/GLFW/glfw3.h" |
| "${GLFW_SOURCE_DIR}/include/GLFW/glfw3native.h") |
| |
| # Format the source list into a Doxyfile INPUT value that Doxygen can parse |
| foreach(path IN LISTS header_paths) |
| string(APPEND GLFW_DOXYGEN_INPUT " \\\n\"${path}\"") |
| endforeach() |
| foreach(file IN LISTS source_files) |
| string(APPEND GLFW_DOXYGEN_INPUT " \\\n\"${CMAKE_CURRENT_SOURCE_DIR}/${file}\"") |
| endforeach() |
| |
| set(DOXYGEN_SKIP_DOT TRUE) |
| find_package(Doxygen) |
| |
| if (NOT DOXYGEN_FOUND OR DOXYGEN_VERSION VERSION_LESS "1.9.8") |
| message(STATUS "Documentation generation requires Doxygen 1.9.8 or later") |
| else() |
| configure_file(Doxyfile.in Doxyfile @ONLY) |
| add_custom_command(OUTPUT "html/index.html" |
| COMMAND "${DOXYGEN_EXECUTABLE}" |
| WORKING_DIRECTORY "${CMAKE_CURRENT_BINARY_DIR}" |
| MAIN_DEPENDENCY Doxyfile |
| DEPENDS ${header_paths} ${source_files} ${extra_files} |
| COMMENT "Generating HTML documentation" |
| VERBATIM) |
| |
| add_custom_target(docs ALL SOURCES "html/index.html") |
| set_target_properties(docs PROPERTIES FOLDER "GLFW3") |
| |
| if (GLFW_INSTALL) |
| install(DIRECTORY "${GLFW_BINARY_DIR}/docs/html" |
| DESTINATION "${CMAKE_INSTALL_DOCDIR}") |
| endif() |
| endif() |
| |
