aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJussi Pakkanen <jpakkane@gmail.com>2018-04-20 00:58:08 +0300
committerGitHub <noreply@github.com>2018-04-20 00:58:08 +0300
commit2b3562cc3ad6ac4e98de2c866fbacb009c2fcc69 (patch)
tree355e149fa3d839ba2fcff0c8edadb01fe6b694eb /docs
parent11ebe0bfee31eeacec3d06d95dbc420079d67696 (diff)
parent9a82b0136a6b9cd9d2000342a0506b7c8bf4897d (diff)
downloadmeson-2b3562cc3ad6ac4e98de2c866fbacb009c2fcc69.zip
meson-2b3562cc3ad6ac4e98de2c866fbacb009c2fcc69.tar.gz
meson-2b3562cc3ad6ac4e98de2c866fbacb009c2fcc69.tar.bz2
Merge pull request #3404 from xclaesse/extract-recursive
extract_all_objects(): Recursively extract objects
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/Reference-manual.md6
-rw-r--r--docs/markdown/snippets/extract-all-objects.md12
2 files changed, 17 insertions, 1 deletions
diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md
index 32639b0..776703c 100644
--- a/docs/markdown/Reference-manual.md
+++ b/docs/markdown/Reference-manual.md
@@ -1736,7 +1736,11 @@ A build target is either an [executable](#executable),
[shared module](#shared_module).
- `extract_all_objects()` is same as `extract_objects` but returns all
- object files generated by this target
+ object files generated by this target. Since 0.46.0 keyword argument
+ `recursive` must be set to `true` to also return objects passed to the
+ `object` argument of this target. By default only objects built for this
+ target are returned to maintain backward compatibility with previous versions.
+ The default will eventually be changed to `true` in a future version.
- `extract_objects()` returns an opaque value representing the
generated object files of arguments, usually used to take single
diff --git a/docs/markdown/snippets/extract-all-objects.md b/docs/markdown/snippets/extract-all-objects.md
new file mode 100644
index 0000000..3cf8040
--- /dev/null
+++ b/docs/markdown/snippets/extract-all-objects.md
@@ -0,0 +1,12 @@
+## Recursively extract objects
+
+`recursive` keyword argument has been added to `extract_all_objects`. When set
+to `true` it will also return objects passed to the `objects` argument of this
+target. By default only objects built for this target are returned to maintain
+backward compatibility with previous versions. The default will eventually be
+changed to `true` in a future version.
+
+```meson
+lib1 = static_library('a', 'source.c', objects : 'prebuilt.o')
+lib2 = static_library('b', objects : lib1.extract_all_objects(recursive : true))
+```