People constantly ask about this, clearly without having found the documentation that we do have about this. So we need to make it more obvious: - Simplify the setup documentation to emphasize the Hydra cache (which is the only working one currently). - Move the cache troubleshooting section to the top to make it more obvious. - Highlight a link to the troubleshooting section of the docs in the README. - Emphasize that there is more documentation than is linked in the README. - Add a section to the README that explicitly mentions cache issues, and links to the corresponding sections of the docs.
2.4 KiB
haskell.nix
is infrastructure for building Haskell packages with Nix
haskell.nix
can automatically translate your Cabal or Stack project and
its dependencies into Nix code.
Documentation
- Introduction
- Getting Started
- Troubleshooting
- Explore the documentation from there to find further topics.
Help! Something isn't working
The #1 problem that people have when using haskell.nix
is that they find themselves building GHC.
This should not happen, but you must follow the haskell.nix
setup instructions properly to avoid it.
If you find this happening to you, please check that you have followed the
getting started instructions and
consult the corresponding troubleshooting section.
The troubleshooting documentation also contains some help for other common issues. Please give it a read before asking on IRC or opening an issue.
If you're still stuck, join the #haskell.nix channel on irc.freenode.net, or open an issue.
Related repos
The haskell.nix
repository contains the runtime system for building
Haskell packages in Nix. It depends on other repos, which are:
-
nix-tools
— provides the programs for generating Nix expressions from Haskell projects. -
hackage.nix
— the latest contents of the Hackage databases, converted to Nix expressions. -
stackage.nix
— all of the Stackage snapshots, converted to Nix expressions.