1 files changed, 52 insertions, 0 deletions
diff --git a/bpkg/pkg-purge-options.cli b/bpkg/pkg-purge-options.cli
new file mode 100644
index 0000000..8d7d61b
--- /dev/null
+++ b/bpkg/pkg-purge-options.cli
@@ -0,0 +1,52 @@
+// file      : bpkg/pkg-purge-options.cli
+// copyright : Copyright (c) 2014-2015 Code Synthesis Ltd
+// license   : MIT; see accompanying LICENSE file
+
+include <bpkg/common-options.cli>;
+
+/*
+"\section=1"
+"\name=bpkg-pkg-purge"
+
+"\h{SYNOPSIS}
+
+bpkg pkg-purge [<options>] <pkg>"
+
+"\h{DESCRIPTION}
+
+The \cb{pkg-purge} command removes the package directory and archive
+from the filesystem and removes the package from the configuration's
+database. Only packages in the \cb{fetched} and \cb{unpacked} state
+can be purged plus broken packages if the \cb{-f|--force} options is
+specified (see this option's description for details on purging broken
+packages). If the \cb{-k|--keep} option is specified, then the package
+archive is not removed (see this option's description for details on
+this mode)."
+*/
+
+namespace bpkg
+{
+  class pkg_purge_options: common_options
+  {
+    dir_path --directory|-d (".")
+    {
+      "<dir>",
+      "Assume configuration is in <dir> rather than in the current working
+       directory."
+    };
+
+    bool --keep|-k
+    {
+      "Keep the package archive. Note that in this mode the package is
+       still retained in the configuration's database in the \cb{fetched}
+       state."
+    };
+
+    bool --force|-f
+    {
+      "Purge a broken package. In this mode \cb{bpkg} will verify that
+       the package directory and archive no longer exist and will remove
+       the package from the configuration's database."
+    };
+  };
+}