Skip to content

Commit f3158bf

Browse files
Anton-Latukhapepeiborra
authored andcommitted
docs: contributing: upd "Using HLS on HLS code" section algorythm (#2341)
1 parent 937de21 commit f3158bf

File tree

1 file changed

+21
-5
lines changed

1 file changed

+21
-5
lines changed

docs/contributing/contributing.md

+21-5
Original file line numberDiff line numberDiff line change
@@ -113,17 +113,33 @@ $ cabal run haskell-language-server:func-test -- -p "hlint enables"
113113

114114
## Using HLS on HLS code
115115

116-
[HLS project configuration guidelines](../configuration.md#configuring-your-project-build) also apply to the HLS project itself.
116+
Project source code should load without `hie.yaml` setup.
117+
118+
In other cases:
119+
120+
1. Check if `hie.yaml` (& `hie.yml`) files left from previous configurations.
121+
122+
2. If the main project needs special configuration, note that other internal subprojects probably also would need configuration.
123+
124+
To create an explicit configuration for all projects - use [implicit-hie](https://github.com/Avi-D-coder/implicit-hie) generator directly:
125+
126+
```shell
127+
gen-hie > hie.yaml # into the main HLS directory
128+
```
129+
130+
that configuration should help.
131+
132+
3. Inspect & tune configuration explicitly.
133+
134+
[Configuring project build](../configuration.md#configuring-your-project-build) applies to HLS project source code loading just as to any other.
135+
136+
Note: HLS may implicitly detect codebase as a Stack project (see [hie-bios implicit configuration documentation](https://github.com/haskell/hie-bios/blob/master/README.md#implicit-configuration)). To use Cabal, try creating an `hie.yaml` file:
117137

118-
Note: HLS implicitly detects HLS codebase as a Stack project (see [hie-bios implicit configuration documentation](https://github.com/haskell/hie-bios/blob/master/README.md#implicit-configuration)).
119-
If you want HLS to use Cabal, you need to create an `hie.yaml` file:
120138
```yaml
121139
cradle:
122140
cabal:
123141
```
124142
125-
Also note that the `install/` subdirectory is a different project, so if you want to work on this part of the code, you may also have to create an `install/hie.yaml` file.
126-
127143
### Manually testing your hacked HLS
128144
If you want to test HLS while hacking on it, follow the steps below.
129145

0 commit comments

Comments
 (0)