From 0eb4423b8522e7ddd9beb3de1aa6a5feff9141d6 Mon Sep 17 00:00:00 2001 From: Nirbheek Chauhan Date: Wed, 9 May 2018 14:54:26 +0530 Subject: subprojects.md: document --wrap-mode Closes https://github.com/mesonbuild/meson/issues/3534 --- docs/markdown/Subprojects.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/docs/markdown/Subprojects.md b/docs/markdown/Subprojects.md index ad2aae2..80ed3e7 100644 --- a/docs/markdown/Subprojects.md +++ b/docs/markdown/Subprojects.md @@ -72,6 +72,35 @@ in the top level `subprojects` directory. Recursive use of subprojects is not allowed, though, so you can't have subproject `a` that uses subproject `b` and have `b` also use `a`. +# Command-line options + +The usage of subprojects can be controlled by users and distros with +the following command-line options: + +* **--wrap-mode=nodownload** + + Meson will not use the network to download any subprojects or + fetch any wrap information. Only pre-existing sources will be used. + This is useful (mostly for distros) when you want to only use the + sources provided by a software release, and want to manually handle + or provide missing dependencies. + +* **--wrap-mode=nofallback** + + Meson will not use subproject fallbacks for any dependency + declarations in the build files, and will only look for them in the + system. Note that this does not apply to unconditional subproject() + calls, and those are meant to be used for sources that cannot be + provided by the system, such as copylibs. + +* **--wrap-mode=forcefallback** + + Meson will not look at the system for any dependencies which have + subproject fallbacks available, and will *only* use subprojects for + them. This is useful when you want to test your fallback setup, or + want to specifically build against the library sources provided by + your subprojects. + # Obtaining subprojects Meson ships with a dependency system to automatically obtain -- cgit v1.1