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.10/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/latest/
  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 beta18 of the cygwin32 tools and depends on
  54 it to work.
  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 basic port of perl5.004 done on top of cygwin32-b18 is
  60 is available from
  61
  62    ftp://ftp.dcs.gla.ac.uk/pub/haskell/glasgow/working/perl5-004pl1.zip
  63
  64 this port is by no means complete, but is sufficient for our needs.
  65 (more complete perl5 cygwin32 binary bundles are available
  66  elsewhere - search the web if you need it.)
  67
  68 Install both cygwin32&perl5 before continuing.
  69
  70 NOTE: If you're planning to install ghc on a drive different from
  71 where you're going to compile programs, you need to change the TMPDIR
  72 variable in the Makefile to "."
  73
  74 -------Win32 users only----------------------------------------