diff options
author | Daniel Gröber <dxld@darkboxed.org> | 2015-08-10 08:49:59 +0200 |
---|---|---|
committer | Daniel Gröber <dxld@darkboxed.org> | 2015-08-10 08:49:59 +0200 |
commit | 6a550dc667295158c8bb01c6cb82ee5a4c97c182 (patch) | |
tree | f255cbbae3fabbc8aa399ace7156a12c6fa4d9c2 | |
parent | cb9ef0eb54ebc8067e3adcfd8d0b1b7acd2ab12c (diff) |
README
-rw-r--r-- | README.md | 15 | ||||
-rw-r--r-- | cabal-helper.cabal | 8 |
2 files changed, 14 insertions, 9 deletions
@@ -1,14 +1,16 @@ # 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` provides a library which wraps the internal use of +anexecutable to lift the restrictions imposed by linking against versions of +GHC before `7.10`. This has the pleasant side effect of isolating the user +from having to deal with Cabal version changes manually as `cabal-helper` +can simply recompile it's helper program automatically as needed. `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. +various bits and peices from Cabal's 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 @@ -20,7 +22,8 @@ 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`. +`cabal-helper` can compile with `Cabal >= 1.14` but requires `Cabal >= 1.16` +at runtime. ## IRC diff --git a/cabal-helper.cabal b/cabal-helper.cabal index 92a0bd9..3eda132 100644 --- a/cabal-helper.cabal +++ b/cabal-helper.cabal @@ -2,9 +2,11 @@ name: cabal-helper version: 0.3.9.0 synopsis: Simple interface to some of Cabal's configuration state used by ghc-mod description: - @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@ provides a library which wraps the internal use of + anexecutable to lift the restrictions imposed by linking against versions of + GHC before @7.10@. This has the pleasant side effect of isolating the user + from having to deal with Cabal version changes manually as @cabal-helper@ + can simply recompile it's helper program automatically as needed. . @cabal-helper@ uses a wrapper executable to compile the actual cabal-helper executable at runtime while linking against an arbitrary version of |