From 15a57e26c4d1123606a7ac455d2ccbce15e976b9 Mon Sep 17 00:00:00 2001
From: kcgen <1557255+kcgen@users.noreply.github.com>
Date: Mon, 28 Jun 2021 12:54:39 -0700
Subject: Add a bit more documentation regarding Meson options

---
 BUILD.md  | 21 +++++++++++++++++----
 README.md |  8 ++++++++
 2 files changed, 25 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
 
diff --git a/README.md b/README.md
index ec3fe1a8b..fa6076c9b 100644
--- a/README.md
+++ b/README.md
@@ -165,6 +165,14 @@ ninja -C build
 ./build/dosbox
 ```
 
+To build and link the MT-32 and FluidSynth subprojects statically,
+add the `-Ddefault_library=static` option during setup.
+
+To see all of Meson's setup options, run:
+``` shell
+meson configure
+```
+
 ### Windows - Visual Studio (2019 or newer)
 
 First, you need to setup [vcpkg] to install build dependencies. Once vcpkg
-- 
cgit v1.2.3