From 38943a2ecd79d2af18491a6c994c983aa5a35b97 Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Wed, 19 Apr 2023 22:09:44 +0300
Subject: Add support for package-specific config vars in package build config
 in worker

---
 doc/manual.cli | 39 ++++++++++++++++++++++-----------------
 1 file changed, 22 insertions(+), 17 deletions(-)

(limited to 'doc/manual.cli')

diff --git a/doc/manual.cli b/doc/manual.cli
index 533ba0d..d9d19b5 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -1033,7 +1033,8 @@ bpkg -v build --configure-only \\
      <env-config-args> <tgt-config-args> <pkg-config-args> \\
      [<pkg-config-opts>] \\
      [{ <pkg-config-vars> }+] <package-name>/<package-version> \\
-     [<test-package-name>[ <test-version-constraint>]...] \\
+     [([{ <test-config-vars> }+] \\
+       <test-package-name>[ <test-version-constraint>])...] \\
      [([{ <dep-config-vars> }+] \\
        (?|sys:)<dependency-name> \\
        [<dependency-version-constraint>])...] \\
@@ -1190,7 +1191,8 @@ bpkg -v update <package-name>
     #
     bpkg -v build --configure-only \\
          <env-config-args> <tgt-config-args> <pkg-config-args> \\
-         <test-package-name>[ <test-version-constraint>]... \\
+         ([{ <test-config-vars> }+] \\
+          <test-package-name>[ <test-version-constraint>])... \\
          ?sys:<package-name>/<package-version> \\
          [?sys:<dependency-name>[ <dependency-version-constraint>]...]
 
@@ -1366,13 +1368,15 @@ bpkg -v build --configure-only \\
   [<pkg-config-vars>] }+ \\
 <package-name>/<package-version> \\
 \\
-{ --config-uuid <host-uuid> \\
-  <env-config-args> <tgt-config-args> <pkg-config-args> }+ \\
-{ <runtime-test-package-name>[ test-version-constraint>]... } \\
+({ --config-uuid <host-uuid> \\
+   <env-config-args> <tgt-config-args> <pkg-config-args> \\
+   [<test-config-vars>] }+ \\
+ <runtime-test-package-name>[ <test-version-constraint>])... \\
 \\
-{ --config-uuid <target-uuid> \\
-  <env-config-args> <tgt-config-args> <pkg-config-args> }+ \\
-{ <buildtime-test-package-name>[ test-version-constraint>]... } \\
+({ --config-uuid <target-uuid> \\
+   <env-config-args> <tgt-config-args> <pkg-config-args> \\
+   [<test-config-vars>] }+ \\
+ <buildtime-test-package-name>[ <test-version-constraint>])... \\
 \\
 ({ --config-uuid <host-uuid> [--config-uuid <install-uuid>] \\
    [<dep-config-vars>] }+ \\
@@ -1587,11 +1591,11 @@ bpkg -v update -d <host-conf> <package-name>
     bpkg -v build --configure-only \\
     <env-config-args> <tgt-config-args> <pkg-config-args> \\
     \\
-    { --config-name <host-conf> }+ \\
-    { <runtime-test-package-name>[ <test-version-constraint>]... } \\
+    ({ --config-name <host-conf> [<test-config-vars>] }+ \\
+     <runtime-test-package-name>[ <test-version-constraint>])... \\
     \\
-    { --config-name <target-conf> }+ \\
-    <buildtime-test-package-name>[ <test-version-constraint>]... \\
+    ({ --config-name <target-conf> [<test-config-vars>] }+ \\
+     <buildtime-test-package-name>[ <test-version-constraint>])... \\
     \\
     ?sys:<package-name>/<package-version> \\
     \\
@@ -1759,9 +1763,10 @@ bpkg -v build --configure-only \\
   [<pkg-config-vars>] }+ \\
 <package-name>/<package-version> \\
 \\
-{ --config-uuid <target-uuid> \\
-  <env-config-args> <tgt-config-args> <pkg-config-args> }+ \\
-{ <buildtime-test-package-name>[ test-version-constraint>]... } \\
+({ --config-uuid <target-uuid> \\
+   <env-config-args> <tgt-config-args> <pkg-config-args> \\
+   [<test-config-vars>] }+ \\
+ <buildtime-test-package-name>[ <test-version-constraint>])... \\
 \\
 ({ --config-uuid <host-uuid> [--config-uuid <install-uuid>] \\
    [<dep-config-vars>] }+ \\
@@ -1918,8 +1923,8 @@ bpkg -v update -d <module-conf> <package-name>
     bpkg -v build --configure-only \\
     <env-config-args> <tgt-config-args> <pkg-config-args> \\
     \\
-    { --config-name <target-conf> }+ \\
-    <buildtime-test-package-name>[ <test-version-constraint>]... \\
+    ({ --config-name <target-conf> [<test-config-vars>] }+ \\
+     <buildtime-test-package-name>[ <test-version-constraint>])... \\
     \\
     ?sys:<package-name>/<package-version> \\
     \\
-- 
cgit v1.1