aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorEli Schwartz <eschwartz@archlinux.org>2022-03-06 18:57:40 -0500
committerEli Schwartz <eschwartz@archlinux.org>2022-03-06 19:41:21 -0500
commit0f2f87a003477bd79487a47d5f60f67751e2f44e (patch)
tree6ab93b568a66d25cffa9a6ae51e3b505d75a7001 /docs
parent8b573d7dc65bf20fcb0377ce4c56841496ad0c69 (diff)
downloadmeson-0f2f87a003477bd79487a47d5f60f67751e2f44e.zip
meson-0f2f87a003477bd79487a47d5f60f67751e2f44e.tar.gz
meson-0f2f87a003477bd79487a47d5f60f67751e2f44e.tar.bz2
find_program: add a version() method to match the one for dependencies
It is often useful to check the found version of a program without checking whether you can successfully find `find_program('foo', required: false, version: '>=XXX')`
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