// file      : bdep/fetch.cli
// copyright : Copyright (c) 2014-2019 Code Synthesis Ltd
// license   : MIT; see accompanying LICENSE file

include <bdep/project.cli>;

"\section=1"
"\name=bdep-fetch"
"\summary=fetch list of available project dependencies"

namespace bdep
{
  {
    "<options>
     <prj-spec> <prj-dir>
     <cfg-spec> <cfg-name> <cfg-dir>",

    "\h|SYNOPSIS|

     \c{\b{bdep fetch} [<options>] [\b{--full}|\b{-F}] [<prj-spec>] [<cfg-spec>]}

     \c{<cfg-spec> = (\b{@}<cfg-name> | \b{--config}|\b{-c} <cfg-dir>)... | \b{--all}|\b{-a}\n
        <prj-spec> = \b{--directory}|\b{-d} <prj-dir>}

     \h|DESCRIPTION|

     The \cb{fetch} command fetches the list of packages available in the
     project's prerequisite/complement repositories in one or more build
     configurations.

     If no project or package directory is specified, then the current working
     directory is assumed. If no configuration is specified, then the default
     configuration is assumed. See \l{bdep-projects-configs(1)} for details on
     specifying projects and configurations.

     If the \cb{--full|-F} option is specified, then instead \cb{fetch}
     performs a full re-fetch of all the repositories added to the
     configuration. This mode is primarily useful when a configuration (and
     some of the prerequisite/complement repositories) are shared between
     several projects. In this situation an incremental fetch may result in
     an inconsistent repository state."
  }

  class cmd_fetch_options: project_options
  {
    "\h|FETCH OPTIONS|"

    bool --full|-F
    {
      "Perform a full re-fetch of all the repositories."
    }
  };
}