Version 11 (modified by duncan, 5 years ago)

--

Cabal Install

cabal-install is the command-line interface for Cabal.

It provides commands for installing cabal packages, including downloading packages from HackageDB and determining the dependencies among packages. It also provides commands for developers to configure, build, test and upload packages to HackageDB.

The current development version is quite usable but if you find any surprises please report them in this trac.

(Its predecessor, cabal-get, is now defunct.)

Availablity

This tool is in development and is available in a darcs repository at  http://darcs.haskell.org/cabal-install/.

The current development version also requires the development version of the Cabal library  http://darcs.haskell.org/cabal/.

Older versions are also available on Hackage and newer versions will be uploaded there after the next stable Cabal release.

Usage

Usage: cabal [GLOBAL FLAGS]
   or: cabal COMMAND [FLAGS]

Global flags:
 -h --help            Show this help text
 -V --version         Print version information
    --numeric-version Print just the version number

Commands:
  install      Installs a list of packages.
  list         List available packages on the server (cached).
  update       Updates list of known packages
  fetch        Downloads packages for later installation or study.
  upload       Uploads source packages to Hackage
  configure    Prepare to build the package.
  build        Make this package ready for installation.
  copy         Copy the files into the install locations.
  haddock      Generate Haddock HTML documentation.
  clean        Clean up after a build.
  sdist        Generate a source distribution file (.tar.gz).
  hscolour     Generate HsColour colourised code, in HTML format.
  register     Register this package with the compiler.
  test         Run the test suite, if any (configure with UserHooks).

Typical step for installing Cabal packages:
  cabal install [PACKAGES]

Occasionally you need to update the list of available packages:
  cabal update

For more information about a command, try 'cabal COMMAND --help'.
This program is the command line interface to the Haskell Cabal Infrastructure.
See http://www.haskell.org/cabal/ for more information.

There is bash command line completion support available, though currently that requires installing manually.