Apply Safe Haskell flag for newer GHCs only.
[packages/hoopl.git] / README.md
1 The `hoopl` Package  [![Hackage](https://img.shields.io/hackage/v/hoopl.svg)](https://hackage.haskell.org/package/hoopl) [![Build Status](https://travis-ci.org/haskell/hoopl.svg)](https://travis-ci.org/haskell/hoopl)
2 ===================
3
4 ## Hoopl: A Higher-Order OPtimization Library
5
6 API documentation can be found on
7 [Hackage](https://hackage.haskell.org/package/hoopl).  For detailed explanation
8 of the library design see paper ["Hoopl: A Modular, Reusable Library for
9 Dataflow Analysis and
10 Transformation"](http://research.microsoft.com/en-us/um/people/simonpj/Papers/c--/hoopl-haskell10.pdf)
11
12 | Directory      | Contents
13 | -------------- | ---------
14 | `src/`         | The current official sources to the Cabal package
15 | `testing/`     | Tests, including a sample client.  See [`testing/README`](testing/README)
16
17 ### Development Notes
18
19 #### Building and testing
20
21 To build the library run:
22
23     cabal configure
24     cabal build
25     cabal install --enable-documentation
26
27 To run the tests in the `testing/` folder run:
28
29     cabal configure --enable-tests
30     cabal test
31
32 To run the tests with the test coverage report run:
33
34     cabal configure --enable-tests --enable-coverage
35     cabal test
36
37 You'll need a Haskell Platform, which should include appropriate
38 versions of Cabal and GHC.
39
40 #### Coding style
41
42 Please follow Johan Tibell's
43 [Haskell Style Guide](https://github.com/tibbe/haskell-style-guide/blob/master/haskell-style.md)
44 for all new/modified code.
45
46 ### Checklist for Making Releases
47
48 In order to facilitate GHC development's workflow, the version in [`hoopl.cabal`](hoopl.cabal) is to be bumped as soon as a change requires a respective version bump (according to the PVP) relative to the last released `hoopl` version.
49
50 1. Make sure `hoopl` passes Travis for all GHC versions in the build-matrix
51 2. Update Changelog (& `git commit`)
52 3. Generate source tarball via `cabal sdist` and upload a candidate to Hackage (see note below), and inspect the result. 
53 4. If everything checks out, make an annotated and GPG-signed Git release tag: `git tag -a -s v${VER} -m "hoopl ${VER}"`
54 5. Publish (there's a button for that on Hackage) the package candidate
55 6. Work on next release
56
57 Note: To upload to Hackage,
58
59     cabal sdist
60     cabal upload dist/hoopl-*.tar.gz
61
62 However, it's recommended use the Hackage feature for
63 [uploading a candidate](http://hackage.haskell.org/packages/candidates/upload).