diff options
author | Nirbheek Chauhan <nirbheek@centricular.com> | 2018-12-05 08:03:41 +0530 |
---|---|---|
committer | Nirbheek Chauhan <nirbheek.chauhan@gmail.com> | 2018-12-05 02:40:34 +0000 |
commit | c502ddfebfdffe1a8bfa84d15fe782b5e98af5e4 (patch) | |
tree | 9d8ee4d82895cb9a599dffb706eefa0447ad72aa /docs | |
parent | febd3e8524a2ca63f4728a51c5edd19451d6c5fc (diff) | |
download | meson-c502ddfebfdffe1a8bfa84d15fe782b5e98af5e4.zip meson-c502ddfebfdffe1a8bfa84d15fe782b5e98af5e4.tar.gz meson-c502ddfebfdffe1a8bfa84d15fe782b5e98af5e4.tar.bz2 |
docs: Document subproject(... required: false) [skip ci]
Somehow this was missed in the original PR #3885
Diffstat (limited to 'docs')
-rw-r--r-- | docs/markdown/Reference-manual.md | 9 | ||||
-rw-r--r-- | docs/markdown/Release-notes-for-0.48.0.md | 6 |
2 files changed, 15 insertions, 0 deletions
diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md index 5cd24b7..5ebac4a 100644 --- a/docs/markdown/Reference-manual.md +++ b/docs/markdown/Reference-manual.md @@ -1356,6 +1356,12 @@ arguments: - `version` keyword argument that works just like the one in `dependency`. It specifies what version the subproject should be, as an example `>=1.0.1` + - `required` *(added 0.48.0)* By default, `required` is `true` and + Meson will abort if the subproject could not be setup. You can set + this to `false` and then use the `.found()` method on the [returned + object](#subproject-object). You may also pass the value of a + [`feature`](Build-options.md#features) option, same as + [`dependency()`](#dependency). Note that you can use the returned [subproject object](#subproject-object) to access any variable in the @@ -2199,6 +2205,9 @@ an executable (e.g. `idl` files into source code and headers). This object is returned by [`subproject()`](#subproject) and is an opaque object representing it. +- `found()` *(added 0.48.0)* which returns whether the subproject was + successfully setup + - `get_variable(name)` fetches the specified variable from inside the subproject. This is useful to, for instance, get a [declared dependency](#declare_dependency) from the [subproject](Subprojects.md). diff --git a/docs/markdown/Release-notes-for-0.48.0.md b/docs/markdown/Release-notes-for-0.48.0.md index 99673a4..270a689 100644 --- a/docs/markdown/Release-notes-for-0.48.0.md +++ b/docs/markdown/Release-notes-for-0.48.0.md @@ -305,3 +305,9 @@ To enable this, the following needs to be added to the `.wrap` file: ```ini clone-recursive=true ``` + +## `subproject()` function now supports the `required:` kwarg + +This allows you to declare an optional subproject. You can now call `found()` +on the return value of the `subproject()` call to see if the subproject is +available before calling `get_variable()` to fetch information from it. |