mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

git-annex is now available in stackage; suggest using to in fromsource to avoid cabal hell issues

Browse source
This commit is contained in:
Joey Hess 2015-05-19 15:50:42 -04:00
parent 97fecbf7c6
commit 8aab9bd324
1 changed files with 10 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

16
doc/install/fromsource.mdwn
View file

@ -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` Now you can build git-annex by running either `make` or `cabal build`
inside the source tree. 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 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 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. 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: Inside the source tree, run:
cabal configure -f"-assistant -webapp -webdav -pairing -xmpp -dns" cabal configure -f"-assistant -webapp -webdav -pairing -xmpp -dns"
@ -48,17 +54,15 @@ Inside the source tree, run:
PATH=$HOME/bin:$PATH PATH=$HOME/bin:$PATH
cabal install --bindir=$HOME/bin cabal install --bindir=$HOME/bin
Be warned that this involves building a lot of Haskell libraries from ## full build with cabal and stackage
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
To build with all features enabled, including the assistant and webapp, To build with all features enabled, including the assistant and webapp,
you will need to install several C libraries and their headers, you will need to install several C libraries and their headers,
including libgnutls, libgsasl, libxml2, and zlib. How to do that for including libgnutls, libgsasl, libxml2, and zlib. How to do that for
your OS is beyond the scope of this page. 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: Once the C libraries are installed, run inside the source tree:
cabal configure cabal configure