aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown
diff options
context:
space:
mode:
authorJason Ekstrand <jason@jlekstrand.net>2020-06-20 09:45:22 -0500
committerDylan Baker <dylan@pnwbakers.com>2020-11-21 07:55:10 -0800
commit15bbf1ea7581a8a872296435b28d679c7e42a466 (patch)
treeafb7844a63b8406bae87a294bec1e54adad9c73a /docs/markdown
parent9dab27f814cb3d9abe0a7617b9a7a64efb0938e3 (diff)
downloadmeson-15bbf1ea7581a8a872296435b28d679c7e42a466.zip
meson-15bbf1ea7581a8a872296435b28d679c7e42a466.tar.gz
meson-15bbf1ea7581a8a872296435b28d679c7e42a466.tar.bz2
Handle cmake dependencies which require a specified version
Some CMake packages fail to find at all if no version is specified. This commit adds a cmake_version parameter to dependency() to allow you to specify the requested version.
Diffstat (limited to 'docs/markdown')
-rw-r--r--docs/markdown/Dependencies.md5
-rw-r--r--docs/markdown/snippets/cmake_package_version.md5
2 files changed, 10 insertions, 0 deletions
diff --git a/docs/markdown/Dependencies.md b/docs/markdown/Dependencies.md
index a8ada1d..aa93712 100644
--- a/docs/markdown/Dependencies.md
+++ b/docs/markdown/Dependencies.md
@@ -177,6 +177,11 @@ Support for adding additional `COMPONENTS` for the CMake `find_package` lookup
is provided with the `components` kwarg (*introduced in 0.54.0*). All specified
componets will be passed directly to `find_package(COMPONENTS)`.
+Support for packages which require a specified version for CMake
+`find_package` to succeed is provided with the `cmake_package_version` kwarg
+(*introduced in 0.57.0*). The specified `cmake_package_version` will be
+passed directly as the second parameter to `find_package`.
+
It is also possible to reuse existing `Find<name>.cmake` files with the
`cmake_module_path` property. Using this property is equivalent to setting the
`CMAKE_MODULE_PATH` variable in CMake. The path(s) given to `cmake_module_path`
diff --git a/docs/markdown/snippets/cmake_package_version.md b/docs/markdown/snippets/cmake_package_version.md
new file mode 100644
index 0000000..58f0004
--- /dev/null
+++ b/docs/markdown/snippets/cmake_package_version.md
@@ -0,0 +1,5 @@
+## CMake find_package version support
+
+It is now possible to specify a requested package version to the CMake
+dependency backend via the new `cmake_package_version` kwarg in the
+`dependency` function.