summary refs log tree commit diff
diff options
context:
space:
mode:
authorPeter Simons <simons@cryp.to>2018-08-13 08:58:43 +0200
committerGitHub <noreply@github.com>2018-08-13 08:58:43 +0200
commit7a4b1fa093b22eba2bf57a9316857fbcbb2b1965 (patch)
tree3be8a866f0e42a9207a461df29d1dbcf11aed1b1
parent37624959670b6c6f7560272954969068402fae02 (diff)
parent0e7a34a1aa64bb7e59832558bba8c5e66e7d049e (diff)
downloadnixlib-7a4b1fa093b22eba2bf57a9316857fbcbb2b1965.tar
nixlib-7a4b1fa093b22eba2bf57a9316857fbcbb2b1965.tar.gz
nixlib-7a4b1fa093b22eba2bf57a9316857fbcbb2b1965.tar.bz2
nixlib-7a4b1fa093b22eba2bf57a9316857fbcbb2b1965.tar.lz
nixlib-7a4b1fa093b22eba2bf57a9316857fbcbb2b1965.tar.xz
nixlib-7a4b1fa093b22eba2bf57a9316857fbcbb2b1965.tar.zst
nixlib-7a4b1fa093b22eba2bf57a9316857fbcbb2b1965.zip
Merge pull request #44969 from carlosdagos/docs-hackage2nix
docs: add some docs mentioning hackage2nix
-rw-r--r--doc/languages-frameworks/haskell.section.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/languages-frameworks/haskell.section.md b/doc/languages-frameworks/haskell.section.md
index c0dc741eabca..7677c366191f 100644
--- a/doc/languages-frameworks/haskell.section.md
+++ b/doc/languages-frameworks/haskell.section.md
@@ -1047,6 +1047,19 @@ As you can see, `packunused` finds out that although the testsuite component has
 no redundant dependencies the library component of `scientific-0.3.5.1` depends
 on `ghc-prim` which is unused in the library.
 
+### Using hackage2nix with nixpkgs
+
+Hackage package derivations are found in the
+[`hackage-packages.nix`](https://github.com/NixOS/nixpkgs/blob/master/pkgs/development/haskell-modules/hackage-packages.nix)
+file within `nixpkgs` and are used as the initial package set for
+`haskellPackages`. The `hackage-packages.nix` file is not meant to be edited
+by hand, but rather autogenerated by [`hackage2nix`](https://github.com/NixOS/cabal2nix/tree/master/hackage2nix),
+which by default uses the [`configuration-hackage2nix.yaml`](https://github.com/NixOS/nixpkgs/blob/master/pkgs/development/haskell-modules/configuration-hackage2nix.yaml)
+file to generate all the derivations.
+
+To modify the contents `configuration-hackage2nix.yaml`, follow the
+instructions on [`hackage2nix`](https://github.com/NixOS/cabal2nix/tree/master/hackage2nix).
+
 ## Other resources
 
   - The Youtube video [Nix Loves Haskell](https://www.youtube.com/watch?v=BsBhi_r-OeE)