aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/snippets
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2019-04-01 01:29:51 +0300
committerGitHub <noreply@github.com>2019-04-01 01:29:51 +0300
commit5905533fcd7fb9663023e6cf98d95667620d2f12 (patch)
tree49ed83ebd7c34cfe1a676ac9607c609283349db3 /docs/markdown/snippets
parente3e83e2acdec877c527b36542fc64867c5943f77 (diff)
parent2259db2683d9e60c727ce847d1da7a759b190006 (diff)
downloadmeson-5905533fcd7fb9663023e6cf98d95667620d2f12.zip
meson-5905533fcd7fb9663023e6cf98d95667620d2f12.tar.gz
meson-5905533fcd7fb9663023e6cf98d95667620d2f12.tar.bz2
Merge pull request #5103 from mesonbuild/linkcustom
Can link against custom targets
Diffstat (limited to 'docs/markdown/snippets')
-rw-r--r--docs/markdown/snippets/linkcustom.md16
1 files changed, 16 insertions, 0 deletions
diff --git a/docs/markdown/snippets/linkcustom.md b/docs/markdown/snippets/linkcustom.md
new file mode 100644
index 0000000..d6ee801
--- /dev/null
+++ b/docs/markdown/snippets/linkcustom.md
@@ -0,0 +1,16 @@
+## Can link against custom targets
+
+The output of `custom_target` can be used in `link_with` and
+`link_whole` keyword arguments. This is useful for integrating custom
+code generator steps, but note that there are many limitations:
+
+ - Meson can not know about link dependencies of the custom target. If
+ the target requires further link libraries, you need to add them manually
+
+ - The user is responsible for ensuring that the code produced by
+ different toolchains are compatible.
+
+ - The custom target can only have one output file.
+
+ - The output file must have the correct file name extension.
+