diff options
Diffstat (limited to 'bpkg/pkg-install.cli')
-rw-r--r-- | bpkg/pkg-install.cli | 28 |
1 files changed, 19 insertions, 9 deletions
diff --git a/bpkg/pkg-install.cli b/bpkg/pkg-install.cli index 4f54a8f..ed22e3a 100644 --- a/bpkg/pkg-install.cli +++ b/bpkg/pkg-install.cli @@ -1,5 +1,4 @@ // file : bpkg/pkg-install.cli -// copyright : Copyright (c) 2014-2019 Code Synthesis Ltd // license : MIT; see accompanying LICENSE file include <bpkg/configuration.cli>; @@ -16,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 @@ -55,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." |