Add a bit more documentation regarding Meson optionsv0.77.0

1 files changed, 17 insertions, 4 deletions

diff --git a/BUILD.md b/BUILD.md
index e65cc8e1f..ccff9f2e0 100644
--- a/BUILD.md
+++ b/BUILD.md
@@ -59,11 +59,24 @@ meson setup -Duse_opengl=false build
 ninja -C build
 ```
 
-See file [`meson_options.txt`](meson_options.txt) for list of all available
-project-specific build options.
+### List Meson's setup options
+
+Run `meson configure` to see the full list of Meson setup options as well
+as project-specific options. Or, see the file
+[`meson_options.txt`](meson_options.txt) for only the project-specific
+options.
+
+To query the options set in an existing build directory, simply append
+the build directory to the above command. For example:
+
+``` shell
+meson configure build
+```
+
+Options can be passed to the `meson setup` command using `-Doption=value`
+notation or using comma-separated notation (ie: `-Doption=value1,value2,value3`)
+when the option supports multiple values.
 
-You can also run `meson configure` to see the list of *all* available
-build options (including project-specific ones).
 
 ### Run unit tests