aboutsummaryrefslogtreecommitdiff
path: root/doc/manual.cli
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2018-11-30 13:25:07 +0200
committerKaren Arutyunov <karen@codesynthesis.com>2018-11-30 17:35:42 +0300
commit564d35474958002a5690c8e98163e904cad49d0a (patch)
treecda5571f890191c038a15d2a5916952244a16bf9 /doc/manual.cli
parent17f5882f9ee43db574269ac1fb857ae7e79c109b (diff)
Document new build-include/exclude pattern matching semantics
Diffstat (limited to 'doc/manual.cli')
-rw-r--r--doc/manual.cli21
1 files changed, 15 insertions, 6 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index 0e44391..ea6079b 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -1092,26 +1092,35 @@ The package build inclusions and exclusions. The \c{build-include} and
evaluating the \l{#manifest-package-builds \c{builds}} values. The \i{config}
and \i{target} values are filesystem wildcard patterns which are matched
against the build configuration names and target names (see the \c{bbot}
-documentation for details).
+documentation for details). In particular, the \c{*} wildcard matches zero or
+more characters within the name component while the \c{**} sequence matches
+across the components. Plus, wildcard-only pattern components match absent
+name components. For example:
+
+\
+build-exclude: windows** # matches windows_10-msvc_15
+build-exclude: macos*-gcc** # matches macos_10.13-gcc_8.1-O3
+build-exclude: linux-gcc*-* # matches linux-gcc_8.1 and linux-gcc_8.1-O3
+\
The exclusion and inclusion patterns are applied in the order specified with
the first match determining whether the package will be built for this
configuration and target. If none of the patterns match (or none we
specified), then the package is built.
-As an example, the following value will exclude 32-bit builds for the VC14
-compiler:
+As an example, the following value will exclude 32-bit builds for the MSVC
+14 compiler:
\
-build-exclude: *-msvc_14*/i?86-* ; Linker crash.
+build-exclude: *-msvc_14**/i?86-** ; Linker crash.
\
As another example, the following pair of values will make sure that a package
is only built on Linux:
\
-build-include: linux*
-build-exclude: * ; Only supported on Linux.
+build-include: linux**
+build-exclude: ** ; Only supported on Linux.
\
Note that the comment of the matching exclusion is used by the web interface