diff options
author | Joey Hess <joeyh@joeyh.name> | 2015-05-19 15:50:42 -0400 |
---|---|---|
committer | Joey Hess <joeyh@joeyh.name> | 2015-05-19 15:50:42 -0400 |
commit | 6edd8c86a4b57a9b844a35ba3206454c688d8e98 (patch) | |
tree | 3f7dde145eac54ad98ce2c3ececccbcdd9d1f951 /doc/install | |
parent | 9492d76b43ac0c8cc909769a1448e0cce1fdb411 (diff) |
git-annex is now available in stackage; suggest using to in fromsource to avoid cabal hell issues
Diffstat (limited to 'doc/install')
-rw-r--r-- | doc/install/fromsource.mdwn | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/doc/install/fromsource.mdwn b/doc/install/fromsource.mdwn index 3f2987b67..fdb7823fc 100644 --- a/doc/install/fromsource.mdwn +++ b/doc/install/fromsource.mdwn @@ -34,12 +34,18 @@ First, install everything git-annex needs to build: Now you can build git-annex by running either `make` or `cabal build` inside the source tree. -## minimal build with cabal +## minimal build with cabal and stackage This can be done anywhere, and builds git-annex without some optional features that require harder-to-install C libraries. This is plenty to let you get started with git-annex, but it does not include the assistant or webapp. +Be warned that this involves building a lot of Haskell libraries from +source, and so it has a lot of moving parts, and it's not uncommon for it +to be broken from time to time. A nice way to avoid such breakage is to +[configure cabal to use the Stackage repository](http://www.stackage.org/), +which is a more stable and consistent version of the Hackage repository. + Inside the source tree, run: cabal configure -f"-assistant -webapp -webdav -pairing -xmpp -dns" @@ -48,17 +54,15 @@ Inside the source tree, run: PATH=$HOME/bin:$PATH cabal install --bindir=$HOME/bin -Be warned that this involves building a lot of Haskell libraries from -source, and so it has a lot of moving parts, and it's not uncommon for it -to be broken from time to time. - -## full build with cabal +## full build with cabal and stackage To build with all features enabled, including the assistant and webapp, you will need to install several C libraries and their headers, including libgnutls, libgsasl, libxml2, and zlib. How to do that for your OS is beyond the scope of this page. +Using [Stackage](http://www.stackage.org/) is again a good idea here! + Once the C libraries are installed, run inside the source tree: cabal configure |