aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2019-04-02 00:40:05 +0300
committerGitHub <noreply@github.com>2019-04-02 00:40:05 +0300
commit75219989ca468923142738d93df8aef64e897b8e (patch)
tree225bab977e67835540dddc8f0506f51378e861f5 /docs
parent663517d23376809fd6bc0b69549ee823a06682d7 (diff)
parenta4b2fbc807e2459f50dc43950753737f558e782b (diff)
downloadmeson-75219989ca468923142738d93df8aef64e897b8e.zip
meson-75219989ca468923142738d93df8aef64e897b8e.tar.gz
meson-75219989ca468923142738d93df8aef64e897b8e.tar.bz2
Merge pull request #5128 from Ericson2314/sanity-check-with-flags
Sanity check with external args
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/snippets/sanity-check.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/markdown/snippets/sanity-check.md b/docs/markdown/snippets/sanity-check.md
new file mode 100644
index 0000000..d5ed80d
--- /dev/null
+++ b/docs/markdown/snippets/sanity-check.md
@@ -0,0 +1,17 @@
+## Sanity checking compilers with user flags
+
+Sanity checks previously only used user-specified flags for cross compilers, but
+now do in all cases.
+
+All compilers meson might decide to use for the build are "sanity checked"
+before other tests are run. This usually involves building simple executable and
+trying to run it. Previously user flags (compilation and/or linking flags) were
+used for sanity checking cross compilers, but not native compilers. This is
+because such flags might be essential for a cross binary to succeed, but usually
+aren't for a native compiler.
+
+In recent releases, there has been an effort to minimize the special-casing of
+cross or native builds so as to make building more predictable in less-tested
+cases. Since this the user flags are necessary for cross, but not harmful for
+native, it makes more sense to use them in all sanity checks than use them in no
+sanity checks, so this is what we now do.