distrib/INSTALL

   1 This is the INSTALL instructions for a binary bundle of the
   2 Glorious Glasgow Haskell Compilation System. For more details
   3 on what on earth this package is up to, please consult the README
   4 and ANNOUNCE.
   5
   6 To start using the bundle, you can either:
   7
   8 * use it in-place, i.e., don't go ahead with a
   9   full install, but just set it up to use the unpacked
  10   distribution from where it was unpacked.
  11
  12 * get it over with, and do the full install (details of how are ahead).
  13
  14 NOTE Win32 users: see comment below before continuing.
  15
  16 To set the ball rolling, run the configure script (as usual, run
  17 the script with --help to see what options it supports).
  18
  19 This will figure out what platform you're running on, and a couple of other
  20 interesting pieces of trivia, which it will then fill in the Makefile.in
  21 template to give you a real Makefile.
  22
  23 Have a look at the Makefile to see if you agree with the information
  24 therein. If you want to use the bundle in-place, now run `make in-place'.
  25 If you're installing, `make install' (`make show-install-setup' prints
  26 the details of where the different pieces of the bundle are heading when
  27 -- possibly helpful).
  28
  29 For more information, please consult the installation guide in
  30 {html,dvi,info}/ghc-2.02/installing{.dvi,.info,_toc.html}.
  31
  32 Bug reports/suggestions for improvement to the installation procedure/setup
  33 (as well as other GHC related troubles you're experiencing, of course),
  34 gratefully received at glasgow-haskell-bugs@dcs.gla.ac.uk
  35
  36 Enjoy.
  37
  38
  39 -------Win32 users only----------------------------------------
  40 NOTE to Win32 users: to enjoy any sort of happiness with the GHC
  41 tools, you will have to install the cygwin32 toolchain, which dresses
  42 up the Win32 environment into something more UNIX-like (which
  43 this initial port of ghc relies on being the case). The cygwin32 tools
  44 are available from
  45
  46     ftp://ftp.cygnus.com/pub/gnu-win32/gnu-win32-b17.1/
  47        (Cygnus Solutions; Mt. View, CA.)
  48     ftp://sunsite.doc.ic.ac.uk/pub/gnu/cygnus/gnu-win32/
  49         (Sunsite Northern Europe; Imperial College, London)
  50     ftp://ftp.crl.go.jp/pub/GNU/cygnus/gnu-win32/
  51         (CRL, Ministry of Posts and Telecom., Japan)
  52
  53 GHC was built with beta17 - you *might* get away with beta16 if you've already got it
  54 installed...not tested this though.
  55
  56 The GHC tools are also quite picky about Perl, the commonly-used
  57 Hip/ActiveWare Win32 port of perl5 just ain't Cool Enough (main reason:
  58 GHC scripts assume they are talking to an underlying UNIX command
  59 shell). A port of perl5.003 done on top of cygwin32-b17 is just
  60 the ticket though, it is available from
  61
  62    http://www.edv.agrar.tu-muenchen.de/~syring/gnu-win32/
  63
  64 this port is not complete - but the binaries available from there
  65 are sufficiently wonderful.
  66
  67 Install both cygwin32&perl5 before continuing.
  68
  69 Future releases of GHC for Win32 may very well avoid relying on
  70 cygwin32 to operate, for various reasons..
  71
  72 -------Win32 users only----------------------------------------