summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDylan Baker <dylan@pnwbakers.com>2018-09-18 09:07:25 -0700
committerDylan Baker <dylan@pnwbakers.com>2018-09-21 10:03:15 -0700
commite0829f9c1a1e92e26002d34d20b7a65e75af2547 (patch)
tree385f04ba9be2e0956e5f7bc0e543313da81c5260 /docs
parent1da60667b527bc78bfe9b23ae5c0078b11e18b31 (diff)
docs/meson: Update notes on using CFLAGS and -Dc_args
v2: - Use ${} to denote variables instead of just $ - fix spelling error bugzilla: https://bugs.freedesktop.org/show_bug.cgi?id=107313 Reviewed-by: Eric Engestrom <eric.engestrom@intel.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/meson.html28
1 files changed, 14 insertions, 14 deletions
diff --git a/docs/meson.html b/docs/meson.html
index ea8fc985982..dcad062c0a1 100644
--- a/docs/meson.html
+++ b/docs/meson.html
@@ -99,29 +99,29 @@ recommended in the documentation</a>
<dt><code>Environment Variables</code></dt>
<dd><p>Meson supports the standard CC and CXX environment variables for
changing the default compiler, and CFLAGS, CXXFLAGS, and LDFLAGS for setting
-options to the compiler and linker.
+options to the compiler and linker during the initial configuration.
-The default compilers depends on your operating system. Meson supports most of
-the popular compilers, a complete list is available
-<a href="http://mesonbuild.com/Reference-tables.html#compiler-ids">here</a>.
-
-These arguments are consumed and stored by meson when it is initialized or
-re-initialized. Therefore passing them to meson configure will not do anything,
-and passing them to ninja will only do something if ninja decides to
-re-initialize meson, for example, if a meson.build file has been changed.
-Changing these variables will not cause all targets to be rebuilt, so running
-ninja clean is recommended when changing CFLAGS or CXXFLAGS. Meson will never
-change compiler in a configured build directory.
+These arguments are consumed and stored by meson when it is initialized. To
+change these flags after the build is initialized (or when doing a first
+initialization), consider using <code>-D${lang}_args</code> and
+<code>-D${lang}_link_args</code> instead. Meson will never change compiler in a
+configured build directory.
</p>
<pre>
CC=clang CXX=clang++ meson build-clang
ninja -C build-clang
ninja -C build-clang clean
- touch meson.build
- CFLAGS=-Wno-typedef-redefinition ninja -C build-clang
+ meson configure build -Dc_args="-Wno-typedef-redefinition"
+ ninja -C build-clang
</pre>
+<p>
+The default compilers depends on your operating system. Meson supports most of
+the popular compilers, a complete list is available
+<a href="http://mesonbuild.com/Reference-tables.html#compiler-ids">here</a>.
+</p>
+
<p>Meson also honors <code>DESTDIR</code> for installs</p>
</dd>