aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/gendeps.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/markdown/snippets/gendeps.md b/docs/markdown/snippets/gendeps.md
new file mode 100644
index 0000000..e724994
--- /dev/null
+++ b/docs/markdown/snippets/gendeps.md
@@ -0,0 +1,16 @@
+## Generators have a new `depends` keyword argument
+
+Generators can now specify extra dependencies with the `depends`
+keyword argument. It matches the behaviour of the same argument in
+other functions and specifies that the given targets must be built
+before the generator can be run. This is used in cases such as this
+one where you need to tell a generator to indirectly invoke a
+different program.
+
+```meson
+exe = executable(...)
+cg = generator(program_runner,
+ output: ['@BASENAME@.c'],
+ arguments: ['--use-tool=' + exe.full_path(), '@INPUT@', '@OUTPUT@'],
+ depends: exe)
+```