diff options
Diffstat (limited to 'docs/markdown')
| -rw-r--r-- | docs/markdown/Reference-manual.md | 14 | ||||
| -rw-r--r-- | docs/markdown/snippets/linkcustom.md | 16 |
2 files changed, 27 insertions, 3 deletions
diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md index 621e2ca..592aa79 100644 --- a/docs/markdown/Reference-manual.md +++ b/docs/markdown/Reference-manual.md @@ -334,6 +334,7 @@ the following special string substitutions: - `@DEPFILE@` the full path to the dependency file passed to `depfile` - `@PLAINNAME@`: the input filename, without a path - `@BASENAME@`: the input filename, with extension removed +- `@PRIVATE_DIR@`: path to a directory where the custom target must store all its intermediate files, available since 0.50.1 The `depfile` keyword argument also accepts the `@BASENAME@` and `@PLAINNAME@` substitutions. *(since 0.47)* @@ -519,11 +520,18 @@ be passed to [shared and static libraries](#library). when this file changes. - `link_whole` links all contents of the given static libraries whether they are used by not, equivalent to the - `-Wl,--whole-archive` argument flag of GCC, available since - 0.40.0. As of 0.41.0 if passed a list that list will be flattened. + `-Wl,--whole-archive` argument flag of GCC, available since 0.40.0. + As of 0.41.0 if passed a list that list will be flattened. Starting + from version 0.51.0 this argument also accepts outputs produced by + custom targets. The user must ensure that the output is a library in + the correct format. - `link_with`, one or more shared or static libraries (built by this project) that this target should be linked with, If passed a list - this list will be flattened as of 0.41.0. + this list will be flattened as of 0.41.0. Starting with version + 0.51.0, the arguments can also be custom targets. In this case Meson + will assume that merely adding the output file in the linker command + line is sufficient to make linking work. If this is not sufficient, + then the build system writer must write all other steps manually. - `export_dynamic` when set to true causes the target's symbols to be dynamically exported, allowing modules built using the [`shared_module`](#shared_module) function to refer to functions, diff --git a/docs/markdown/snippets/linkcustom.md b/docs/markdown/snippets/linkcustom.md new file mode 100644 index 0000000..d6ee801 --- /dev/null +++ b/docs/markdown/snippets/linkcustom.md @@ -0,0 +1,16 @@ +## Can link against custom targets + +The output of `custom_target` can be used in `link_with` and +`link_whole` keyword arguments. This is useful for integrating custom +code generator steps, but note that there are many limitations: + + - Meson can not know about link dependencies of the custom target. If + the target requires further link libraries, you need to add them manually + + - The user is responsible for ensuring that the code produced by + different toolchains are compatible. + + - The custom target can only have one output file. + + - The output file must have the correct file name extension. + |