From e01aae24cd1a9b3e0cb2f2d08f54cc86d7115c15 Mon Sep 17 00:00:00 2001 From: Daniel Gröber Date: Thu, 12 Mar 2015 11:43:23 +0100 Subject: Add README --- README.md | 35 +++++++++++++++++++++++++++++++++++ cabal-helper.cabal | 6 +++--- 2 files changed, 38 insertions(+), 3 deletions(-) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d6fbc17 --- /dev/null +++ b/README.md @@ -0,0 +1,35 @@ +# cabal-helper + +`cabal-helper` provides a library which wraps the internal use of executables +to lift the restrictions imposed by linking against versions of GHC before +`7.10`. + +`cabal-helper` uses a wrapper executable to compile the actual cabal-helper +executable at runtime while linking against an arbitrary version of +Cabal. This runtime-compiled helper executable is then used to extract +various bits and peices from Cabal on disk state (dist/setup-config) written +by it's configure command. + +In addition to this the wrapper executable also supports installing any +version of Cabal from hackage in case it cannot be found in any available +package database. The wrapper installs these instances of the Cabal library +into a private package database so as to not interfere with the user's +packages. + +Furthermore the wrapper supports one special case namely reading a state +file for Cabal itself. This is needed as Cabal compiles it's Setup.hs using +itself and not using any version of Cabal installed in any package database. + +Currently `cabal-helper` supports @Cabal >= 1.16@. + +## IRC + +If you have any problems, suggestions, comments swing by +[\#ghc-mod (web client)](https://kiwiirc.com/client/irc.freenode.org/ghc-mod) on +Freenode. If you're reporting a bug please also create an issue +[here](https://github.com/DanielG/cabal-helper/issues) so we have a way to +contact you if you don't have time to stay. + +Do hang around for a while if no one answers and repeat your question if you +still haven't gotten any answer after a day or so. You're most likely to get an +answer during the day in GMT+1. diff --git a/cabal-helper.cabal b/cabal-helper.cabal index 5b74af5..77fc078 100644 --- a/cabal-helper.cabal +++ b/cabal-helper.cabal @@ -2,11 +2,11 @@ name: cabal-helper version: 0.1.0.0 synopsis: Simple interface to Cabal's configuration state used by ghc-mod description: - CabalHelper provides a library which wraps the internal use of executables + @cabal-helper@ provides a library which wraps the internal use of executables to lift the restrictions imposed by linking against versions of GHC before @7.10@. - CabalHelper uses a wrapper executable to compile the actual cabal-helper + @cabal-helper@ uses a wrapper executable to compile the actual cabal-helper executable at runtime while linking against an arbitrary version of Cabal. This runtime-compiled helper executable is then used to extract various bits and peices from Cabal on disk state (dist/setup-config) written @@ -22,7 +22,7 @@ description: file for Cabal itself. This is needed as Cabal compiles it's Setup.hs using itself and not using any version of Cabal installed in any package database. - Currently CabalHelper supports @Cabal >= 1.16@. + Currently @cabal-helper@ supports @Cabal >= 1.16@. license: AGPL-3 license-file: LICENSE -- cgit v1.2.3