diff options
Diffstat (limited to 'bpkg/pkg-drop.cli')
| -rw-r--r-- | bpkg/pkg-drop.cli | 40 |
1 files changed, 32 insertions, 8 deletions
diff --git a/bpkg/pkg-drop.cli b/bpkg/pkg-drop.cli index ac282d6..75ee04d 100644 --- a/bpkg/pkg-drop.cli +++ b/bpkg/pkg-drop.cli @@ -14,17 +14,21 @@ namespace bpkg "\h|SYNOPSIS| - \c{\b{bpkg pkg-drop}|\b{drop} [<options>] <pkg>...} + \c{\b{bpkg pkg-drop}|\b{drop} [<options>] <pkg>...\n + \b{bpkg pkg-drop}|\b{drop} [<options>] \b{--all}|\b{-a}\n + \b{bpkg pkg-drop}|\b{drop} [<options>] (\b{--all-pattern} <pattern>)...} \h|DESCRIPTION| - The \cb{pkg-drop} command drops one or more packages from the - configuration. If the packages being dropped still have dependent - packages, then those will have to be dropped as well and you will be - prompted to confirm. And if the packages being dropped have dependency - packages that would otherwise no longer be used, then they will be - dropped as well unless the \c{\b{--keep-unused}|\b{-K}} option is - specified. + The \cb{pkg-drop} command drops from the configuration the specified + packages (the first 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). If the packages being + dropped still have dependent packages, then those will have to be dropped + as well and you will be prompted to confirm. And if the packages being + dropped have dependency packages that would otherwise no longer be used, + then they will be dropped as well unless the \c{\b{--keep-unused}|\b{-K}} + option is specified. The \cb{pkg-drop} command also supports several options (described below) that allow you to control the amount of work that will be done." @@ -34,6 +38,19 @@ namespace bpkg { "\h|PKG-DROP OPTIONS|" + bool --all|-a + { + "Drop all held packages." + } + + strings --all-pattern + { + "<pattern>", + "Drop 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 --yes|-y { "Assume the answer to all prompts is \cb{yes}. Note that this option @@ -64,6 +81,13 @@ namespace bpkg "Issue an error if attempting to drop dependent packages." } + uint16_t --dependent-exit + { + "<code>", + "Silently exit with the specified error code if attempting to drop + dependent packages." + } + bool --disfigure-only { "Disfigure all the packages but don't purge." |