|
5 | 5 | This extension adds language support for [Haskell](https://haskell.org), powered by the [Haskell Language Server](https://github.com/haskell/haskell-language-server).
|
6 | 6 | As almost all features are provided by the server you might find interesting read its [documentation](https://haskell-language-server.readthedocs.io).
|
7 | 7 |
|
| 8 | +## Setup |
| 9 | + |
| 10 | +This Extension comes with "batteries"-included and can manage your Haskell Language Server installations for you, |
| 11 | +powered by [GHCup](https://www.haskell.org/ghcup/). |
| 12 | +Installation of [GHCup](https://www.haskell.org/ghcup/) can not happen automatically, so if you want your HLS installations to be |
| 13 | +managed by the Extension, you will have to follow the [installation instructions for GHCup](https://www.haskell.org/ghcup/). |
| 14 | + |
| 15 | +**Note:** Make sure you have a working `ghcup` installation, before launching the Extension. |
| 16 | + |
8 | 17 | ## Features
|
9 | 18 |
|
10 | 19 | You can watch demos for some of these features [here](https://haskell-language-server.readthedocs.io/en/latest/features.html#demos).
|
@@ -78,7 +87,7 @@ first start. Check the `haskell.manageHLS` setting.
|
78 | 87 |
|
79 | 88 | It will then download the newest version of haskell-language-server which has support for the required ghc.
|
80 | 89 | That means it could use an older version than the latest one, without the last features and bug fixes.
|
81 |
| -For example, if a project needs ghc-8.10.4 the extension will download and use haskell-language-server-1.4.0, the lastest version which supported ghc-8.10.4. Even if the lastest global haskell language-server version is 1.5.1. |
| 90 | +For example, if a project needs ghc-8.10.4 the extension will download and use haskell-language-server-1.4.0, the latest version which supported ghc-8.10.4. Even if the latest global haskell language-server version is 1.5.1. |
82 | 91 |
|
83 | 92 | If you have disk space issues, check `ghcup gc --help`.
|
84 | 93 |
|
@@ -153,13 +162,13 @@ Please include the output when filing any issues on the [haskell-language-server
|
153 | 162 |
|
154 | 163 | - Sometimes the language server might get stuck in a rut and stop responding to your latest changes.
|
155 | 164 | Should this occur you can try restarting the language server with <kbd>Ctrl</kbd> <kbd>shift</kbd> <kbd>P</kbd>/<kbd>⌘</kbd> <kbd>shift</kbd> <kbd>P</kbd> > Restart Haskell LSP Server.
|
156 |
| - |
| 165 | + |
157 | 166 | #### `Cradle requires ghc/cabal/stack but it isn't installed`
|
158 | 167 |
|
159 | 168 | - In Linux/MacOS systems, opening vscode in the windows system could not use the `$PATH` set in the shell
|
160 | 169 | so it will not see required tools as ghc, cabal or stack. This usually happens if you have installed them
|
161 |
| - via ghcup. |
162 |
| -- It could be fixed changing the `$PATH` variable in the init config file used by the windows system |
| 170 | + via ghcup. |
| 171 | +- It could be fixed changing the `$PATH` variable in the init config file used by the windows system |
163 | 172 | (f.e. `~/.profile`, but i can vary depending on your system setup).
|
164 | 173 | - See [this stackoverflow question](https://stackoverflow.com/questions/43983718/set-global-path-environment-variable-in-vs-code) for more tricks.
|
165 | 174 |
|
|
0 commit comments