diff options
Diffstat (limited to 'docs/markdown')
| -rw-r--r-- | docs/markdown/howtox.md | 15 | ||||
| -rw-r--r-- | docs/markdown/snippets/env_vars_and_cross.md | 10 |
2 files changed, 13 insertions, 12 deletions
diff --git a/docs/markdown/howtox.md b/docs/markdown/howtox.md index 8231d3d..ee7fc9c 100644 --- a/docs/markdown/howtox.md +++ b/docs/markdown/howtox.md @@ -12,15 +12,16 @@ When first running Meson, set it in an environment variable. $ CC=mycc meson <options> ``` -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 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 are never the idiomatic way to do anything with -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. +Meson, however. It is better to use the native and cross files. 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 61a63f3..f4340de 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_FOR_BUILD` is used for the build platform in 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. 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 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. +environment variables are supported at all in Meson. The new behavior is +consistent. |