From 57fbc2ac5023d281b8134f4da4da821a7ae405f8 Mon Sep 17 00:00:00 2001
From: Eric Engestrom <eric.engestrom@intel.com>
Date: Mon, 14 May 2018 16:39:42 +0100
Subject: [PATCH] docs/meson: mention how to use array options

Signed-off-by: Eric Engestrom <eric.engestrom@intel.com>
---
 docs/meson.html | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/meson.html b/docs/meson.html
index f394a22fc2a..29907a60a9c 100644
--- a/docs/meson.html
+++ b/docs/meson.html
@@ -67,6 +67,14 @@ command are in the form <code>-D "command"="value"</code>.
     meson configure build/ -Dprefix=/tmp/install -Dglx=true
 </pre>
 
+<p>
+Note that options taking lists (such as <code>platforms</code>) are
+<a href="http://mesonbuild.com/Build-options.html#using-build-options">a bit
+more complicated</a>, but the simplest form compatible with Mesa options
+is to use a comma to separate values (<code>-D platforms=drm,wayland</code>)
+and brackets to represent an empty list (<code>-D platforms=[]</code>).
+</p>
+
 <p>
 Once you've run the initial <code>meson</code> command successfully you can use
 your configured backend to build the project. With ninja, the -C option can be
-- 
2.30.2