summaryrefslogtreecommitdiff
path: root/doc/install
diff options
context:
space:
mode:
authorGravatar Joey Hess <joeyh@joeyh.name>2015-05-19 15:50:42 -0400
committerGravatar Joey Hess <joeyh@joeyh.name>2015-05-19 15:50:42 -0400
commit6edd8c86a4b57a9b844a35ba3206454c688d8e98 (patch)
tree3f7dde145eac54ad98ce2c3ececccbcdd9d1f951 /doc/install
parent9492d76b43ac0c8cc909769a1448e0cce1fdb411 (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.mdwn16
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