diff --git a/doc/INSTALL.md b/doc/INSTALL.md index 6f06a9dc6..8e4fdd7a3 100644 --- a/doc/INSTALL.md +++ b/doc/INSTALL.md @@ -136,7 +136,7 @@ or get help. If your cabal is modern enough, adding `--max-backjumps=10000` should help. ([more](https://groups.google.com/d/topic/hledger/FdWGTSAVzYU/discussion)). -#. **cabal can't satisfy the new dependencies due to old installed packages** +#. **cabal can't satisfy the new dependencies due to old installed packages** Cabal dependency failures become more likely as you install more packages over time. If `cabal install hledger-web --dry` says it can't satisfy dependencies, you have this problem. You can: @@ -145,13 +145,15 @@ or get help. or which constraints to add (with `--constraint 'PKG == ...'`) to help cabal find a solution - b. install into a fresh environment created with - [virthualenv](http://hackage.haskell.org/package/virthualenv) or - [cabal-dev](http://hackage.haskell.org/package/cabal-dev) + b. install into a fresh cabal sandbox, created with `cabal sandbox init`. + ([virthualenv](http://hackage.haskell.org/package/virthualenv) or + [cabal-dev](http://hackage.haskell.org/package/cabal-dev) also work). c. or (easiest) erase your installed packages with [ghc-pkg-reset](https://gist.github.com/1185421) and try again. + For more detail, see [How to cabal install](https://www.fpcomplete.com/user/simonmichael/how-to-cabal-install). + #. **Dependency or compilation error in one of the new packages ?** If cabal starts downloading and building packages and then terminates with an error, look at the output carefully and identify the problem @@ -175,11 +177,11 @@ or get help. or limit GHC's heap size by doing `cabal install ... --ghc-options='+RTS -M400m'` (400 megabytes works well on my 1G VPS, adjust up or down..) -#. **Can't load .so/.DLL for: ncursesw (/usr/lib/libncursesw.so: file too short)** +#. **Can't load .so/.DLL for: ncursesw (/usr/lib/libncursesw.so: file too short)** (or similar): cf [GHC bug #5551](http://hackage.haskell.org/trac/ghc/ticket/5551). Upgrade GHC to 7.2.1, or try your luck with [this workaround](http://eclipsefp.github.com/faq.html). -#. **Undefined iconv symbols on OS X** +#. **Undefined iconv symbols on OS X** This kind of error: Linking dist/build/hledger/hledger ... diff --git a/site/content.yaml b/site/content.yaml index df39ec2bc..7261626de 100644 --- a/site/content.yaml +++ b/site/content.yaml @@ -4,7 +4,7 @@ data: home: true -- title : Installation +- title : Installing url : INSTALL.html source : INSTALL.md