aboutsummaryrefslogtreecommitdiff
path: root/bpkg/bpkg.cli
diff options
context:
space:
mode:
Diffstat (limited to 'bpkg/bpkg.cli')
-rw-r--r--bpkg/bpkg.cli52
1 files changed, 48 insertions, 4 deletions
diff --git a/bpkg/bpkg.cli b/bpkg/bpkg.cli
index b1c0a00..6edea97 100644
--- a/bpkg/bpkg.cli
+++ b/bpkg/bpkg.cli
@@ -50,6 +50,10 @@ namespace bpkg
configuration is an amalgamation that contains packages as subprojects
(see \l{bpkg-cfg-create(1)} for details).
+ Build configurations can be linked with each other so that while a
+ package is built in one configuration, some of its dependencies can be
+ built in linked configurations (see \l{bpkg-cfg-create(1)} for details).
+
A \i{bpkg package} is an archive or directory (potentially in a version
control system) that contains a \cb{build2} project plus the package
\cb{manifest} file. \cb{bpkg} can either use package archives/directories
@@ -168,6 +172,21 @@ namespace bpkg
"\l{bpkg-cfg-create(1)} \- create configuration"
}
+ bool cfg-info
+ {
+ "\l{bpkg-cfg-info(1)} \- print configuration information"
+ }
+
+ bool cfg-link|link
+ {
+ "\l{bpkg-cfg-link(1)} \- link configuration"
+ }
+
+ bool cfg-unlink|unlink
+ {
+ "\l{bpkg-cfg-unlink(1)} \- unlink configuration"
+ }
+
bool rep-info
{
"\l{bpkg-rep-info(1)} \- print repository information"
@@ -238,6 +257,11 @@ namespace bpkg
"\l{bpkg-pkg-clean(1)} \- clean package"
}
+ bool pkg-bindist|bindist
+ {
+ "\l{bpkg-pkg-bindist(1)} \- generate binary distribution package"
+ }
+
bool pkg-verify
{
"\l{bpkg-pkg-verify(1)} \- verify package archive"
@@ -314,14 +338,34 @@ namespace bpkg
"\h|ENVIRONMENT|
- Commands executed by \cb{bpkg} while the build configuration database is
- open will have the \cb{BPKG_OPEN_CONFIG} environment variable set to the
- absolute and normalized configuration directory path. This can be used by
+ Commands executed by \cb{bpkg} while the current and linked build
+ configuration databases are open will have the \cb{BPKG_OPEN_CONFIGS}
+ environment variable set to the space-separated, \cb{\"}-quoted list of
+ absolute and normalized configuration directory paths. This can be used by
build system hooks and/or programs that they execute.
"
"\h|EXIT STATUS|
- Non-zero exit status is returned in case of an error.
+ \dl|
+
+ \li|\cb{0}
+
+ Success.|
+
+ \li|\cb{1}
+
+ Fatal error.|
+
+ \li|\cb{2}
+
+ Recoverable error which is likely to disappear if the command is
+ re-executed.||
+
+ \h|ENVIRONMENT|
+
+ The \cb{BPKG_DEF_OPT} environment variable is used to suppress loading of
+ default options files in nested \cb{bpkg} invocations. Its values are
+ \cb{false} or \cb{0} to suppress and \cb{true} or \cb{1} to load.
"
}