Allow setting project options from cross or native files

This allows adding a `[project options]` section to a cross or native file
that contains the options defined for a project in it's meson_option.txt
file.

1 files changed, 20 insertions, 0 deletions

diff --git a/docs/markdown/Machine-files.md b/docs/markdown/Machine-files.md
index 9011f79..26af44a 100644
--- a/docs/markdown/Machine-files.md
+++ b/docs/markdown/Machine-files.md
@@ -12,6 +12,7 @@ The following sections are allowed:
 - binaries
 - paths
 - properties
+- project options
 
 ### constants
 
@@ -166,6 +167,25 @@ section may contain random key value pairs accessed using the
 The properties section can contain any variable you like, and is accessed via
 `meson.get_external_property`, or `meson.get_cross_property`.
 
+### Project specific options
+
+*New in 0.54.0*
+
+Being able to set project specific options in a native or cross files can be
+done using the `[project options]` section of the specific file (if doing a
+cross build the options from the native file will be ignored)
+
+For setting options in supbprojects use the `<subproject>:project options`
+section instead.
+
+```ini
+[project options]
+build-tests = true
+
+[zlib:project options]
+build-tests = false
+```
+
 ## Loading multiple machine files
 
 Native files allow layering (cross files can be layered since meson 0.52.0).