From 32dbdff3b2d37d1ec7ef976c0b4f30d1d0472e70 Mon Sep 17 00:00:00 2001
From: Paolo Bonzini <pbonzini@redhat.com>
Date: Thu, 22 Jul 2021 13:03:44 +0200
Subject: docs: document new behavior with respect to mixed language link tests

---
 .../snippets/mixed_language_linker_tests.md         | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 docs/markdown/snippets/mixed_language_linker_tests.md

(limited to 'docs/markdown/snippets')

diff --git a/docs/markdown/snippets/mixed_language_linker_tests.md b/docs/markdown/snippets/mixed_language_linker_tests.md
new file mode 100644
index 0000000..8b94edb
--- /dev/null
+++ b/docs/markdown/snippets/mixed_language_linker_tests.md
@@ -0,0 +1,21 @@
+== Link tests can use sources for a different compiler ==
+
+Usually, the `links` method of the compiler object uses a single program
+invocation to do both compilation and linking.  Starting with this version,
+whenever the argument to `links` is a file, Meson will check if the file
+suffix matches the compiler object's language.  If they do not match,
+as in the following case:
+
+```
+cxx = meson.get_compiler('cpp')
+cxx.links(files('test.c'))
+```
+
+then Meson will separate compilation and linking.  In the above example
+`test.c` will be compiled with a C compiler and the resulting object file
+will be linked with a C++ compiler.  This makes it possible to detect
+misconfigurations of the compilation environment, for example when the
+C++ runtime is not compatible with the one expected by the C compiler.
+
+For this reason, passing file arguments with an unrecognized suffix to
+`links` will cause a warning.
-- 
cgit v1.1