site: download: note sierra/ghc issue, provide older ghc commands

This commit is contained in:
Simon Michael 2017-07-13 09:21:16 +01:00
parent 874f58ed9b
commit 5079727f3b

View File

@ -50,7 +50,7 @@ You have to build it, but this is relatively easy:
2. **`stack install hledger-lib-1.3 hledger-1.3 [hledger-ui-1.3] [hledger-web-1.3] [hledger-api-1.3]`**\ 2. **`stack install hledger-lib-1.3 hledger-1.3 [hledger-ui-1.3] [hledger-web-1.3] [hledger-api-1.3]`**\
\ \
Don't type the square brackets; they indicate optional packages which you can skip to save time.\ Don't type the square brackets; they indicate optional packages which you can omit to save time.\
hledger-ui is [not yet available on Windows](https://github.com/jtdaugherty/vty/pull/1#issuecomment-297143444).\ hledger-ui is [not yet available on Windows](https://github.com/jtdaugherty/vty/pull/1#issuecomment-297143444).\
This command installs the latest released hledger packages (and the haskell libraries and tools they depend on) from an This command installs the latest released hledger packages (and the haskell libraries and tools they depend on) from an
[appropriate](https://www.stackage.org/package/hledger-lib) [appropriate](https://www.stackage.org/package/hledger-lib)
@ -62,6 +62,7 @@ You have to build it, but this is relatively easy:
You can add `--dry-run` to see what it plans to do, and kill/restart it without losing progress.\ You can add `--dry-run` to see what it plans to do, and kill/restart it without losing progress.\
If it says you need to run `stack setup`, do that then run the install command again.\ If it says you need to run `stack setup`, do that then run the install command again.\
If it says "Error: While constructing the build plan...", try adding `--resolver=lts` to the install command, or setting a newer resolver in `$HOME/.stack/global/stack.yaml`.\ If it says "Error: While constructing the build plan...", try adding `--resolver=lts` to the install command, or setting a newer resolver in `$HOME/.stack/global/stack.yaml`.\
On Mac, if it says "ghc: panic! ... no suitable image found", you may need to specify GHC 8.0.2+/lts-8+, as above.\
If it gives "Invalid package ID" errors, get a newer version of stack (see step 1).\ If it gives "Invalid package ID" errors, get a newer version of stack (see step 1).\
If you're a [cabal](https://www.haskell.org/cabal/) expert, feel free to use that instead of stack.\ If you're a [cabal](https://www.haskell.org/cabal/) expert, feel free to use that instead of stack.\
If you get errors due to missing C libraries (like curses or terminfo), install those manually, eg: If you get errors due to missing C libraries (like curses or terminfo), install those manually, eg:
@ -71,6 +72,11 @@ You have to build it, but this is relatively easy:
| Debian, Ubuntu: | `sudo apt install libncurses5-dev` | Debian, Ubuntu: | `sudo apt install libncurses5-dev`
| Fedora, RHEL: | `sudo dnf install ncurses-devel` | Fedora, RHEL: | `sudo dnf install ncurses-devel`
If you need to build with an older GHC version for some reason, these commands should work
(except on Mac sierra which [requires GHC 8.0.2+](https://ghc.haskell.org/trac/ghc/ticket/12479)):\
GHC 7.10.3: `stack install --resolver lts-6 hledger-lib-1.3 hledger-1.3 hledger-ui-1.3 hledger-web-1.3 hledger-api-1.3 megaparsec-5.3.1 brick-0.19 vty-5.15.1 data-clist-0.1.2.0 text-zipper-0.10`\
GHC 8.0.1: `stack install --resolver lts-7 hledger-lib-1.3 hledger-1.3 hledger-ui-1.3 hledger-web-1.3 hledger-api-1.3 brick-0.19 vty-5.15.1 data-clist-0.1.2.0`
Now you should be able to run `hledger --version` and see a version similar to the above Now you should be able to run `hledger --version` and see a version similar to the above
(and `hledger-ui --version`, `hledger-web --version` etc. if you installed those). (and `hledger-ui --version`, `hledger-web --version` etc. if you installed those).