aboutsummaryrefslogtreecommitdiff
path: root/docs/yaml/functions/project.yaml
diff options
context:
space:
mode:
Diffstat (limited to 'docs/yaml/functions/project.yaml')
-rw-r--r--docs/yaml/functions/project.yaml22
1 files changed, 13 insertions, 9 deletions
diff --git a/docs/yaml/functions/project.yaml b/docs/yaml/functions/project.yaml
index 5be8cac..0db8c03 100644
--- a/docs/yaml/functions/project.yaml
+++ b/docs/yaml/functions/project.yaml
@@ -13,9 +13,9 @@ description: |
would probably want to use the name _libfoobar_ instead of _The Foobar
Library_.
- It may be followed by the list of programming languages that the project uses.
+ It may be followed by the array of programming languages that the project uses.
- *(since 0.40.0)* The list of languages is optional.
+ *(since 0.40.0)* The array of languages is optional.
These languages may be used both for `native: false` (the default)
(host machine) targets and for `native: true` (build machine) targets.
@@ -24,7 +24,7 @@ description: |
Supported values for languages are `c`, `cpp` (for `C++`), `cuda`,
`cython`, `d`, `objc`, `objcpp`, `fortran`, `java`, `cs` (for `C#`),
- `vala` and `rust`.
+ `swift`, `nasm`, `masm`, `linearasm`, `vala` and `rust`.
posargs:
project_name:
@@ -38,22 +38,26 @@ varargs:
kwargs:
default_options:
- type: list[str] | dict[str | bool | int | list[str]]
+ type: array[str] | dict[str | bool | int | array[str]]
description: |
Accepts strings in the form `key=value`
which have the same format as options to `meson configure`.
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:
@@ -72,7 +76,7 @@ kwargs:
Usually something like `>=0.28.0`.
license:
- type: str | list[str]
+ type: str | array[str]
description: |
Takes a string or array of strings describing the license(s) the code is under.
@@ -94,7 +98,7 @@ kwargs:
value in your Meson build files with `meson.project_license()`.
license_files:
- type: str | list[str]
+ type: str | array[str]
since: 1.1.0
description: |
Takes a string or array of strings with the paths to the license file(s)