docs: Add documentation generation

Author: mjakeman

src/CMakeLists.txt

@@ -64,14 +64,13 @@ if (INTROSPECTION)
             HINTS ${PC_g_ir_compiler}
     )
 
-    set(G_IR_SCANNER_CMD "${G_IR_SCANNER}")
     set(web_libpath "$<TARGET_FILE_DIR:webembed>")
 
     add_custom_command (
             TARGET webembed
             WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
             POST_BUILD
-            COMMAND ${G_IR_SCANNER_CMD}
+            COMMAND "${G_IR_SCANNER}"
             --warn-all --no-libtool --verbose
             --namespace=Web
             --nsversion=0.0
@@ -98,4 +97,36 @@ if (INTROSPECTION)
             -o ${web_libpath}/Web-0.0.typelib
             DEPENDS ${web_libpath}/Web-0.0.gir webembed
     )
+endif ()
+
+# gi-docgen generate -C config.toml /usr/share/gir-1.0/Gtk-4.0.gir
+
+if (DOCUMENTATION AND INTROSPECTION)
+    find_package(PkgConfig)
+    pkg_check_modules(GI_DOCGEN QUIET gi-docgen)
+
+    find_program(GI_DOCGEN gi-docgen
+            HINTS ${PC_gi_docgen}
+    )
+
+    if(${CMAKE_SYSTEM_NAME} MATCHES "Darwin")
+        set(EXTRA_SEARCH_PATH "/opt/homebrew/share/gir-1.0")
+    else()
+        set(EXTRA_SEARCH_PATH "")
+    endif()
+
+
+    add_custom_command (
+            TARGET webembed
+            POST_BUILD
+            COMMAND "${GI_DOCGEN}"
+            generate
+            -C ${CMAKE_CURRENT_SOURCE_DIR}/config.toml
+            ${web_libpath}/Web-0.0.gir
+            --output-dir ${CMAKE_CURRENT_BINARY_DIR}/../docs
+            --add-include-path "${EXTRA_SEARCH_PATH}"
+            --no-namespace-dir
+            DEPENDS ${web_libpath}/Web-0.0.gir webembed
+    )
+
 endif ()

src/config.toml

@@ -0,0 +1,27 @@
+[library]
+description = "LibWeb GTK"
+authors = "Matthew Jakeman"
+license = "BSD 2-Clause"
+browse_url = "https://github.com/mjakeman/libweb-gtk"
+repository_url = "https://github.com/mjakeman/libweb-gtk.git"
+website_url = "https://github.com/mjakeman/libweb-gtk"
+dependencies = [
+    "GObject-2.0",
+    "Gtk-4.0",
+    "Soup-3.0"
+]
+
+[dependencies."GObject-2.0"]
+name = "GObject"
+description = "The base type system library"
+docs_url = "https://docs.gtk.org/gobject/"
+
+[dependencies."Gtk-4.0"]
+name = "Gtk"
+description = "The GTK toolkit"
+docs_url = "https://docs.gtk.org/gtk4/"
+
+[dependencies."Soup-3.0"]
+name = "Soup"
+description = "HTTP client/server library for GNOME"
+docs_url = "https://libsoup.org/libsoup-3.0/"