[Mesa-dev] [PATCH] Update the documentation for meson

[Matt Turner]

On Thu, Mar 1, 2018 at 11:34 AM, Dylan Baker <dylan at pnwbakers.com> wrote:
> Meson is pretty well tested and works in most configurations now, so we
> can remove the warning about it being unsuited for actual use.
>
> It's also worth documenting that meson 0.42.0 or greater is required.
>
> Signed-off-by: Dylan Baker <dylan.c.baker at intel.com>
> ---
>  docs/meson.html | 34 +++++++++++++++++++++-------------
>  1 file changed, 21 insertions(+), 13 deletions(-)
>
> diff --git a/docs/meson.html b/docs/meson.html
> index 77f89b0c6c7..782cc198649 100644
> --- a/docs/meson.html
> +++ b/docs/meson.html
> @@ -18,11 +18,20 @@
>
>  <h2 id="basic">1. Basic Usage</h2>
>
> -<p><strong>The Meson build system for Mesa is still under active development,
> -and should not be used in production environments.</strong></p>
> +<p><strong>The Meson build system is generally considered stable and ready
> +for production</strong></p>
>
> -<p>The meson build is currently only tested on linux, and is known to not work
> -on macOS, Windows, and haiku. This will be fixed.</p>
> +<p>The meson build is currently known to work on Linux, macOS, Cygwin, Haiku,
> +FreeBSD, DragonflyBSD, and NetBSD, it is believed to work on OpenBSD.</p>
> +
> +<p><strong>Mesa requires Meson >= 0.42.0 to build in general.</strong>
> +
> +Additionaly, to build the Clover OpenCL state tracker or the OpenSWR driver
> +meson 0.44.0 or greater is required.
> +
> +Some older versions of meson do not check that they are too old and will error
> +out in odd ways.
> +</p>
>
>  <p>
>  The meson program is used to configure the source directory and generates
> @@ -122,12 +131,11 @@ llvm-config, so using an LLVM from a non-standard path is as easy as
>  <dt><code>PKG_CONFIG_PATH</code></dt>
>  <dd><p>The
>  <code>pkg-config</code> utility is a hard requirement for configuring and
> -building Mesa on Linux and *BSD. 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>
> +building Mesa on Unix-like systems. 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>
>
> @@ -151,9 +159,9 @@ may interfer with debbugging as some code and validation will be optimized
>  away.
>  </p>
>
> -<p> For those wishing to pass their own -O option, use the "plain" buildtype,
> -which cuases meson to inject no additional compiler arguments, only those in

s/cuases/causes/