// file      : bpkg/pkg-drop.cli
// copyright : Copyright (c) 2014-2016 Code Synthesis Ltd
// license   : MIT; see accompanying LICENSE file

include <bpkg/configuration.cli>;

"\section=1"
"\name=bpkg-pkg-drop"
"\summary=drop package"

namespace bpkg
{
  {
    "<options>",

    "\h|SYNOPSIS|

     \c{\b{bpkg pkg-drop}|\b{drop} [<options>] <pkg>...}

     \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 drop as well and you will be prompted
     to confirm. Similarly, if the packages being dropped have prerequisite
     packages that would otherwise no longer be needed, you will be offered to
     drop those as well.

     The \cb{pkg-drop} command also supports several \cb{--*-only} options that
     allow you to limit the amount of work that will be done."
  }

  class pkg_drop_options: configuration_options
  {
    "\h|PKG-DROP OPTIONS|"

    bool --yes|-y
    {
      "Assume the answer to all prompts is \cb{yes}. Note that this option
       does not apply to the dropping of dependents; use \cb{--drop-dependent}
       for that."
    }

    bool --no|-n
    {
      "Assume the answer to all prompts is \cb{no}. Only makes sense together
       with \cb{--print-only|-p}."
    }

    bool --drop-dependent
    {
      "Don't warn about or ask for confirmation if dropping dependent
       packages."
    }

    bool --print-only|-p
    {
      "Print to \cb{STDOUT} what would be done without actually doing
       anything."
    }

    bool --disfigure-only
    {
      "Disfigure all the packages but don't purge."
    }
  };
}