From b88ed73c1fa88976e99fa16f989920561f68f302 Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Thu, 8 Nov 2018 22:19:17 +0300
Subject: Add support for pkg-build configuration variables

---
 bpkg/pkg-build.cli | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

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

diff --git a/bpkg/pkg-build.cli b/bpkg/pkg-build.cli
index c370ac4..f5ece04 100644
--- a/bpkg/pkg-build.cli
+++ b/bpkg/pkg-build.cli
@@ -12,6 +12,7 @@ namespace bpkg
 {
   {
     "<options>
+     <cfg-var>
      <pkg-spec> <flags> <scheme> <pkg> <ver>
      <file>
      <dir>
@@ -19,7 +20,8 @@ namespace bpkg
 
     "\h|SYNOPSIS|
 
-     \c{\b{bpkg pkg-build}|\b{build} [<options>] [\b{--upgrade}|\b{-u} | \b{--patch}|\b{-p}] <pkg-spec>...\n
+     \c{\b{bpkg pkg-build}|\b{build} [<options>] [\b{--upgrade}|\b{-u} | \b{--patch}|\b{-p}]\n
+        \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ \ [<cfg-var>... \b{--}] <pkg-spec>...\n
         \b{bpkg pkg-build}|\b{build} [<options>] \ \b{--upgrade}|\b{-u} | \b{--patch}|\b{-p}}
 
      \c{<pkg-spec> = [<flags>](([<scheme>\b{:}]<pkg>[\b{/}<ver>])\b{,}...[\b{@}<rep-loc>] | \n
@@ -98,6 +100,14 @@ namespace bpkg
      \l{bpkg-pkg-unpack(1)} commands for more information on the semantics of
      specifying the package as an archive or a directory.
 
+     Additional configuration variables (<cfg-var>), if any, should be
+     specified before packages (<pkg-spec>) and should be separated with
+     \cb{--}. Such variables are effective only when configuring and only for
+     packages that were explicitly specified on the command line (they can
+     also be specified to apply only to specific packages using the argument
+     grouping mechanism discussed below). See \l{bpkg-pkg-configure(1)} for
+     more information on configuration variables.
+
      By default a package that is specified explicitly on the command line is
      built to \i{hold}: it will not be considered for automatic removal if it
      no longer has any dependents. Only versions from repositories that were
@@ -145,9 +155,10 @@ namespace bpkg
   {
     "\h|PKG-BUILD PACKAGE OPTIONS|
 
-     The following options can be grouped to apply to a specific \ci{pkg-spec}
-     as well as specified globally, in which case they apply to all the
-     specified packages (see \l{bpkg-argument-grouping(1)} for details)."
+     The following options (as well as additional configuration variables) can
+     be grouped to apply to a specific \ci{pkg-spec} as well as specified
+     globally, in which case they apply to all the specified packages (see
+     \l{bpkg-argument-grouping(1)} for details)."
 
     // NOTE: if adding a new option here, don't forget to also update
     //       {validate,merge,compare,print}_options() in pkg-build.cxx!
-- 
cgit v1.1