From e59343b3267e82aff33a8f73ab82b51345913c06 Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Sat, 10 Nov 2018 22:43:09 +0300
Subject: Add support for vars grouping for package commands

---
 bpkg/pkg-install.cli | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

(limited to 'bpkg/pkg-install.cli')

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
-- 
cgit v1.1