summary refs log tree commit diff stats
path: root/scripts/meson-buildoptions.py
diff options
context:
space:
mode:
authorPaolo Bonzini <pbonzini@redhat.com>2023-09-28 11:20:01 +0200
committerPaolo Bonzini <pbonzini@redhat.com>2023-10-18 10:01:02 +0200
commit79fccf7e2bd792e20f2ceab9b5a30d9f47dbf409 (patch)
treeebc8a7c59b7d57cabde10cb6418a4508203904b7 /scripts/meson-buildoptions.py
parente20d68aa0b9546655c4017fb7341173bba825958 (diff)
downloadfocaccia-qemu-79fccf7e2bd792e20f2ceab9b5a30d9f47dbf409.tar.gz
focaccia-qemu-79fccf7e2bd792e20f2ceab9b5a30d9f47dbf409.zip
meson-buildoptions: document the data at the top
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
Diffstat (limited to 'scripts/meson-buildoptions.py')
-rw-r--r--scripts/meson-buildoptions.py8
1 files changed, 8 insertions, 0 deletions
diff --git a/scripts/meson-buildoptions.py b/scripts/meson-buildoptions.py
index 2e88732a29..4814a8ff61 100644
--- a/scripts/meson-buildoptions.py
+++ b/scripts/meson-buildoptions.py
@@ -25,11 +25,15 @@ import textwrap
 import shlex
 import sys
 
+# Options with nonstandard names (e.g. --with/--without) or OS-dependent
+# defaults.  Try not to add any.
 SKIP_OPTIONS = {
     "default_devices",
     "fuzzing_engine",
 }
 
+# Options whose name doesn't match the option for backwards compatibility
+# reasons, because Meson gives them a funny name, or both
 OPTION_NAMES = {
     "b_coverage": "gcov",
     "b_lto": "lto",
@@ -49,6 +53,10 @@ AUTO_OPTIONS = {
     "werror",
 }
 
+# Builtin options that should be definable via configure.  Some of the others
+# we really do not want (e.g. c_args is defined via the native file, not
+# via -D, because it's a mix of CFLAGS and --extra-cflags); for specific
+# cases "../configure -D" can be used as an escape hatch.
 BUILTIN_OPTIONS = {
     "b_coverage",
     "b_lto",