Overture is an alternative to some of Haskell's Prelude.
- [Install](#install)
- [Use](#use)
- [Develop](#develop)
## Install
To use Overture in a Cabal package, add it to your Cabal file.
```
build-depends:
overture ==0.0.*
```
For other use cases, install it with `cabal-install`.
``` sh
$ cabal update
$ cabal install 'overture ==0.0.*'
```
Overture uses [Semantic Versioning][]. Check out [the change log][] for a
detailed list of changes.
## Use
Overture is designed to be imported unqualified. It does not export anything
that conflicts with the Prelude. To get started, simply import it.
``` hs
import Overture
```
Check out [the Haddock documentation][] for more information about the
functions Overture provides.
## Develop
If you want to help develop Overture, you'll need Git, GHC, and Cabal. To get
started, clone the repository and install the dependencies.
``` sh
$ git clone https://github.com/tfausak/overture
$ cd overture
$ cabal sandbox init
$ cabal install --enable-benchmarks --enable-tests --only-dependencies
```
Once you've done that, you should be able to use the normal Cabal tools
(`bench`, `test`, `repl`, and `haddock` in particular). If you've made changes
that you want merged into this repository, create a fork and open a pull
request. GitHub's [Fork A Repo][] article can help with that.
[semantic versioning]: http://semver.org/spec/v2.0.0.html
[the change log]: CHANGELOG.md
[the haddock documentation]: https://hackage.haskell.org/package/overture
[fork a repo]: https://help.github.com/articles/fork-a-repo/