From 4deeb907b613760754c5be20e1af019d76b78515 Mon Sep 17 00:00:00 2001 From: Xavier Claessens Date: Thu, 30 Sep 2021 15:15:04 -0400 Subject: dependency: Allow searching for multiple names --- docs/markdown/Reference-manual.md | 9 ++++++++- docs/markdown/snippets/dependency_names.md | 8 ++++++++ 2 files changed, 16 insertions(+), 1 deletion(-) create mode 100644 docs/markdown/snippets/dependency_names.md (limited to 'docs/markdown') diff --git a/docs/markdown/Reference-manual.md b/docs/markdown/Reference-manual.md index a91fa3e..0139bec 100644 --- a/docs/markdown/Reference-manual.md +++ b/docs/markdown/Reference-manual.md @@ -496,7 +496,7 @@ keyword arguments: ### dependency() ``` meson - dependency_object dependency(*dependency_name*, ...) + dependency_object dependency(*name1*, *name2*, ...) ``` Finds an external dependency (usually a library installed on your @@ -506,6 +506,13 @@ frameworks (OSX only) and [library-specific fallback detection logic](Dependencies.md#dependencies-with-custom-lookup-functionality) are also supported. +*Since 0.60.0* more than one name can be provided, they will be tried in order +and the first name to be found will be used. The fallback subproject will be +used only if none of the names are found on the system. Once one of the name has +been found, all other names are added into the cache so subsequent calls for any +of those name will return the same value. This is useful in case a dependency +could have different names, such as `png` and `libpng`. + Dependencies can also be resolved in two other ways: * if the same name was used in a `meson.override_dependency` prior to diff --git a/docs/markdown/snippets/dependency_names.md b/docs/markdown/snippets/dependency_names.md new file mode 100644 index 0000000..3ea1019 --- /dev/null +++ b/docs/markdown/snippets/dependency_names.md @@ -0,0 +1,8 @@ +## Dependencies with multiple names + +More than one name can now be passed to `dependency()`, they will be tried in order +and the first name to be found will be used. The fallback subproject will be +used only if none of the names are found on the system. Once one of the name has +been found, all other names are added into the cache so subsequent calls for any +of those name will return the same value. This is useful in case a dependency +could have different names, such as `png` and `libpng`. -- cgit v1.1