globalmaphack: be more general (fmap, factoring, ...)
[mate.git] / README
diff --git a/README b/README
index 77dd07a6af00fb4076ed90fff5ae8621e110f909..aacc02e13e8ce49240b918ba997a4e24588d7e79 100644 (file)
--- a/README
+++ b/README
@@ -1,19 +1,51 @@
+MateVM is i686 only, at the moment.
+
 == DEPENDENCIES ==
+=== GHC ===
+install GHC via your distro manager. make sure you install
+it with shared libaries.
+on ubuntu 12.04 LTS it is:
+       $ sudo apt-get install ghc-dynamic
+
+for an "easy" installation of the remaining packages, you can use
+the script "./tools/installhaskellenv.sh".
+note, that it deletes your ~/.cabal and ~/.ghc directory first.
+
+
 === HARPY ===
-       $ cabal install harpy
+       $ cabal install harpy --enable-shared
+
+if this fails (e.g. you use ghc >= 7.0) then try our patched version:
+       $ git clone git://wien.tomnetworks.com/harpy.git
+       $ cd harpy
+       $ cabal configure --enable-shared
+       $ cabal build
+       $ cabal install --enable-shared
+
 
 === HS-JAVA ===
 for `hs-java' a patched build is needed:
        $ git clone git://wien.tomnetworks.com/hs-java.git
-       $ git checkout v0.2
-       $ cd hs-java; cabal configure; cabal build; cabal install
+       $ cd hs-java
+       $ git checkout -t origin/v0.2
+       $ cabal configure --enable-shared
+       $ cabal build
+       $ cabal install --enable-shared
+hint: for some unknown reason yet, it seems building from source will be easier
+if you first install `hs-java' via cabal (like `harpy' above)
+
+
+=== MISC ===
+       $ cabal install missingh --enable-shared
+       $ cabal install heap --enable-shared
+       $ cabal install plugins --enable-shared
 
 
 == NOTE ==
 unfortunately, many haskell libaries arn't tested very well, so building
 libraries from hackage can be a very painful trip.
 
-a system configuration we had success building all required
+some system configurations we had success building all required
 libraries (yes, no x86_64 so far!):
        $ uname -a
        Linux hermann 2.6.32-22-generic-pae #36-Ubuntu SMP Thu Jun 3 23:14:23 UTC
@@ -27,3 +59,130 @@ libraries (yes, no x86_64 so far!):
        Copyright (C) 2009 Free Software Foundation, Inc.
        This is free software; see the source for copying conditions.  There is NO
        warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+       $ ghc-pkg list
+       /var/lib/ghc-6.12.1/package.conf.d:
+               Cabal-1.8.0.2
+               array-0.3.0.0
+               base-3.0.3.2
+               base-4.2.0.0
+               bin-package-db-0.0.0.0
+               bytestring-0.9.1.5
+               containers-0.3.0.0
+               directory-1.0.1.0
+               (dph-base-0.4.0)
+               (dph-par-0.4.0)
+               (dph-prim-interface-0.4.0)
+               (dph-prim-par-0.4.0)
+               (dph-prim-seq-0.4.0)
+               (dph-seq-0.4.0)
+               extensible-exceptions-0.1.1.1
+               filepath-1.1.0.3
+               (ghc-6.12.1)
+               (ghc-binary-0.5.0.2)
+               ghc-prim-0.2.0.0
+               haskell98-1.0.1.1
+               hpc-0.5.0.4
+               integer-gmp-0.2.0.0
+               old-locale-1.0.0.2
+               old-time-1.0.0.3
+               pretty-1.0.1.1
+               process-1.0.1.2
+               random-1.0.0.2
+               rts-1.0
+               syb-0.1.0.2
+               template-haskell-2.4.0.0
+               time-1.1.4
+               unix-2.4.0.0
+               utf8-string-0.3.4
+
+       /home/lewurm/.ghc/i386-linux-6.12.1/package.conf.d:
+               Cabal-1.10.2.0
+               HTTP-4000.2.3
+               binary-0.5.1.0
+               binary-state-0.1.1
+               control-monad-exception-0.10.1
+               data-binary-ieee754-0.4.2.1
+               deepseq-1.3.0.0
+               disassembler-0.1.0.1
+               failure-0.2.0.1
+               harpy-0.4.3.0
+               hs-java-0.2
+               monadloc-0.6
+               mtl-1.1.1.1
+               mtl-2.1
+               network-2.3.0.11
+               parsec-2.1.0.1
+               parsec-3.1.2
+               text-0.11.2.0
+               transformers-0.3.0.0
+               zlib-0.5.3.3
+
+
+       $ uname -a
+       Linux matevm-dev 3.2.0-23-generic #36-Ubuntu SMP Tue Apr 10 20:41:14 UTC 2012 i686 athlon i386 GNU/Linux
+       $ cat /etc/issue
+       Ubuntu 12.04 LTS \n \l
+       $ ghc --version
+       The Glorious Glasgow Haskell Compilation System, version 7.4.1
+       $ gcc --version
+       gcc (Ubuntu/Linaro 4.6.3-1ubuntu5) 4.6.3
+       Copyright (C) 2011 Free Software Foundation, Inc.
+       This is free software; see the source for copying conditions.  There is NO
+       warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+       $ ghc-pkg list
+       /var/lib/ghc/package.conf.d:
+               Cabal-1.14.0
+               array-0.4.0.0
+               base-4.5.0.0
+               bin-package-db-0.0.0.0
+               binary-0.5.1.0
+               bytestring-0.9.2.1
+               containers-0.4.2.1
+               deepseq-1.3.0.0
+               directory-1.1.0.2
+               extensible-exceptions-0.1.1.4
+               filepath-1.3.0.0
+               (ghc-7.4.1)
+               ghc-prim-0.2.0.0
+               (haskell2010-1.1.0.1)
+               (haskell98-2.0.0.1)
+               hoopl-3.8.7.3
+               hpc-0.5.1.1
+               integer-gmp-0.4.0.0
+               old-locale-1.0.0.4
+               old-time-1.1.0.0
+               pretty-1.1.1.0
+               process-1.1.0.1
+               rts-1.0
+               template-haskell-2.7.0.0
+               time-1.4
+               unix-2.5.1.0
+
+       /home/lewurm/.ghc/i386-linux-7.4.1/package.conf.d:
+               HUnit-1.2.4.2
+               MissingH-1.1.1.0
+               QuickCheck-2.4.2
+               binary-state-0.1.1
+               control-monad-exception-0.10.2
+               data-binary-ieee754-0.4.2.1
+               disassembler-0.1.0.1
+               failure-0.2.0.1
+               ghc-paths-0.1.0.8
+               harpy-0.4.3.0
+               haskell-src-1.0.1.5
+               heap-1.0.0
+               hs-java-0.2
+               hslogger-1.1.5
+               monadloc-0.6
+               mtl-1.1.1.1
+               mtl-2.1.1
+               network-2.3.0.13
+               parsec-2.1.0.1
+               plugins-1.5.2.1
+               random-1.0.1.1
+               regex-base-0.93.2
+               regex-compat-0.95.1
+               regex-posix-0.95.1
+               syb-0.3.6.1
+               transformers-0.3.0.0
+               utf8-string-0.3.7