aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2020-03-23 18:07:24 +0200
committerJussi Pakkanen <jpakkane@gmail.com>2020-03-23 18:07:24 +0200
commit7924e5f9c20017a0ad7df6ee1cdb540d8a98dff7 (patch)
tree8f0637e630777cc4a5707c16a30c4d980b888371 /docs/markdown
parent097dfc085e6a1bb3c670880134a52dcfca504be7 (diff)
downloadmeson-7924e5f9c20017a0ad7df6ee1cdb540d8a98dff7.zip
meson-7924e5f9c20017a0ad7df6ee1cdb540d8a98dff7.tar.gz
meson-7924e5f9c20017a0ad7df6ee1cdb540d8a98dff7.tar.bz2
Revert "Naturally use env vars a bit more to match Autoconf"
This reverts commit 097dfc085e6a1bb3c670880134a52dcfca504be7.
Diffstat (limited to 'docs/markdown')
-rw-r--r--docs/markdown/howtox.md15
-rw-r--r--docs/markdown/snippets/env_vars_and_cross.md10
2 files changed, 12 insertions, 13 deletions
diff --git a/docs/markdown/howtox.md b/docs/markdown/howtox.md
index ee7fc9c..8231d3d 100644
--- a/docs/markdown/howtox.md
+++ b/docs/markdown/howtox.md
@@ -12,16 +12,15 @@ When first running Meson, set it in an environment variable.
$ CC=mycc meson <options>
```
-Note that environment variables like `CC` only refer to the host platform in
-cross builds. That is, the `CC` refers compiler used to compile programs that
-run on the machine we will eventually install the project on. The compiler used
-to build things that run on the machine we do the building can be specified
-with `CC_FOR_BUILD`. You can always used `CC_FOR_BUILD`, but for native builds
-it is less well known because Meson (and Autotools) will default `CC_FOR_BUILD`
-with `CC`.
+Note that environment variables like `CC` only works in native builds. The `CC`
+refers to the compiler for the host platform, that is the compiler used to
+compile programs that run on the machine we will eventually install the project
+on. The compiler used to build things that run on the machine we do the
+building can be specified with `CC_FOR_BUILD`. You can use it in cross builds.
Note that environment variables are never the idiomatic way to do anything with
-Meson, however. It is better to use the native and cross files.
+Meson, however. It is better to use the native and cross files. And the tools
+for the host platform in cross builds can only be specified with a cross file.
There is a table of all environment variables supported [Here](Reference-tables.md#compiler-and-linker-selection-variables)
diff --git a/docs/markdown/snippets/env_vars_and_cross.md b/docs/markdown/snippets/env_vars_and_cross.md
index f4340de..61a63f3 100644
--- a/docs/markdown/snippets/env_vars_and_cross.md
+++ b/docs/markdown/snippets/env_vars_and_cross.md
@@ -2,11 +2,11 @@
Previously in Meson, variables like `CC` effected both the host and build
platforms for native builds, but the just the build platform for cross builds.
-Now `CC` always effects the host platform, and `CC_FOR_BUILD` always affects
-the build platform, with `CC` also effecting the build platform for native
-builds only when `CC_FOR_BUILD` is not defined.
+Now `CC_FOR_BUILD` is used for the build platform in cross builds.
This old behavior is inconsistent with the way Autotools works, which
undermines the purpose of distro-integration that is the only reason
-environment variables are supported at all in Meson. The new behavior is
-consistent.
+environment variables are supported at all in Meson. The new behavior is not
+quite the same, but doesn't conflict: meson doesn't always repond to an
+environment when Autoconf would, but when it does it interprets it as Autotools
+would.