diff options
| author | Jussi Pakkanen <jpakkane@gmail.com> | 2022-03-13 01:01:55 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2022-03-13 01:01:55 +0200 |
| commit | 69ade4f4cf0123b7c38476b2972290d3d2a76b93 (patch) | |
| tree | 76cd64e75748b8af0b7c7c85f0b1b7a9b1f4c523 /docs/yaml | |
| parent | bfdbf7bf6545236fa1077e3eea03a4f599c4cb8e (diff) | |
| parent | ff4c283b3ac29f9f0cf067ceac2b1348964baeee (diff) | |
| download | meson-69ade4f4cf0123b7c38476b2972290d3d2a76b93.tar.gz | |
Merge pull request #9339 from dcbaker/submit/structured_sources
Structured Sources
Diffstat (limited to 'docs/yaml')
| -rw-r--r-- | docs/yaml/functions/_build_target_base.yaml | 2 | ||||
| -rw-r--r-- | docs/yaml/functions/structured_sources.yaml | 21 | ||||
| -rw-r--r-- | docs/yaml/objects/structured_src.yaml | 3 |
3 files changed, 25 insertions, 1 deletions
diff --git a/docs/yaml/functions/_build_target_base.yaml b/docs/yaml/functions/_build_target_base.yaml index 88fb8ae19..87966f644 100644 --- a/docs/yaml/functions/_build_target_base.yaml +++ b/docs/yaml/functions/_build_target_base.yaml @@ -49,7 +49,7 @@ kwargs: eg: `cpp_args` for C++ sources: - type: str | file | custom_tgt | custom_idx | generated_list + type: str | file | custom_tgt | custom_idx | generated_list | structured_src description: Additional source files. Same as the source varargs. build_by_default: diff --git a/docs/yaml/functions/structured_sources.yaml b/docs/yaml/functions/structured_sources.yaml new file mode 100644 index 000000000..a5f0a83f3 --- /dev/null +++ b/docs/yaml/functions/structured_sources.yaml @@ -0,0 +1,21 @@ +name: structured_sources +returns: structured_src +since: 0.62.0 +description: | + Create a StructuredSource object, which is opaque and may be passed as a source + to any build_target (including static_library, shared_library, executable, + etc.). This is useful for languages like Rust, which use the filesystem layout + to determine import names. This is only allowed in Rust targets, and cannot be + mixed with non structured inputs. + +posargs: + root: + type: list[str | file | custom_tgt | custom_idx | generated_list] + description: Sources to put at the root of the generated structure + +optargs: + additional: + type: dict[str | file | custom_tgt | custom_idx | generated_list] + description: | + Additional sources, where the key is the directory under the root to place + the values diff --git a/docs/yaml/objects/structured_src.yaml b/docs/yaml/objects/structured_src.yaml new file mode 100644 index 000000000..839575d7c --- /dev/null +++ b/docs/yaml/objects/structured_src.yaml @@ -0,0 +1,3 @@ +name: structured_src +long_name: Structured Source +description: Opaque object returned by [[structured_sources]]. |