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