X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=distrib%2FINSTALL;h=445a71c61bdf24fa9defe22897c8c70f672e9712;hb=cb098b276d0ad2883d3add27dd472eb6f9f8de20;hp=aa64209559ec18d479d22f0a44cb5fd4d8feee57;hpb=40228ff098d30281c307a7979bc714a8efed8e40;p=ghc-hetmet.git diff --git a/distrib/INSTALL b/distrib/INSTALL index aa64209..445a71c 100644 --- a/distrib/INSTALL +++ b/distrib/INSTALL @@ -1,13 +1,12 @@ -This is the INSTALL instructions for a binary bundle of the -Glorious Glasgow Haskell Compilation System. For more details -on what on earth this package is up to, please consult the README -and ANNOUNCE. +This is the INSTALL instructions for a binary distribution of one of +the fptools projects. For more details on what on earth this package +is up to, please consult the README and ANNOUNCE. To start using the bundle, you can either: * use it in-place, i.e., don't go ahead with a full install, but just set it up to use the unpacked - distribution from where it was unpacked. + distribution in-situ. * get it over with, and do the full install (details of how are ahead). @@ -18,16 +17,32 @@ the script with --help to see what options it supports). This will figure out what platform you're running on, and a couple of other interesting pieces of trivia, which it will then fill in the Makefile.in -template to give you a real Makefile. +template to give you a real Makefile. + +[Win32 users: don't be alarmed if you should encounter the following + message from the configure script: + + not updating unwritable cache ./config.cache + +This is a known problem of generated autoconf configure scripts running +on cygwin, but harmless (it only means you get to re-do all the configure +tests should you decide to re-run the script.) +] Have a look at the Makefile to see if you agree with the information -therein. If you want to use the bundle in-place, now run `make in-place'. -If you're installing, `make install' (`make show-install-setup' prints -the details of where the different pieces of the bundle are heading when --- possibly helpful). +therein. If you want to use the bundle in-place, now run: + + make in-place + +If you're installing, run -For more information, please consult the installation guide in -{html,dvi,info}/ghc-2.10/installing{.dvi,.info,_toc.html}. + make install + +(`make show-install-setup' prints the details of where the different +pieces of the bundle are heading when -- possibly helpful). + +GHC's installation instructions have more information, check out +http://www.haskell.org/ghc/documentation.html. Bug reports/suggestions for improvement to the installation procedure/setup (as well as other GHC related troubles you're experiencing, of course), @@ -38,37 +53,33 @@ Enjoy. -------Win32 users only---------------------------------------- NOTE to Win32 users: to enjoy any sort of happiness with the GHC -tools, you will have to install the cygwin32 toolchain, which dresses +tools, you will have to install the cygwin toolchain, which dresses up the Win32 environment into something more UNIX-like (which -this initial port of ghc relies on being the case). The cygwin32 tools +this initial port of ghc relies on being the case). The cygwin tools are available from - ftp://ftp.cygnus.com/pub/gnu-win32/latest/ - (Cygnus Solutions; Mt. View, CA.) - ftp://sunsite.doc.ic.ac.uk/pub/gnu/cygnus/gnu-win32/ - (Sunsite Northern Europe; Imperial College, London) - ftp://ftp.crl.go.jp/pub/GNU/cygnus/gnu-win32/ - (CRL, Ministry of Posts and Telecom., Japan) - -GHC was built with beta18 of the cygwin32 tools and depends on -it to work. + http://sourceware.cygnus.com/cygwin/ -The GHC tools are also quite picky about Perl, the commonly-used -Hip/ActiveWare Win32 port of perl5 just ain't Cool Enough (main reason: -GHC scripts assume they are talking to an underlying UNIX command -shell). A basic port of perl5.004 done on top of cygwin32-b18 is -is available from +GHC was built with beta20.1 of the cygwin tools and depends on it +to work. - ftp://ftp.dcs.gla.ac.uk/pub/haskell/glasgow/working/perl5-004pl1.zip +Install cygwin before continuing. Couple of things to remember +doing while installing these two: -this port is by no means complete, but is sufficient for our needs. -(more complete perl5 cygwin32 binary bundles are available - elsewhere - search the web if you need it.) + - Create a toplevel /bin directory, and copy bash.exe into it + as sh.exe (we'll need this for running the configure script.) + Add /bin to your PATH. + - Create a toplevel /tmp directory. -Install both cygwin32&perl5 before continuing. +Additionally, ghc requires perl to operate, so included in the +binary distribution is a perl binary, (perl.exe in the toplevel +directory.) Install (as in copy :-) this somewhere along your +PATH too (/bin is a good choice.) -NOTE: If you're planning to install ghc on a drive different from -where you're going to compile programs, you need to change the TMPDIR -variable in the Makefile to "." +This is hardly beatiful, but it avoids having to download and install +yet another package, including piles of (useful) perl libraries that the +ghc perl code does not require to operate. Besides which, there's a +dearth of readily useable perl distributions 'out there' that contain +cygwin-compiled binaries, something we really do depend on. -------Win32 users only----------------------------------------