From 27d5ae8a5f6a31d4a330f08e47839955f7111287 Mon Sep 17 00:00:00 2001 From: Paolo Bonzini Date: Sat, 21 Jun 2025 16:36:11 +0200 Subject: docs: update project(default_options: ...) for 1.8 changes Signed-off-by: Paolo Bonzini --- docs/yaml/functions/project.yaml | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) (limited to 'docs') diff --git a/docs/yaml/functions/project.yaml b/docs/yaml/functions/project.yaml index 5be8caccc..25ea9b9f4 100644 --- a/docs/yaml/functions/project.yaml +++ b/docs/yaml/functions/project.yaml @@ -45,15 +45,19 @@ kwargs: For example to set the default project type you would set this: `default_options : ['buildtype=debugoptimized']`. Note that these settings are only used when running Meson for the first - time. Global options such as `buildtype` can only be specified in - the master project, settings in subprojects are ignored. Project - specific options are used normally even in subprojects. + time. Note that some options can override the default behavior; for example, using `c_args` here means that the `CFLAGS` environment variable is not used. Consider using [[add_project_arguments()]] instead. + Also note that not all options are taken into account when + building as a subproject, and the exact set of options + that are per-subproject has increased over time; for more + information, see [core options](Builtin-options.md#core-options) + and [compiler options](Builtin-options.md#compiler-options). + *(since 1.2.0)*: A dictionary may now be passed. version: -- cgit v1.2.3