aboutsummaryrefslogtreecommitdiff
path: root/bpkg/pkg-install.cli
diff options
context:
space:
mode:
authorKaren Arutyunov <karen@codesynthesis.com>2018-11-10 22:43:09 +0300
committerKaren Arutyunov <karen@codesynthesis.com>2018-11-13 13:29:05 +0300
commite59343b3267e82aff33a8f73ab82b51345913c06 (patch)
treeea4a76855089af619fdeb542d94824537337d7cc /bpkg/pkg-install.cli
parent85eff0e9f81a3eeccc67e534f43be7e9f2e75521 (diff)
Add support for vars grouping for package commands
Diffstat (limited to 'bpkg/pkg-install.cli')
-rw-r--r--bpkg/pkg-install.cli21
1 files changed, 11 insertions, 10 deletions
diff --git a/bpkg/pkg-install.cli b/bpkg/pkg-install.cli
index a44522e..2b31763 100644
--- a/bpkg/pkg-install.cli
+++ b/bpkg/pkg-install.cli
@@ -15,7 +15,7 @@ namespace bpkg
"\h|SYNOPSIS|
- \c{\b{bpkg pkg-install}|\b{install} [<options>] [<vars>] (<pkg> [<vars>])...\n
+ \c{\b{bpkg pkg-install}|\b{install} [<options>] [<vars>] <pkg>...\n
\b{bpkg pkg-install}|\b{install} [<options>] [<vars>] \b{--all}|\b{-a}}
\h|DESCRIPTION|
@@ -25,20 +25,21 @@ namespace bpkg
Additionally, immediate or all dependencies of these packages can be also
installed by specifying the \c{\b{--immediate}|\b{-i}} or
\c{\b{--recursive}|\b{-r}} options, respectively. Underneath, this
- command doesn't do much more than run \cb{b install}.
+ command doesn't do much more than run \cb{b install}. In the first form
+ the specified packages must have been previously configured with
+ \l{bpkg-pkg-build(1)} or \l{bpkg-pkg-configure(1)}.
- In the first form the specified packages must have been previously
- configured with \l{bpkg-pkg-build(1)} or \l{bpkg-pkg-configure(1)}.
Additional command line variables (<vars>, normally \cb{config.*}) can be
- passed to the build system by either specifying them before the packages,
- in which case they apply to the whole configuration, or after a specific
- package, in which case they apply only to this package. In particular,
- this mechanism can be used to specify the installation directory, for
- example:
+ passed to the build system. Such variables apply to all the specified
+ packages but can also be specified to only apply to specific packages
+ using the argument grouping mechanism (see \l{bpkg-argument-grouping(1)}
+ for details). In particular, this mechanism can be used to specify the
+ installation directory, for example:
\
bpkg install config.install.root=/usr/local \
- config.install.sudo=sudo libfoo libbar
+ config.install.sudo=sudo \
+ libfoo libbar
\
Alternatively, the installation directory can be specified once when