diff options
author | Eli Schwartz <eschwartz@archlinux.org> | 2022-11-30 20:19:13 -0500 |
---|---|---|
committer | Eli Schwartz <eschwartz@archlinux.org> | 2022-11-30 20:19:56 -0500 |
commit | fae24d86f58ee178e1c344c99405e1a89dfd8964 (patch) | |
tree | b524944130fbd69901e83ffadd11d0aae54e9349 /docs | |
parent | dcc50b9967b96da371412867b385811eb57f0497 (diff) | |
download | meson-fae24d86f58ee178e1c344c99405e1a89dfd8964.zip meson-fae24d86f58ee178e1c344c99405e1a89dfd8964.tar.gz meson-fae24d86f58ee178e1c344c99405e1a89dfd8964.tar.bz2 |
docs: clarify prog.full_path even more
The previous description update was lacking an example of why
external_program cares about inter-target dependencies.
Diffstat (limited to 'docs')
-rw-r--r-- | docs/yaml/objects/external_program.yaml | 14 |
1 files changed, 8 insertions, 6 deletions
diff --git a/docs/yaml/objects/external_program.yaml b/docs/yaml/objects/external_program.yaml index 923cb54..f0a5ac0 100644 --- a/docs/yaml/objects/external_program.yaml +++ b/docs/yaml/objects/external_program.yaml @@ -17,9 +17,10 @@ methods: **NOTE:** You should not usually need to use this method. Passing the object itself should work in most contexts where a program can appear, - and allows Meson to setup inter-target dependencies correctly. Only - use this if you specifically need a string, such as when embedding a - program path into a header file. + and allows Meson to setup inter-target dependencies correctly (for + example in cases where a program might be overridden by a [[build_tgt]]). + Only use this if you specifically need a string, such as when embedding + a program path into a header file. For example: @@ -43,9 +44,10 @@ methods: **NOTE:** You should not usually need to use this method. Passing the object itself should work in most contexts where a program can appear, - and allows Meson to setup inter-target dependencies correctly. Only - use this if you specifically need a string, such as when embedding a - program path into a header file. + and allows Meson to setup inter-target dependencies correctly (for + example in cases where a program might be overridden by a [[build_tgt]]). + Only use this if you specifically need a string, such as when embedding + a program path into a header file. For example: |