README.md

   1 # Cabal [![Hackage version](https://img.shields.io/hackage/v/Cabal.svg?label=Hackage)](https://hackage.haskell.org/package/Cabal) [![Stackage version](https://www.stackage.org/package/Cabal/badge/lts?label=Stackage)](https://www.stackage.org/package/Cabal) [![Build Status](https://secure.travis-ci.org/haskell/cabal.svg?branch=master)](http://travis-ci.org/haskell/cabal) [![Windows build status](https://ci.appveyor.com/api/projects/status/github/haskell/cabal?branch=master&svg=true)](https://ci.appveyor.com/project/23Skidoo/cabal) [![Documentation Status](http://readthedocs.org/projects/cabal/badge/?version=latest)](http://cabal.readthedocs.io/en/latest/?badge=latest)
   2
   3 <img src="https://www.haskell.org/cabal/images/Cabal-light.png" align="right">
   4
   5 This Cabal Git repository contains the following packages:
   6
   7  * [Cabal](Cabal/README.md): the Cabal library package ([license](Cabal/LICENSE))
   8  * [cabal-install](cabal-install/README.md): the package containing the `cabal` tool ([license](cabal-install/LICENSE))
   9
  10 The canonical upstream repository is located at
  11 https://github.com/haskell/cabal.
  12
  13 Installing cabal-install (by downloading the binary)
  14 ----------------------------------------------------
  15
  16 Prebuilt binary releases can be obtained from https://www.haskell.org/cabal/download.html.
  17 The `cabal-install` binary download for your platform should contain the `cabal` executable.
  18
  19 Installing cabal-install (preferred, with cabal-install)
  20 --------------------------------------------------------
  21
  22 Assuming that you have a pre-existing, recent version of `cabal-install`, run:
  23
  24 ~~~~
  25 cabal install cabal-install
  26 ~~~~
  27
  28 To get the latest version of `cabal-install`. (You may want to `cabal update` first.)
  29
  30 To install the latest version from the Git repository, clone the
  31 Git repository and then run:
  32
  33 ~~~~
  34 cabal install --project-file=cabal.project.release cabal-install
  35 ~~~~
  36
  37 Installing cabal-install without cabal-install
  38 ----------------------------------------------
  39
  40 Assuming you don't have a pre-existing copy of `cabal-install`,
  41 look into `bootstrap` directory.