aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
diff options
context:
space:
mode:
authorNirbheek Chauhan <nirbheek.chauhan@gmail.com>2017-09-20 21:05:50 +0000
committerGitHub <noreply@github.com>2017-09-20 21:05:50 +0000
commit751d59d95238e9f2ef12202df992d54650594919 (patch)
tree02c26b238003ad5975460aaa564777c0d1c1ba8e /docs/markdown
parent96e24a50f91df198f6880ad2f76dd8f010b7f51f (diff)
downloadmeson-751d59d95238e9f2ef12202df992d54650594919.zip
meson-751d59d95238e9f2ef12202df992d54650594919.tar.gz
meson-751d59d95238e9f2ef12202df992d54650594919.tar.bz2
Update Reference-manual.md
Add notes about not using full_path() unless absolutely necessary.
Diffstat (limited to 'docs/markdown')
-rw-r--r--docs/markdown/Reference-manual.md10
1 files changed, 8 insertions, 2 deletions
diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md
index 7afd32b..de51479 100644
--- a/docs/markdown/Reference-manual.md
+++ b/docs/markdown/Reference-manual.md
@@ -1511,7 +1511,10 @@ A build target is either an [executable](#executable),
files with custom flags. To use the object file(s) in another build
target, use the `objects:` keyword argument.
-- `full_path()` returns a full path pointing to the result target file
+- `full_path()` returns a full path pointing to the result target file.
+ NOTE: In most cases using the object itself will do the same job as
+ this and will also allow Meson to setup inter-target dependencies
+ correctly. Please file a bug if that doesn't work for you.
- `private_dir_include()` returns a opaque value that works like
`include_directories` but points to the private directory of this
@@ -1557,7 +1560,10 @@ cause a syntax error.
This object is returned by [`custom_target`](#custom_target) and
contains a target with the following methods:
-- `full_path()` returns a full path pointing to the result target file
+- `full_path()` returns a full path pointing to the result target file
+ NOTE: In most cases using the object itself will do the same job as
+ this and will also allow Meson to setup inter-target dependencies
+ correctly. Please file a bug if that doesn't work for you.
### `dependency` object