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>
This commit is contained in:
Dylan Baker
2018-09-18 09:07:25 -07:00
parent 1da60667b5
commit e0829f9c1a

View File

@@ -99,29 +99,29 @@ recommended in the documentation</a>
<dt><code>Environment Variables</code></dt> <dt><code>Environment Variables</code></dt>
<dd><p>Meson supports the standard CC and CXX environment variables for <dd><p>Meson supports the standard CC and CXX environment variables for
changing the default compiler, and CFLAGS, CXXFLAGS, and LDFLAGS for setting 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 These arguments are consumed and stored by meson when it is initialized. To
the popular compilers, a complete list is available change these flags after the build is initialized (or when doing a first
<a href="http://mesonbuild.com/Reference-tables.html#compiler-ids">here</a>. initialization), consider using <code>-D${lang}_args</code> and
<code>-D${lang}_link_args</code> instead. Meson will never change compiler in a
These arguments are consumed and stored by meson when it is initialized or configured build directory.
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.
</p> </p>
<pre> <pre>
CC=clang CXX=clang++ meson build-clang CC=clang CXX=clang++ meson build-clang
ninja -C build-clang ninja -C build-clang
ninja -C build-clang clean ninja -C build-clang clean
touch meson.build meson configure build -Dc_args="-Wno-typedef-redefinition"
CFLAGS=-Wno-typedef-redefinition ninja -C build-clang ninja -C build-clang
</pre> </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> <p>Meson also honors <code>DESTDIR</code> for installs</p>
</dd> </dd>