From f1435a2e180296a66dd2529cfa5900e712812ca4 Mon Sep 17 00:00:00 2001
From: Adrian Perez de Castro <aperez@igalia.com>
Date: Wed, 12 Feb 2025 18:55:11 +0200
Subject: [PATCH] meson: Use a generated depfile for gi-docgen

Convert the output from "gi-docgen gen-deps", which is a list of files
ingested to generate the documentation, into a format suitable to be
read by Ninja (a Make snippet), and use it as the "depfile" for the
documentation custom target. The transformation is done using a small
Python script, which does not introduce any new dependency because
gi-docgen itself already required Python to be present.
---
 data/depfile.py  | 13 +++++++++++++
 docs/meson.build | 37 +++++++++++++++++++++++++------------
 2 files changed, 38 insertions(+), 12 deletions(-)
 create mode 100644 data/depfile.py

diff --git a/data/depfile.py b/data/depfile.py
new file mode 100644
index 00000000..b06e8a49
--- /dev/null
+++ b/data/depfile.py
@@ -0,0 +1,13 @@
+#! /usr/bin/env python3
+
+import sys
+
+if len(sys.argv) < 4:
+    raise SystemExit(f"Usage: {sys.argv[0]} input output target [targets...]")
+
+with open(sys.argv[1], "r") as inp:
+    with open(sys.argv[2], "w") as out:
+        deps = set((line.strip() for line in inp.readlines()))
+        print("# Automatically generated, do not edit!", file=out)
+        print(" ".join(sys.argv[3:]), ": \\", file=out)
+        print(" \\\n".join(deps), file=out)
diff --git a/docs/meson.build b/docs/meson.build
index aa10af1d..c9846d34 100644
--- a/docs/meson.build
+++ b/docs/meson.build
@@ -1,15 +1,6 @@
 gi_docgen_exe = find_program('gi-docgen', 'gi-docgen.py', native: true)
 
-# XXX: gi-docgen needs to be able to spit out a depfile.
-docs_md = [
-    'contributing.md',
-    'overview.md',
-    'platform-drm.md',
-    'platform-headless.md',
-    'platform-wl.md',
-    'platform-x11.md',
-    'webdriver.md',
-]
+python3_exe = import('python').find_installation('python3')
 
 docs_toml = configure_file(
     configuration: {
@@ -38,11 +29,33 @@ gi_outputs = import('gnome').generate_gir(
 )
 gi_cogcore_gir = gi_outputs[0]
 
+docs_dependencies_list = custom_target('docs-deps',
+    input: [docs_toml, gi_cogcore_gir],
+    output: ['cog-docs.deps'],
+    command: [gi_docgen_exe, 'gen-deps',
+        '--quiet',
+        '--content-dir', '@CURRENT_SOURCE_DIR@',
+        '--config', '@INPUT0@',
+        '@INPUT1@',
+        '@OUTPUT@',
+    ],
+)
+
+docs_depfile = custom_target('docs-depfile',
+    input: [docs_dependencies_list],
+    output: ['cog-docs.d'],
+    command: [python3_exe, join_paths(meson.source_root(), 'data', 'depfile.py'),
+        '@INPUT@',
+        '@OUTPUT@',
+        'cog-docs.d', 'html'
+    ],
+)
+
 custom_target('docs',
     build_by_default: true,
-    input: [docs_toml, gi_cogcore_gir],
+    input: [docs_toml, gi_cogcore_gir, docs_depfile],
     output: 'html',
-    depend_files: docs_md,
+    depfile: 'cog-docs.d',
     command: [gi_docgen_exe, 'generate',
         '--quiet',
         '--no-namespace-dir',