basic documentation generation

CMakeLists.txt

@@ -9,7 +9,28 @@ set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED True)
 set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
 
-# depdencies
+# Doxygen Support
+# Based on https://vicrucann.github.io/tutorials/quick-cmake-doxygen/
+option(BUILD_DOC "Build Documentation" ON)
+find_package( Doxygen )
+if (DOXYGEN_FOUND)
+	# Set docs folder
+	set(DOXYGEN_IN ${CMAKE_CURRENT_SOURCE_DIR}/docs/Doxyfile.in)
+	set(DOXYGEN_OUT ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
+
+	# configure file
+	configure_file(${DOXYGEN_IN} ${DOXYGEN_OUT} @ONLY)
+	message("Doxygen build started")
+
+	# note the option ALL which allows to build the docs together with the application
+	add_custom_target( doc_doxygen ALL
+		COMMAND ${DOXYGEN_EXECUTABLE} ${DOXYGEN_OUT}
+		WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+		COMMENT "Generating API documentation with Doxygen"
+		VERBATIM )
+endif (DOXYGEN_FOUND)
+
+# depedencies
 find_package( glfw3 )
 if ( NOT glfw3_FOUND )
   include(FetchContent)