aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/Reference-manual.md
diff options
context:
space:
mode:
authorNirbheek Chauhan <nirbheek@centricular.com>2018-12-05 08:03:41 +0530
committerNirbheek Chauhan <nirbheek.chauhan@gmail.com>2018-12-05 02:40:34 +0000
commitc502ddfebfdffe1a8bfa84d15fe782b5e98af5e4 (patch)
tree9d8ee4d82895cb9a599dffb706eefa0447ad72aa /docs/markdown/Reference-manual.md
parentfebd3e8524a2ca63f4728a51c5edd19451d6c5fc (diff)
downloadmeson-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/markdown/Reference-manual.md')
-rw-r--r--docs/markdown/Reference-manual.md9
1 files changed, 9 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).