Add --for|-f <operation> option to pkg-update and pkg-build

This allows executing build2 -for-X operations (e.g., update-for-install
or update-for-test) in order to minimize the amount of stuff to be updated.

1 files changed, 13 insertions, 5 deletions

diff --git a/bpkg/pkg-build.cli b/bpkg/pkg-build.cli
index f322a07..042ece6 100644
--- a/bpkg/pkg-build.cli
+++ b/bpkg/pkg-build.cli
@@ -69,6 +69,14 @@ namespace bpkg
       "Assume the answer to all prompts is \cb{yes}."
     }
 
+    string --for|-f
+    {
+      "<operation>",
+      "Instead of the default \cb{update} build system operation, perform the
+       \cb{update-for-}<operation> variant where <operation> is normally
+       \cb{install} or \cb{test}."
+    }
+
     bool --drop-prerequisite|-D
     {
       "Drop without confirmation prerequsite packages that were automatically
@@ -93,15 +101,15 @@ namespace bpkg
        their prerequisites being upgraded or downgraded."
     }
 
-    bool --print-only|-p
+    bool --configure-only|-c
     {
-      "Print to \cb{STDOUT} what would be done without actually doing
-       anything."
+      "Configure all the packages but don't update."
     }
 
-    bool --configure-only|-c
+    bool --print-only|-p
     {
-      "Configure all the packages but don't update."
+      "Print to \cb{STDOUT} what would be done without actually doing
+       anything."
     }
   };
 }