Convert documentation from qtdoc to Doxygen

CMakeLists.txt

@@ -30,9 +30,6 @@ include(ECMQmlModule)
 ## Features:
 include(features.cmake)
 
-## Project setup:
-qt6_standard_project_setup(REQUIRES 6.6)
-
 ## Disable use of C++ API deprecated in Qt 5.15
 add_compile_definitions(QT_DISABLE_DEPRECATED_UP_TO=0x050F00)
 
@@ -43,7 +40,7 @@ endif()
 
 ## Add subdirectories:
 if(FLUID_WITH_DOCUMENTATION)
-    #add_subdirectory(doc)
+    add_subdirectory(doc)
 endif()
 if(FLUID_WITH_QML_MODULES)
     add_subdirectory(src/imports/controls)

README.md

@@ -27,7 +27,6 @@ Qt >= 6.6.0 with at least the following modules is required:
  * [qtquickcontrols2](http://code.qt.io/cgit/qt/qtquickcontrols2.git)
  * [qtgraphicaleffects](http://code.qt.io/cgit/qt/qtgraphicaleffects.git)
  * [qtsvg](http://code.qt.io/cgit/qt/qtsvg.git)
- * [qtdoc](http://code.qt.io/cgit/qt/qtdoc.git)
 
 On Linux you also need:
 

doc/CMakeLists.txt

@@ -1,21 +1,25 @@
-include(LiriQDoc)
+if(DOXYGEN_FOUND)
+    # Set the output directory for Doxygen documentation
+    set(DOXYGEN_OUTPUT_DIR ${CMAKE_CURRENT_BINARY_DIR}/output)
 
-if(Qt5Core_VERSION VERSION_GREATER_EQUAL "5.12.0")
-    set(_qtquickcontrols_name "qtquickcontrols")
-else()
-    set(_qtquickcontrols_name "qtquickcontrols2")
-endif()
+    # Ensure the output directory exists
+    #file(MAKE_DIRECTORY ${DOXYGEN_OUTPUT_DIR})
+
+    # Configure Doxyfile
+    configure_file(
+        ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in
+        ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
+        @ONLY
+    )
+
+    # Doxygen custom targets
+    add_custom_target(doc_doxygen ALL
+        COMMAND ${CMAKE_COMMAND} -E make_directory ${DOXYGEN_OUTPUT_DIR}
+        COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
+        WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+        COMMENT "Generating Doxygen documentation" VERBATIM
+    )
 
-liri_install_doc(
-    "${CMAKE_CURRENT_SOURCE_DIR}/fluid.qdocconf"
-    OUTPUT_DIRECTORY_VARIABLE
-        _doc_output_dir
-    ENVIRONMENT
-        QTQUICKCONTROLS_NAME="${_qtquickcontrols_name}"
-        FLUID_VERSION="${PROJECT_VERSION}"
-        FLUID_VERSION_TAG="${PROJECT_VERSION_MAJOR}.${PROJECT_VERSION_MINOR}"
-        FLUID_BUILD_DIR="${CMAKE_CURRENT_BINARY_DIR}"
-)
-if(_doc_output_dir)
-    install(DIRECTORY "${_doc_output_dir}/" DESTINATION "${INSTALL_DOCDIR}/fluid/html")
+    install(DIRECTORY ${DOXYGEN_OUTPUT_DIR}/
+            DESTINATION ${KDE_INSTALL_DATADIR}/doc/${PROJECT_NAME})
 endif()

doc/Doxyfile.in

@@ -0,0 +1,11 @@
+INPUT              = ../src/imports
+OUTPUT_DIRECTORY   = @DOXYGEN_OUTPUT_DIR@
+RECURSIVE          = YES
+EXTRACT_ALL        = YES
+EXTRACT_PRIVATE    = YES
+EXTRACT_STATIC     = YES
+EXTRACT_LOCAL_METHODS = YES
+FILE_PATTERNS      = *.qml *.cpp *.h
+ENABLE_PREPROCESSING = YES
+HAVE_DOT           = YES
+CLASS_DIAGRAMS     = YES