From fae24d86f58ee178e1c344c99405e1a89dfd8964 Mon Sep 17 00:00:00 2001 From: Eli Schwartz Date: Wed, 30 Nov 2022 20:19:13 -0500 Subject: docs: clarify prog.full_path even more The previous description update was lacking an example of why external_program cares about inter-target dependencies. --- docs/yaml/objects/external_program.yaml | 14 ++++++++------ 1 file 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: -- cgit v1.1