docs/meson: mention how to use array options
authorEric Engestrom <eric.engestrom@intel.com>
Mon, 14 May 2018 15:39:42 +0000 (16:39 +0100)
committerEric Engestrom <eric.engestrom@intel.com>
Fri, 1 Jun 2018 16:53:06 +0000 (17:53 +0100)
Signed-off-by: Eric Engestrom <eric.engestrom@intel.com>
docs/meson.html

index f394a22fc2a7d058828ebfe363d1c81e09189c4b..29907a60a9cb02975065916e9bb24fbc7655c373 100644 (file)
@@ -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