Debian Codegraph @

subprojects/meson-docs/docs/yaml/functions/subdir.yaml

raw
1 name: subdir
2 returns: void
3 description: |
4 Enters the specified subdirectory and executes the `meson.build` file in it.
5 Once that is done, it returns and execution continues on the
6 line following this `subdir()` command. Variables defined in that
7 `meson.build` file are then available for use in later parts of the
8 current build file and in all subsequent build files executed with
9 `subdir()`.
10
11 Note that this means that each `meson.build` file in a source tree can
12 and must only be executed once.
13
14 posargs:
15 dir_name:
16 type: str
17 description: |
18 Directory relative to the current `meson.build` to enter.
19
20 Cannot contain `..`
21
22 kwargs:
23 if_found:
24 type: list[dep]
25 since: 0.44.0
26 description: Only enter the subdir if all [[dep.found]] methods return `true`.