Doxygen can be run to create documentation

CMakeLists.txt

@@ -108,3 +108,25 @@ install(
   FILES "${PROJECT_BINARY_DIR}/lib${PROJECT_NAME}_rdict.pcm"
   DESTINATION "${INSTALL_LIB_DIR}"
   COMPONENT dev)
+
+# Generate documentation
+
+find_package(Doxygen)
+if(DOXYGEN_FOUND)
+  configure_file(${CMAKE_CURRENT_SOURCE_DIR}/doc/Doxyfile.in
+                 ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile @ONLY)
+  configure_file(${CMAKE_CURRENT_SOURCE_DIR}/doc/DoxygenLayout.xml
+                 ${CMAKE_CURRENT_BINARY_DIR}/DoxygenLayout.xml COPYONLY)
+  add_custom_target(
+    doc
+    ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
+    WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+    COMMENT "Generating API documentation with Doxygen"
+    VERBATIM)
+
+  install(
+    DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/doxygen
+    DESTINATION ${CMAKE_INSTALL_DOCDIR}/doxygen
+    OPTIONAL)
+
+endif()