Command-Line Interface
======================

Synopsis
--------

subcomponent *[options]* **command** *[command-options]* *[command-arguments]*


Description
-----------

Orchestrate the way several components can be retrieved and built between each
other.  This is not a build system, but rather a glue layer that abstracts how
the components can be retrieved, how they will be built, and how to handle
depencies between them.


Options
-------

- `-C path`: path where subcomponent must execute itself. The default is the
  current directory where subcomponent was called.
- `--file` (`-f`) `file` : provide an alternate subcomponent configuration
  file.
- `--debug`: increases the level of verbosity.
- `--help` (`-h`): display an indicative help message. Note that
  every command also accept this option.


Commmands
---------

- **init** [`--force` | `-f`] creates a subcomponent template with the
  necessary files. The generated template shall be ready to be fetched for a
  new user to see what happens. When the option `--force` (`-f`) is specified,
  existing files are overwritten. By default, if the template files already
  exist, they don't get overwritten.
- **fetch** [`--dry-run` | `-n`] [*component...*] get the specified components
  (all, if none is specified).