Skip to content

Commit c4c04ce

Browse files
committed
Update build docs to match hie-bios branch
1 parent b1363df commit c4c04ce

File tree

1 file changed

+5
-3
lines changed

1 file changed

+5
-3
lines changed

docs/Build.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ The design of the build system has the following main goals:
1010

1111
* works identically on every platform
1212
* has minimal run-time dependencies:
13-
- `stack`
13+
- `stack` or `cabal`
1414
- `git`
1515
* is completely functional right after a simple `git clone` and after every `git pull`
1616
* prevents certain build failures by either identifying a failed precondition (such as wrong `stack` version) or by performing the necessary steps so users can't forget them (such as invoking `git` to update submodules)
@@ -38,7 +38,7 @@ Each `stack-*.yaml` contains references to packages in the submodules. Calling `
3838

3939
`hie` depends on a correct environment in order to function properly:
4040

41-
* `cabal-install`: This dependency is required by `hie` to handle correctly projects that are not `stack` based (without `stack.yaml`). You can install an appropriate version using `stack` with the `stack-install-cabal` target.
41+
* `cabal-install`: This dependency is required by `hie` to handle correctly projects that are not `stack` based. You can install an appropriate version using `stack` with the `stack-install-cabal` target.
4242
* The `hoogle` database: `hoogle generate` needs to be called with the most-recent `hoogle` version.
4343

4444
### Steps to build `hie`
@@ -89,7 +89,7 @@ The final step is to configure the `hie` client to use a custom `hie-wrapper` sc
8989
The `install.hs` script performs some checks to ensure that a correct installation is possible and provide meaningful error messages for known issues.
9090

9191
* `stack` needs to be up-to-date. Version `1.9.3` is required
92-
* `cabal` needs to be up-to-date. Version `2.4.1.0` is required to *use* haskell-ide-engine until the pull request #1126 is merged. Unfortunately cabal version `3.0.0.0` is needed to *install* hie in windows systems but that inconsistence will be fixed by the mentioned pull request.
92+
* `cabal` needs to be up-to-date. Version `3.0.0.0` is required for windows systems and `2.4.1.0` for other ones.
9393
* `ghc-8.6.3` is broken on windows. Trying to install `hie-8.6.3` on windows is not possible.
9494
* When the build fails, an error message, that suggests to remove `.stack-work` directory, is displayed.
9595

@@ -104,3 +104,5 @@ Currently, `stack` is needed even if you run the script with `cabal` to get the
104104
Before the code in `install.hs` can be executed, `stack` installs a `GHC`, depending on the `resolver` field in `shake.yaml`. This is necessary if `install.hs` should be completely functional right after a fresh `git clone` without further configuration.
105105

106106
This may lead to an extra `GHC` to be installed by `stack` if not all versions of `haskell-ide-engine` are installed.
107+
108+
However, you always could change the resolver in `shake.yaml` to match the appropiate one.

0 commit comments

Comments
 (0)