From 8c3a87847e8469c4b49a1ed130247e4ff023072a Mon Sep 17 00:00:00 2001 From: Xavier Claessens Date: Mon, 28 Jun 2021 12:20:32 -0400 Subject: Document and test new WrapDB auto fallback --- docs/markdown/Using-wraptool.md | 14 ++++++++++++++ docs/markdown/snippets/wrapdb.md | 6 ++++++ 2 files changed, 20 insertions(+) create mode 100644 docs/markdown/snippets/wrapdb.md (limited to 'docs/markdown') diff --git a/docs/markdown/Using-wraptool.md b/docs/markdown/Using-wraptool.md index cabdc0e..edbceaa 100644 --- a/docs/markdown/Using-wraptool.md +++ b/docs/markdown/Using-wraptool.md @@ -82,3 +82,17 @@ straightforward: Wraptool can do other things besides these. Documentation for these can be found in the command line help, which can be accessed by `meson wrap --help`. + +## Automatic dependency fallback + +Since *0.64.0* Meson can use WrapDB to automatically find missing dependencies. + +The user simply needs to download latest database, the following command stores +it in `subprojects/wrapdb.json`: + $ meson wrap update-db + +Once the database is available locally, any dependency not found on the system +but available in WrapDB will automatically be downloaded. + +Automatic fetch of WrapDB subprojects can be disabled by removing the file +`subprojects/wrapdb.json`, or by using `--wrap-mode=nodownload`. diff --git a/docs/markdown/snippets/wrapdb.md b/docs/markdown/snippets/wrapdb.md new file mode 100644 index 0000000..d5caf4f --- /dev/null +++ b/docs/markdown/snippets/wrapdb.md @@ -0,0 +1,6 @@ +## Automatic fallback using WrapDB + +A new command has been added: `meson wrap update-db`. It downloads the list of +wraps available in [WrapDB](wrapdb.mesonbuild.com) and stores it locally in +`subprojects/wrapdb.json`. When that file exists and a dependency is not found +on the system but is available in WrapDB, Meson will automatically download it. -- cgit v1.1