diff options
author | Artem Pelenitsyn <a.pelenitsyn@gmail.com> | 2019-03-11 13:40:48 -0400 |
---|---|---|
committer | Marge Bot <ben+marge-bot@smart-cactus.org> | 2019-03-29 14:18:12 -0400 |
commit | 97ad5cfb1c41d19cc56f7450c1e42d988dc9fd2d (patch) | |
tree | c340e3ecd55729c8b36cf20c62f6159d05396893 | |
parent | 4acdb769705de63c721555e70bef5c3dff87e3c5 (diff) | |
download | haskell-97ad5cfb1c41d19cc56f7450c1e42d988dc9fd2d.tar.gz |
Add some tips to the Troubleshooting section of README
-rw-r--r-- | hadrian/README.md | 25 |
1 files changed, 17 insertions, 8 deletions
diff --git a/hadrian/README.md b/hadrian/README.md index 3ca9787fa8..2f89e2e275 100644 --- a/hadrian/README.md +++ b/hadrian/README.md @@ -248,14 +248,23 @@ Here are a few simple suggestions that might help you fix the build: * If Hadrian fails with the message `Configuration file hadrian/cfg/system.config is missing`, you have probably - forgotten to pass the `--configure` flag during the first build. - -* If you need help in debugging Hadrian, read the - [wiki](https://github.com/snowleopard/hadrian/wiki) - and Shake's [debugging tutorial](https://shakebuild.com/debugging). - -If nothing helps, don't hesitate to create a GHC issue, choosing the -component `Build System (Hadrian)`. + forgotten to pass the `--configure` flag during the first build. + +* With the `--configure` (`-c`) flag, Hadrian sometimes fetches a wrong + Happy saying something like: `HappyTemplate-arrays-coerce: openFile: does not exist` + (as mentioned [here](https://github.com/haskell/cabal/issues/5867)), in + which case you might be better off running `./configure` manually before Hadrian. + +* The call to `build test` sometimes fails with + `libCffi_p.a: copyFile: does not exist` (as noticed + [here](https://gitlab.haskell.org/ghc/ghc/issues/15877#note_166739)). + The workaround is to `rm _build/stage1/libffi/build/inst/lib/libffi.a` and + start over. + +If you need help in debugging Hadrian, read the +[wiki](https://github.com/snowleopard/hadrian/wiki) +and Shake's [debugging tutorial](https://shakebuild.com/debugging). +If nothing helps, don't hesitate to create a GHC issue. Current limitations ------------------- |