[Mesa-dev] [PATCH] docs: add documentation for building with meson

[Nicolai Hähnle]

On 17.10.2017 21:21, Dylan Baker wrote:
> +<dt><code>CC, CFLAGS, CXX, CXXFLAGS</code></dt>
> +<dd><p>These environment variables
> +control the C and C++ compilers used during the build. The default compilers
> +depends on your operating system. Meson supports GCC, Clang, and MSVC as first
> +class compilers. There is some support for the Intel ICC compiler. No other
> +C/C++ compilers are currently supported.
> +</dd>
> +
> +<dt><code>PKG_CONFIG_PATH</code></dt>
> +<dd><p>The
> +<code>pkg-config</code> utility is a hard requirement for configuring and
> +building mesa. It is used to search for external libraries
> +on the system. This environment variable is used to control the search
> +path for <code>pkg-config</code>. For instance, setting
> +<code>PKG_CONFIG_PATH=/usr/X11R6/lib/pkgconfig</code> will search for
> +package metadata in <code>/usr/X11R6</code> before the standard
> +directories.</p>
> +</dd>
> +</dl>

Not knowing Meson, how do environment variables like CFLAGS, CC, etc. 
work? Are they "latched" when calling `meson $builddir`? When calling 
`meson configure`? Both? Does setting them have an effect when calling 
`ninja`?

Some examples would be helpful.

Thanks,
Nicolai

> +
> +<p>
> +One of the oddities of meson is that some options are different when passed to
> +the initial meson step than to meson configure. These options are passed as
> +--option=foo to meson, but -Doption=foo to meson configure. Project defined
> +options are always passed as -Doption=foo.
> +<p>
> +
> +<p>For those coming from autotools be aware of the following:</p>
> +
> +<dl>
> +<dt><code>--buildtype/-Dbuildtype</code></dt>
> +<dd><p>This option will set the compiler debug/optimisation levels (if the user
> +hasn't already set them via the CFLAGS/CXXFLAGS) and macros to aid in
> +debugging the Mesa libraries.</p>
> +
> +<p>Note that in meson this defaults to "debug", and  not setting it to
> +"release" will yield non-optimal performance and binary size</p>
> 
> 
> 
> _______________________________________________
> mesa-dev mailing list
> mesa-dev at lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/mesa-dev
> 


-- 
Lerne, wie die Welt wirklich ist,
Aber vergiss niemals, wie sie sein sollte.