doc: install guide updates

This commit is contained in:
Simon Michael 2014-01-12 18:17:59 -08:00
parent 60fb9c1f3f
commit 04f828ea88
2 changed files with 9 additions and 7 deletions

View File

@ -136,7 +136,7 @@ or get help.
If your cabal is modern enough, adding `--max-backjumps=10000` should help. If your cabal is modern enough, adding `--max-backjumps=10000` should help.
([more](https://groups.google.com/d/topic/hledger/FdWGTSAVzYU/discussion)). ([more](https://groups.google.com/d/topic/hledger/FdWGTSAVzYU/discussion)).
#. <a name="cabaldeps" />**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 Cabal dependency failures become more likely as you install more
packages over time. If `cabal install hledger-web --dry` says it can't packages over time. If `cabal install hledger-web --dry` says it can't
satisfy dependencies, you have this problem. You can: 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 or which constraints to add (with `--constraint 'PKG == ...'`) to help cabal
find a solution find a solution
b. install into a fresh environment created with b. install into a fresh cabal sandbox, created with `cabal sandbox init`.
[virthualenv](http://hackage.haskell.org/package/virthualenv) or ([virthualenv](http://hackage.haskell.org/package/virthualenv) or
[cabal-dev](http://hackage.haskell.org/package/cabal-dev) [cabal-dev](http://hackage.haskell.org/package/cabal-dev) also work).
c. or (easiest) erase your installed packages with c. or (easiest) erase your installed packages with
[ghc-pkg-reset](https://gist.github.com/1185421) and try again. [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 ?** #. **Dependency or compilation error in one of the new packages ?**
If cabal starts downloading and building packages and then terminates If cabal starts downloading and building packages and then terminates
with an error, look at the output carefully and identify the problem 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 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..) -M400m'` (400 megabytes works well on my 1G VPS, adjust up or down..)
#. <a name="5551" />**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). (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). Upgrade GHC to 7.2.1, or try your luck with [this workaround](http://eclipsefp.github.com/faq.html).
#. <a name="iconv" />**Undefined iconv symbols on OS X** #. **Undefined iconv symbols on OS X**
This kind of error: This kind of error:
Linking dist/build/hledger/hledger ... Linking dist/build/hledger/hledger ...

View File

@ -4,7 +4,7 @@
data: data:
home: true home: true
- title : Installation - title : Installing
url : INSTALL.html url : INSTALL.html
source : INSTALL.md source : INSTALL.md