Enable generation of Doxygen documentation

Author: jimmysoda

.gitignore

@@ -3,6 +3,10 @@ tests/pdal-stats.las
 tests/data/*.json
 tests/pdal/capi/*Test.c
 
+# Ignore doxygen docs
+/doc/doxygen
+/doc/Doxyfile
+
 # Select VS Code configurations
 .vscode/settings.json
 .vscode/c_cpp_properties.json

CMakeLists.txt

@@ -44,6 +44,7 @@ if(CMAKE_COMPILER_IS_GNUCXX)
 endif()
 
 add_subdirectory("source/pdal/capi")
+add_subdirectory("doc")
 
 include(CTest)
 add_subdirectory("tests/data")

doc/CMakeLists.txt

@@ -0,0 +1,17 @@
+# CMake configuration file for Keryx documentation
+
+find_package(Doxygen)
+
+if (DOXYGEN_FOUND)
+	configure_file("${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in" "${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile")
+
+	add_custom_target( "${PROJECT_NAME}_doxygen" ALL
+		COMMAND ${DOXYGEN_EXECUTABLE} "${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile"
+		WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+		COMMENT "Generating API documentation with Doxygen"
+		VERBATIM )
+
+	install(DIRECTORY doxygen DESTINATION doc)
+else()
+	message(STATUS "Could not generate ${PROJECT_NAME} API help documentation: Doxygen not found")
+endif()