aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKaren Arutyunov <karen@codesynthesis.com>2023-04-20 11:48:02 +0300
committerKaren Arutyunov <karen@codesynthesis.com>2023-04-20 13:46:08 +0300
commit4f2b971fe0ac72c6a35f65d7752c8d941df7fa88 (patch)
treecf88676d962b1398346b589ee087058be98bf6c7
parentabde2515c64816e7233d138c3f00e59213cb980e (diff)
Document support for package-specific config vars in *-build-config package manifest value
-rw-r--r--doc/manual.cli16
1 files changed, 14 insertions, 2 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index 3d4b73f..5531703 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -2317,11 +2317,13 @@ Note that the comment of the matching exclusion is used by the web interface
<args> = [[[+|-]<prefix>:](<option>|<config-var>)]* \\
[(+|-)<prefix>:]* \\
- [<dependency-spec>]*
+ [<dependency-spec>]* \\
+ [<package-specific-vars>]*
<dependency-spec> = [{ <config-var> [<config-var>]* }+] <dependency>
<dependency> = (?[sys:]|sys:)<name>[<version-spec>]
<version-spec> = /<version> | <version-constraint>
+<package-specific-vars> = { <config-var> [<config-var>]* }+ <name>
[*-builds]: <class-expr> [; <comment>]
[*-build-include]: <config>[/<target>] [; <comment>]
@@ -2343,7 +2345,10 @@ it to a specific step, operation, phase, or tool (see \l{bbot#arch-worker
disable the respective step (see the list of \l{bbot#arch-controller worker
steps} which can be enabled or disabled). Unprefixed global options,
variables, and dependencies are passed to the \l{bpkg-pkg-build(1)} command at
-the \c{bpkg.configure.build} step. For example:
+the \c{bpkg.configure.build} step. The package-specific configuration
+variables for this and/or the separate test packages are passed to
+\l{bpkg-pkg-build(1)} at the \c{bpkg.configure.build} and
+\c{bpkg.test-separate-installed.configure.build} steps. For example:
\
network-build-config: config.libfoo.network=true; Enable networking API.
@@ -2379,6 +2384,13 @@ bindist-build-config:
;
Generate binary distribution package but don't test its installation.
\\
+
+load-tests-build-config:
+\\
+{ config.libfoo_tests.load=true }+ libfoo-tests
+;
+Enable load testing.
+\\
\
Note that options with values can only be specified using the single argument