diff options
Diffstat (limited to 'doc/manual.cli')
| -rw-r--r-- | doc/manual.cli | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/doc/manual.cli b/doc/manual.cli index 66c2b02..43a2709 100644 --- a/doc/manual.cli +++ b/doc/manual.cli @@ -881,6 +881,39 @@ bpkg -v test <package-name> For details on configuring and testing installation refer to \l{#arch-controller Controller Logic}. +If the package is a build system module, then it is built and tested (using +the bundled tests) in a separate configuration that mimics the one used to +build \c{build2} itself. Note that the configuration and environment options +and variables are not passed to commands that may affect this configuration. +Such commands, therefore, have no associated \i{step id}: + +\ +# +# +b -V create config.import=~host +bpkg -v create --existing + +# bpkg.configure.add +# +bpkg -v add <repository-url> + +# bpkg.configure.fetch +# +bpkg -v fetch --trust <repository-fp> + +# +# +bpkg -v build --yes --configure-only <package-name>/<package-version> + +# +# +bpkg -v update <package-name> + +# if the test operation is supported by the package: +# +bpkg -v test <package-name> +\ + As an example, the following POSIX shell script can be used to setup the environment for building C and C++ packages with GCC 9 on most Linux distributions. |