[gtk/ebassi/gidocgen] fixup! Generate GTK API reference(s) with gi-docgen

[Emmanuele Bassi <ebassi src gnome org>]

commit aae07daf04f498ff43096520a12124e98d1bbe99
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Wed Feb 10 15:02:48 2021 +0000

    fixup! Generate GTK API reference(s) with gi-docgen

 docs/reference/gdk/gdk.toml    |  73 ++++++++++
 docs/reference/gdk/meson.build | 172 +++++++----------------
 docs/reference/gsk/gsk.toml    |  36 +++++
 docs/reference/gsk/meson.build |  76 ++--------
 docs/reference/gtk/gtk.toml    | 306 ++++++++++++++++++++---------------------
 docs/reference/gtk/meson.build | 172 +----------------------
 6 files changed, 330 insertions(+), 505 deletions(-)
---
diff --git a/docs/reference/gdk/gdk.toml b/docs/reference/gdk/gdk.toml
new file mode 100644
index 0000000000..159ccbd39d
--- /dev/null
+++ b/docs/reference/gdk/gdk.toml
@@ -0,0 +1,73 @@
+[library]
+name = "GTK"
+browse_url = "https://gitlab.gnome.org/GNOME/gtk/";
+repository_url = "https://gitlab.gnome.org/GNOME/gtk.git";
+website_url = "https://www.gtk.org";
+authors = "GTK Development Team"
+logo_url = "https://www.gtk.org/";
+license = "GPL-2.1-or-later"
+description = "The GTK toolkit"
+dependencies = [ "GObject-2.0", "Graphene-1.0", "Pango-1.0" ]
+
+  [dependencies."GObject-2.0"]
+  name = "GObject"
+  description = "The base type system library"
+  docs_url = "https://developer.gnome.org/gobject/stable";
+
+  [dependencies."Graphene-1.0"]
+  name = "Graphene"
+  description = "A thin layer of mathematical types for 3D libraries"
+  docs_url = "https://ebassi.github.io/graphene/docs";
+
+  [dependencies."Pango-1.0"]
+  name = "Pango"
+  description = "Text shaping and rendering"
+  docs_url = "https://developer.gnome.org/pango/stable";
+
+[theme]
+name = "basic"
+
+[source-location]
+base_url = "https://gitlab.gnome.org/GNOME/gtk/-/blob/master/";
+
+[extra]
+content_images = [
+  "images/rotated-text.png",
+  "images/default_cursor.png",
+  "images/help_cursor.png",
+  "images/pointer_cursor.png",
+  "images/context_menu_cursor.png",
+  "images/progress_cursor.png",
+  "images/wait_cursor.png",
+  "images/cell_cursor.png",
+  "images/crosshair_cursor.png",
+  "images/text_cursor.png",
+  "images/vertical_text_cursor.png",
+  "images/alias_cursor.png",
+  "images/copy_cursor.png",
+  "images/no_drop_cursor.png",
+  "images/move_cursor.png",
+  "images/not_allowed_cursor.png",
+  "images/grab_cursor.png",
+  "images/grabbing_cursor.png",
+  "images/all_scroll_cursor.png",
+  "images/col_resize_cursor.png",
+  "images/row_resize_cursor.png",
+  "images/n_resize_cursor.png",
+  "images/e_resize_cursor.png",
+  "images/s_resize_cursor.png",
+  "images/w_resize_cursor.png",
+  "images/ne_resize_cursor.png",
+  "images/nw_resize_cursor.png",
+  "images/sw_resize_cursor.png",
+  "images/se_resize_cursor.png",
+  "images/ew_resize_cursor.png",
+  "images/ns_resize_cursor.png",
+  "images/nesw_resize_cursor.png",
+  "images/nwse_resize_cursor.png",
+  "images/zoom_in_cursor.png",
+  "images/zoom_out_cursor.png",
+  "images/popup-anchors.png",
+  "images/popup-flip.png",
+  "images/popup-slide.png",
+]
diff --git a/docs/reference/gdk/meson.build b/docs/reference/gdk/meson.build
index 36b7e97003..62c9591c55 100644
--- a/docs/reference/gdk/meson.build
+++ b/docs/reference/gdk/meson.build
@@ -1,115 +1,3 @@
-private_headers = [
-  'gdk-autocleanup.h',
-  'gdk-private.h',
-  'gdkapplaunchcontextprivate.h',
-  'gdkcairocontextprivate.h',
-  'gdkcairoprivate.h',
-  'gdkclipboardprivate.h',
-  'gdkcontentformatsprivate.h',
-  'gdkcontentproviderprivate.h',
-  'gdkcursorprivate.h',
-  'gdkdebug.h',
-  'gdkdevicepadprivate.h',
-  'gdkdeviceprivate.h',
-  'gdkdevicetoolprivate.h',
-  'gdkdisplaymanagerprivate.h',
-  'gdkdisplayprivate.h',
-  'gdkdndprivate.h',
-  'gdkdragprivate.h',
-  'gdkdragsurfaceprivate.h',
-  'gdkdrawcontextprivate.h',
-  'gdkdropprivate.h',
-  'gdkeventsprivate.h',
-  'gdkframeclockidleprivate.h',
-  'gdkframeclockprivate.h',
-  'gdkglcontextprivate.h',
-  'gdkgltextureprivate.h',
-  'gdkinternals.h',
-  'gdkintl.h',
-  'gdkkeysprivate.h',
-  'gdkkeysyms.h',
-  'gdkmarshalers.h',
-  'gdkmemorytextureprivate.h',
-  'gdkmonitorprivate.h',
-  'gdkpipeiostreamprivate.h',
-  'gdkpopupprivate.h',
-  'gdkprofilerprivate.h',
-  'gdkrgbaprivate.h',
-  'gdkscreenprivate.h',
-  'gdkseatdefaultprivate.h',
-  'gdkseatprivate.h',
-  'gdksnapshotprivate.h',
-  'gdksurfaceimpl.h',
-  'gdksurfaceprivate.h',
-  'gdktextureprivate.h',
-  'gdktoplevelprivate.h',
-  'gdktoplevelsizeprivate.h',
-  'gdkvulkancontextprivate.h',
-
-  'filetransferportalprivate.h',
-  'gdkconstructor.h',
-  'keyname-table.h',
-
-  # gdk/x11
-  'gdkasync.h',
-  'gdkcairocontext-x11.h',
-  'gdkclipboard-x11.h',
-  'gdkdevice-xi2-private.h',
-  'gdkdevicemanagerprivate-core.h',
-  'gdkdisplay-x11.h',
-  'gdkeventsource.h',
-  'gdkeventtranslator.h',
-  'gdkglcontext-x11.h',
-  'gdkkeys-x11.h',
-  'gdkmonitor-x11.h',
-  'gdkprivate-x11.h',
-  'gdkscreen-x11.h',
-  'gdkselectioninputstream-x11.h',
-  'gdkselectionoutputstream-x11.h',
-  'gdksurface-x11.h',
-  'gdktextlistconverter-x11.h',
-  'gdkvisual-x11.h',
-  'gdkvulkancontext-x11.h',
-  'gdkx-autocleanups.h',
-  'MwmUtil.h',
-  'xsettings-client.h',
-
-  # gdk/wayland
-  'gdkcairocontext-wayland.h',
-  'gdkclipboard-wayland.h',
-  'gdkdevice-wayland-private.h',
-  'gdkdisplay-wayland.h',
-  'gdkglcontext-wayland.h',
-  'gdkmonitor-wayland.h',
-  'gdkprimary-wayland.h',
-  'gdkprivate-wayland.h',
-  'gdkseat-wayland.h',
-  'gdksurface-wayland.h',
-  'gdkvulkancontext-wayland.h',
-  'wm-button-layout-translation.h',
-  'gtk-primary-selection-client-protocol.h',
-  'gtk-shell-client-protocol.h',
-  'idle-inhibit-unstable-v1-client-protocol.h',
-  'keyboard-shortcuts-inhibit-unstable-v1-client-protocol.h',
-  'pointer-gestures-unstable-v1-client-protocol.h',
-  'primary-selection-unstable-v1-client-protocol.h',
-  'server-decoration-client-protocol.h',
-  'tablet-unstable-v2-client-protocol.h',
-  'xdg-foreign-unstable-v1-client-protocol.h',
-  'xdg-shell-unstable-v6-client-protocol.h',
-  'xdg-output-unstable-v1-client-protocol.h',
-  'xdg-shell-client-protocol.h',
-  'xdg-shell-unstable-v6-client-protocol.h',
-  'wayland-cursor.h',
-  'os-compatibility.h',
-  'xcursor.h',
-
-  'broadway',
-  'wayland/cursor',
-  'macos',
-  'win32',
-]
-
 images = [
   'images/rotated-text.png',
   'images/default_cursor.png',
@@ -151,15 +39,59 @@ images = [
   'images/popup-slide.png',
 ]
 
-src_dir = [ gdkinc ]
+expand_content_md_files = [
+]
 
-if x11_enabled
-  src_dir += [ gdkx11_inc ]
-endif
+if get_option('gtk_doc')
+  custom_target('gdk4-doc',
+    input: gdk_gir[0],
+    output: 'html',
+    command: [
+      gidocgen,
+      'generate',
+      '--add-include-path=@0@'.format(meson.current_source_dir() / '../../../gtk'),
+      '--config=@0@'.format(meson.current_source_dir() / 'gdk.toml'),
+      '--output-dir=@OUTPUT@',
+      '--content-dir=@0@'.format(meson.current_source_dir()),
+      '@INPUT@',
+    ],
+    depend_files: [ 'gdk.toml', expand_content_md_files ],
+    build_by_default: true,
+  )
 
-if wayland_enabled
-  src_dir += [ gdkwayland_inc ]
-endif
+  if x11_enabled
+    custom_target('gdk4-x11-doc',
+      input: gdk_x11_gir[0],
+      output: 'html',
+      command: [
+        gidocgen,
+        'generate',
+        '--add-include-path=@0@'.format(meson.current_source_dir() / '../../../gtk'),
+        '--config=@0@'.format(meson.current_source_dir() / 'gdk.toml'),
+        '--output-dir=@OUTPUT@',
+        '--content-dir=@0@'.format(meson.current_source_dir()),
+        '@INPUT@',
+      ],
+      depend_files: [ 'gdk.toml', expand_content_md_files ],
+      build_by_default: true,
+    )
+  endif
 
-if get_option('gtk_doc')
+  if wayland_enabled
+    custom_target('gdk4-x11-doc',
+      input: gdk_wayland_gir[0],
+      output: 'html',
+      command: [
+        gidocgen,
+        'generate',
+        '--add-include-path=@0@'.format(meson.current_source_dir() / '../../../gtk'),
+        '--config=@0@'.format(meson.current_source_dir() / 'gdk.toml'),
+        '--output-dir=@OUTPUT@',
+        '--content-dir=@0@'.format(meson.current_source_dir()),
+        '@INPUT@',
+      ],
+      depend_files: [ 'gdk.toml', expand_content_md_files ],
+      build_by_default: true,
+    )
+  endif
 endif
diff --git a/docs/reference/gsk/gsk.toml b/docs/reference/gsk/gsk.toml
new file mode 100644
index 0000000000..782e5051bc
--- /dev/null
+++ b/docs/reference/gsk/gsk.toml
@@ -0,0 +1,36 @@
+[library]
+name = "GTK"
+browse_url = "https://gitlab.gnome.org/GNOME/gtk/";
+repository_url = "https://gitlab.gnome.org/GNOME/gtk.git";
+website_url = "https://www.gtk.org";
+authors = "GTK Development Team"
+logo_url = "https://www.gtk.org/";
+license = "GPL-2.1-or-later"
+description = "The GTK toolkit"
+dependencies = [ "GObject-2.0", "Graphene-1.0", "Pango-1.0", "Gdk-4.0" ]
+
+  [dependencies."GObject-2.0"]
+  name = "GObject"
+  description = "The base type system library"
+  docs_url = "https://developer.gnome.org/gobject/stable";
+
+  [dependencies."Graphene-1.0"]
+  name = "Graphene"
+  description = "A thin layer of mathematical types for 3D libraries"
+  docs_url = "https://ebassi.github.io/graphene/docs";
+
+  [dependencies."Pango-1.0"]
+  name = "Pango"
+  description = "Text shaping and rendering"
+  docs_url = "https://developer.gnome.org/pango/stable";
+
+  [dependencies."Gdk-4.0"]
+  name = "GDK"
+  description = "The GTK windowing system abstraction"
+  docs_url = "../../Gdk/4.0/"
+
+[theme]
+name = "basic"
+
+[source-location]
+base_url = "https://gitlab.gnome.org/GNOME/gtk/-/blob/master/";
diff --git a/docs/reference/gsk/meson.build b/docs/reference/gsk/meson.build
index bdabb494c9..9845c092af 100644
--- a/docs/reference/gsk/meson.build
+++ b/docs/reference/gsk/meson.build
@@ -1,63 +1,17 @@
-private_headers = [
-  'gsk-autocleanup.h',
-
-  'gskcairoblurprivate.h',
-  'gskcairorendererprivate.h',
-  'gskdebugprivate.h',
-  'gskdiffprivate.h',
-  'gskglshaderprivate.h',
-  'gskprivate.h',
-  'gskprofilerprivate.h',
-  'gskrendererprivate.h',
-  'gskrendernodeprivate.h',
-  'gskrendernodeparserprivate.h',
-  'gskroundedrectprivate.h',
-  'gsktransformprivate.h',
-
-  # gsk/gl
-  'glutilsprivate.h',
-  'gskgldriverprivate.h',
-  'gskglglyphcacheprivate.h',
-  'gskgliconcacheprivate.h',
-  'gskglimageprivate.h',
-  'gskglnodesampleprivate.h',
-  'gskglprofilerprivate.h',
-  'gskglrendererprivate.h',
-  'gskglrenderopsprivate.h',
-  'gskglshaderbuilderprivate.h',
-  'gskglshadowcacheprivate.h',
-  'gskgltextureatlasprivate.h',
-  'opbuffer.h',
-  'stb_rect_pack.h',
-
-  # gsk/vulkan
-  'gskvulkanblendmodepipelineprivate.h',
-  'gskvulkanblurpipelineprivate.h',
-  'gskvulkanborderpipelineprivate.h',
-  'gskvulkanboxshadowpipelineprivate.h',
-  'gskvulkanbufferprivate.h',
-  'gskvulkanclipprivate.h',
-  'gskvulkancolorpipelineprivate.h',
-  'gskvulkancolortextpipelineprivate.h',
-  'gskvulkancommandpoolprivate.h',
-  'gskvulkancrossfadepipelineprivate.h',
-  'gskvulkaneffectpipelineprivate.h',
-  'gskvulkanglyphcacheprivate.h',
-  'gskvulkanimageprivate.h',
-  'gskvulkanlineargradientpipelineprivate.h',
-  'gskvulkanmemoryprivate.h',
-  'gskvulkanpipelineprivate.h',
-  'gskvulkanpushconstantsprivate.h',
-  'gskvulkanrendererprivate.h',
-  'gskvulkanrenderpassprivate.h',
-  'gskvulkanrenderprivate.h',
-  'gskvulkanshaderprivate.h',
-  'gskvulkantextpipelineprivate.h',
-  'gskvulkantexturepipelineprivate.h',
-]
-
-images = [
-]
-
 if get_option('gtk_doc')
+  custom_target('gsk4-doc',
+    input: gsk_gir[0],
+    output: 'html',
+    command: [
+      gidocgen,
+      'generate',
+      '--add-include-path=@0@'.format(meson.current_source_dir() / '../../../gtk'),
+      '--config=@0@'.format(meson.current_source_dir() / 'gsk.toml'),
+      '--output-dir=@OUTPUT@',
+      '--content-dir=@0@'.format(meson.current_source_dir()),
+      '@INPUT@',
+    ],
+    depend_files: [ 'gsk.toml', expand_content_md_files ],
+    build_by_default: true,
+  )
 endif
diff --git a/docs/reference/gtk/gtk.toml b/docs/reference/gtk/gtk.toml
index 262ad2ac68..418e6cef67 100644
--- a/docs/reference/gtk/gtk.toml
+++ b/docs/reference/gtk/gtk.toml
@@ -68,157 +68,157 @@ content_files = [
   "x11.md",
 ]
 content_images = [
-  'images/aboutdialog.png',
-  'images/action-bar.png',
-  'images/appchooserbutton.png',
-  'images/appchooserdialog.png',
-  'images/arrows.png',
-  'images/assistant.png',
-  'images/background.png',
-  'images/bloatpad-gnome.png',
-  'images/bloatpad-osx.png',
-  'images/bloatpad-xfce.png',
-  'images/border1.png',
-  'images/border2.png',
-  'images/border3.png',
-  'images/box.png',
-  'images/box-expand.png',
-  'images/box-packing.png',
-  'images/builder-shortcuts.png',
-  'images/button.png',
-  'images/calendar.png',
-  'images/capture-bubble.png',
-  'images/centerbox.png',
-  'images/check-button.png',
-  'images/checks.png',
-  'images/clocks-shortcuts.png',
-  'images/color-button.png',
-  'images/colorchooser.png',
-  'images/combo-box-entry.png',
-  'images/combo-box.png',
-  'images/combo-box-text.png',
-  'images/down-center.png',
-  'images/down-end.png',
-  'images/down-start.png',
-  'images/drop-down.png',
-  'images/drawing.png',
-  'images/drawingarea.png',
-  'images/ease-in-out.png',
-  'images/ease-in.png',
-  'images/ease-out.png',
-  'images/ease.png',
-  'images/editable-label.png',
-  'images/emojichooser.png',
-  'images/entry.png',
-  'images/exampleapp.png',
-  'images/expanders.png',
-  'images/expander.png',
-  'images/extensions.png',
-  'images/figure-hierarchical-drawing.png',
-  'images/figure-windowed-label.png',
-  'images/file-button.png',
-  'images/filechooser.png',
-  'images/flow-box.png',
-  'images/focus.png',
-  'images/font-button.png',
-  'images/fontchooser.png',
-  'images/frame-gap.png',
-  'images/frame.png',
-  'images/frames.png',
-  'images/gedit-shortcuts.png',
-  'images/getting-started-app10.png',
-  'images/getting-started-app1.png',
-  'images/getting-started-app2.png',
-  'images/getting-started-app3.png',
-  'images/getting-started-app4.png',
-  'images/getting-started-app6.png',
-  'images/getting-started-app7.png',
-  'images/getting-started-app8.png',
-  'images/getting-started-app9.png',
-  'images/glarea.png',
-  'images/gradient1.png',
-  'images/gradient2.png',
-  'images/gradient3.png',
-  'images/gradient4.png',
-  'images/grid.png',
-  'images/grid-packing.png',
-  'images/handles.png',
-  'images/headerbar.png',
-  'images/hello-world.png',
-  'images/icon-view.png',
-  'images/image.png',
-  'images/info-bar.png',
-  'images/inspector.png',
-  'images/label.png',
-  'images/layout-btlr.png',
-  'images/layout-btrl.png',
-  'images/layout-lrbt.png',
-  'images/layout-lrtb.png',
-  'images/layout-rlbt.png',
-  'images/layout-rltb.png',
-  'images/layout-tblr.png',
-  'images/layout-tbrl.png',
-  'images/left-center.png',
-  'images/left-end.png',
-  'images/left-start.png',
-  'images/levelbar.png',
-  'images/linear.png',
-  'images/link-button.png',
-  'images/list-and-tree.png',
-  'images/list-box.png',
-  'images/lockbutton-locked.png',
-  'images/lock-button.png',
-  'images/lockbutton.png',
-  'images/lockbutton-sorry.png',
-  'images/lockbutton-unlocked.png',
-  'images/media-controls.png',
-  'images/menu.png',
-  'images/menubar.png',
-  'images/menu-button.png',
-  'images/messagedialog.png',
-  'images/multiline-text.png',
-  'images/notebook.png',
-  'images/options.png',
-  'images/overlay.png',
-  'images/pagesetupdialog.png',
-  'images/panes.png',
-  'images/password-entry.png',
-  'images/picture.png',
-  'images/popover.png',
-  'images/printdialog.png',
-  'images/progressbar.png',
-  'images/right-center.png',
-  'images/right-end.png',
-  'images/right-start.png',
-  'images/scales.png',
-  'images/scrollbar.png',
-  'images/scrolledwindow.png',
-  'images/search-bar.png',
-  'images/search-entry.png',
-  'images/separator.png',
-  'images/shortcuts-window.png',
-  'images/sidebar.png',
-  'images/slices.png',
-  'images/sliders.png',
-  'images/spinbutton.png',
-  'images/spinner.png',
-  'images/stack.png',
-  'images/stackswitcher.png',
-  'images/statusbar.png',
-  'images/switch.png',
-  'images/toggle-button.png',
-  'images/toolbar.png',
-  'images/tree-view-coordinates.png',
-  'images/up-center.png',
-  'images/up-end.png',
-  'images/up-start.png',
-  'images/video.png',
-  'images/volumebutton.png',
-  'images/widget-hvalign.png',
-  'images/windowcontrols.png',
-  'images/window-default.png',
-  'images/window.png',
-  'images/rich-list.png',
-  'images/data-table.png',
-  'images/navigation-sidebar.png',
+  "images/aboutdialog.png",
+  "images/action-bar.png",
+  "images/appchooserbutton.png",
+  "images/appchooserdialog.png",
+  "images/arrows.png",
+  "images/assistant.png",
+  "images/background.png",
+  "images/bloatpad-gnome.png",
+  "images/bloatpad-osx.png",
+  "images/bloatpad-xfce.png",
+  "images/border1.png",
+  "images/border2.png",
+  "images/border3.png",
+  "images/box.png",
+  "images/box-expand.png",
+  "images/box-packing.png",
+  "images/builder-shortcuts.png",
+  "images/button.png",
+  "images/calendar.png",
+  "images/capture-bubble.png",
+  "images/centerbox.png",
+  "images/check-button.png",
+  "images/checks.png",
+  "images/clocks-shortcuts.png",
+  "images/color-button.png",
+  "images/colorchooser.png",
+  "images/combo-box-entry.png",
+  "images/combo-box.png",
+  "images/combo-box-text.png",
+  "images/down-center.png",
+  "images/down-end.png",
+  "images/down-start.png",
+  "images/drop-down.png",
+  "images/drawing.png",
+  "images/drawingarea.png",
+  "images/ease-in-out.png",
+  "images/ease-in.png",
+  "images/ease-out.png",
+  "images/ease.png",
+  "images/editable-label.png",
+  "images/emojichooser.png",
+  "images/entry.png",
+  "images/exampleapp.png",
+  "images/expanders.png",
+  "images/expander.png",
+  "images/extensions.png",
+  "images/figure-hierarchical-drawing.png",
+  "images/figure-windowed-label.png",
+  "images/file-button.png",
+  "images/filechooser.png",
+  "images/flow-box.png",
+  "images/focus.png",
+  "images/font-button.png",
+  "images/fontchooser.png",
+  "images/frame-gap.png",
+  "images/frame.png",
+  "images/frames.png",
+  "images/gedit-shortcuts.png",
+  "images/getting-started-app10.png",
+  "images/getting-started-app1.png",
+  "images/getting-started-app2.png",
+  "images/getting-started-app3.png",
+  "images/getting-started-app4.png",
+  "images/getting-started-app6.png",
+  "images/getting-started-app7.png",
+  "images/getting-started-app8.png",
+  "images/getting-started-app9.png",
+  "images/glarea.png",
+  "images/gradient1.png",
+  "images/gradient2.png",
+  "images/gradient3.png",
+  "images/gradient4.png",
+  "images/grid.png",
+  "images/grid-packing.png",
+  "images/handles.png",
+  "images/headerbar.png",
+  "images/hello-world.png",
+  "images/icon-view.png",
+  "images/image.png",
+  "images/info-bar.png",
+  "images/inspector.png",
+  "images/label.png",
+  "images/layout-btlr.png",
+  "images/layout-btrl.png",
+  "images/layout-lrbt.png",
+  "images/layout-lrtb.png",
+  "images/layout-rlbt.png",
+  "images/layout-rltb.png",
+  "images/layout-tblr.png",
+  "images/layout-tbrl.png",
+  "images/left-center.png",
+  "images/left-end.png",
+  "images/left-start.png",
+  "images/levelbar.png",
+  "images/linear.png",
+  "images/link-button.png",
+  "images/list-and-tree.png",
+  "images/list-box.png",
+  "images/lockbutton-locked.png",
+  "images/lock-button.png",
+  "images/lockbutton.png",
+  "images/lockbutton-sorry.png",
+  "images/lockbutton-unlocked.png",
+  "images/media-controls.png",
+  "images/menu.png",
+  "images/menubar.png",
+  "images/menu-button.png",
+  "images/messagedialog.png",
+  "images/multiline-text.png",
+  "images/notebook.png",
+  "images/options.png",
+  "images/overlay.png",
+  "images/pagesetupdialog.png",
+  "images/panes.png",
+  "images/password-entry.png",
+  "images/picture.png",
+  "images/popover.png",
+  "images/printdialog.png",
+  "images/progressbar.png",
+  "images/right-center.png",
+  "images/right-end.png",
+  "images/right-start.png",
+  "images/scales.png",
+  "images/scrollbar.png",
+  "images/scrolledwindow.png",
+  "images/search-bar.png",
+  "images/search-entry.png",
+  "images/separator.png",
+  "images/shortcuts-window.png",
+  "images/sidebar.png",
+  "images/slices.png",
+  "images/sliders.png",
+  "images/spinbutton.png",
+  "images/spinner.png",
+  "images/stack.png",
+  "images/stackswitcher.png",
+  "images/statusbar.png",
+  "images/switch.png",
+  "images/toggle-button.png",
+  "images/toolbar.png",
+  "images/tree-view-coordinates.png",
+  "images/up-center.png",
+  "images/up-end.png",
+  "images/up-start.png",
+  "images/video.png",
+  "images/volumebutton.png",
+  "images/widget-hvalign.png",
+  "images/windowcontrols.png",
+  "images/window-default.png",
+  "images/window.png",
+  "images/rich-list.png",
+  "images/data-table.png",
+  "images/navigation-sidebar.png",
 ]
diff --git a/docs/reference/gtk/meson.build b/docs/reference/gtk/meson.build
index a87f8054d2..f9e3f85142 100644
--- a/docs/reference/gtk/meson.build
+++ b/docs/reference/gtk/meson.build
@@ -1,174 +1,4 @@
-images = [
-  'images/aboutdialog.png',
-  'images/action-bar.png',
-  'images/appchooserbutton.png',
-  'images/appchooserdialog.png',
-  'images/arrows.png',
-  'images/assistant.png',
-  'images/background.png',
-  'images/bloatpad-gnome.png',
-  'images/bloatpad-osx.png',
-  'images/bloatpad-xfce.png',
-  'images/border1.png',
-  'images/border2.png',
-  'images/border3.png',
-  'images/box.png',
-  'images/box-expand.png',
-  'images/box-packing.png',
-  'images/builder-shortcuts.png',
-  'images/button.png',
-  'images/calendar.png',
-  'images/capture-bubble.png',
-  'images/centerbox.png',
-  'images/check-button.png',
-  'images/checks.png',
-  'images/clocks-shortcuts.png',
-  'images/color-button.png',
-  'images/colorchooser.png',
-  'images/combo-box-entry.png',
-  'images/combo-box.png',
-  'images/combo-box-text.png',
-  'images/down-center.png',
-  'images/down-end.png',
-  'images/down-start.png',
-  'images/drop-down.png',
-  'images/drawing.png',
-  'images/drawingarea.png',
-  'images/ease-in-out.png',
-  'images/ease-in.png',
-  'images/ease-out.png',
-  'images/ease.png',
-  'images/editable-label.png',
-  'images/emojichooser.png',
-  'images/entry.png',
-  'images/exampleapp.png',
-  'images/expanders.png',
-  'images/expander.png',
-  'images/extensions.png',
-  'images/figure-hierarchical-drawing.png',
-  'images/figure-windowed-label.png',
-  'images/file-button.png',
-  'images/filechooser.png',
-  'images/flow-box.png',
-  'images/focus.png',
-  'images/font-button.png',
-  'images/fontchooser.png',
-  'images/frame-gap.png',
-  'images/frame.png',
-  'images/frames.png',
-  'images/gedit-shortcuts.png',
-  'images/getting-started-app10.png',
-  'images/getting-started-app1.png',
-  'images/getting-started-app2.png',
-  'images/getting-started-app3.png',
-  'images/getting-started-app4.png',
-  'images/getting-started-app6.png',
-  'images/getting-started-app7.png',
-  'images/getting-started-app8.png',
-  'images/getting-started-app9.png',
-  'images/glarea.png',
-  'images/gradient1.png',
-  'images/gradient2.png',
-  'images/gradient3.png',
-  'images/gradient4.png',
-  'images/grid.png',
-  'images/grid-packing.png',
-  'images/handles.png',
-  'images/headerbar.png',
-  'images/hello-world.png',
-  'images/icon-view.png',
-  'images/image.png',
-  'images/info-bar.png',
-  'images/inspector.png',
-  'images/label.png',
-  'images/layout-btlr.png',
-  'images/layout-btrl.png',
-  'images/layout-lrbt.png',
-  'images/layout-lrtb.png',
-  'images/layout-rlbt.png',
-  'images/layout-rltb.png',
-  'images/layout-tblr.png',
-  'images/layout-tbrl.png',
-  'images/left-center.png',
-  'images/left-end.png',
-  'images/left-start.png',
-  'images/levelbar.png',
-  'images/linear.png',
-  'images/link-button.png',
-  'images/list-and-tree.png',
-  'images/list-box.png',
-  'images/lockbutton-locked.png',
-  'images/lock-button.png',
-  'images/lockbutton.png',
-  'images/lockbutton-sorry.png',
-  'images/lockbutton-unlocked.png',
-  'images/media-controls.png',
-  'images/menu.png',
-  'images/menubar.png',
-  'images/menu-button.png',
-  'images/messagedialog.png',
-  'images/multiline-text.png',
-  'images/notebook.png',
-  'images/options.png',
-  'images/overlay.png',
-  'images/pagesetupdialog.png',
-  'images/panes.png',
-  'images/password-entry.png',
-  'images/picture.png',
-  'images/popover.png',
-  'images/printdialog.png',
-  'images/progressbar.png',
-  'images/right-center.png',
-  'images/right-end.png',
-  'images/right-start.png',
-  'images/scales.png',
-  'images/scrollbar.png',
-  'images/scrolledwindow.png',
-  'images/search-bar.png',
-  'images/search-entry.png',
-  'images/separator.png',
-  'images/shortcuts-window.png',
-  'images/sidebar.png',
-  'images/slices.png',
-  'images/sliders.png',
-  'images/spinbutton.png',
-  'images/spinner.png',
-  'images/stack.png',
-  'images/stackswitcher.png',
-  'images/statusbar.png',
-  'images/switch.png',
-  'images/toggle-button.png',
-  'images/toolbar.png',
-  'images/tree-view-coordinates.png',
-  'images/up-center.png',
-  'images/up-end.png',
-  'images/up-start.png',
-  'images/video.png',
-  'images/volumebutton.png',
-  'images/widget-hvalign.png',
-  'images/windowcontrols.png',
-  'images/window-default.png',
-  'images/window.png',
-  'images/rich-list.png',
-  'images/data-table.png',
-  'images/navigation-sidebar.png'
-]
-
-content_files = [
-  'gtk4-broadwayd.xml',
-  'gtk4-builder-tool.xml',
-  'gtk4-demo-application.xml',
-  'gtk4-demo.xml',
-  'gtk4-encode-symbolic-svg.xml',
-  'gtk4-icon-browser.xml',
-  'gtk4-launch.xml',
-  'gtk4-query-settings.xml',
-  'gtk4-update-icon-cache.xml',
-  'gtk4-widget-factory.xml',
-  'overview.xml',
-  'visual_index.xml',
-]
-
+# XXX: gi-docgen needs a deps file
 expand_content_md_files = [
   'broadway.md',
   'osx.md',