aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/markdown/snippets/find_program-version.md5
-rw-r--r--docs/yaml/objects/external_program.yaml8
2 files changed, 13 insertions, 0 deletions
diff --git a/docs/markdown/snippets/find_program-version.md b/docs/markdown/snippets/find_program-version.md
new file mode 100644
index 0000000..fe3a9a6
--- /dev/null
+++ b/docs/markdown/snippets/find_program-version.md
@@ -0,0 +1,5 @@
+## found programs now have a version method
+
+The return value of [[find_program]] can now check the exact version of the
+found program, independent of the minimum version requirement. This can be used
+e.g. to perform different actions depending on the exact version detected.
diff --git a/docs/yaml/objects/external_program.yaml b/docs/yaml/objects/external_program.yaml
index 02bf48f..f406477 100644
--- a/docs/yaml/objects/external_program.yaml
+++ b/docs/yaml/objects/external_program.yaml
@@ -24,6 +24,14 @@ methods:
run_command(find_program('foo'), 'arg1', 'arg2')
```
+- name: version
+ returns: str
+ since: 0.62.0
+ description: |
+ The version number as a string, for example `1.2.8`.
+
+ `unknown` if the program cannot determine the version via a `--version` argument.
+
- name: full_path
returns: str
since: 0.55.0