From 5b2f02086f9295cf16e19cb3b7e5369b313bb422 Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Thu, 12 Nov 2020 14:21:26 +0300
Subject: Add --all-pattern option to pkg-{update,clean,test,install,uninstall}
 commands

---
 bpkg/pkg-install.cli | 27 +++++++++++++++++++--------
 1 file changed, 19 insertions(+), 8 deletions(-)

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

diff --git a/bpkg/pkg-install.cli b/bpkg/pkg-install.cli
index 308945a..ed22e3a 100644
--- a/bpkg/pkg-install.cli
+++ b/bpkg/pkg-install.cli
@@ -15,18 +15,21 @@ namespace bpkg
     "\h|SYNOPSIS|
 
      \c{\b{bpkg pkg-install}|\b{install} [<options>] [<vars>] <pkg>...\n
-        \b{bpkg pkg-install}|\b{install} [<options>] [<vars>] \b{--all}|\b{-a}}
+        \b{bpkg pkg-install}|\b{install} [<options>] [<vars>] \b{--all}|\b{-a}\n
+        \b{bpkg pkg-install}|\b{install} [<options>] [<vars>] (\b{--all-pattern} <pattern>)...}
 
      \h|DESCRIPTION|
 
      The \cb{pkg-install} command installs the specified packages (the first
-     form) or all held packages (the second form, see \l{bpkg-pkg-status(1)}).
-     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}. In the first form
-     the specified packages must have been previously configured with
-     \l{bpkg-pkg-build(1)} or \l{bpkg-pkg-configure(1)}.
+     form), all the held packages (the second form, see
+     \l{bpkg-pkg-status(1)}), or all the held packages that match any of the
+     specified wildcard patterns (the third form). 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}. 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. Such variables apply to all the specified
@@ -54,6 +57,14 @@ namespace bpkg
       "Install all held packages."
     }
 
+    strings --all-pattern
+    {
+      "<pattern>",
+      "Install held packages that match the specified wildcard pattern. Repeat
+       this option to match multiple patterns. Note that you may need to quote
+       the pattern to prevent expansion by your shell."
+    }
+
     bool --immediate|-i
     {
       "Also install immediate dependencies."
-- 
cgit v1.1