X-Git-Url: http://git.megacz.com/?p=ghc-hetmet.git;a=blobdiff_plain;f=distrib%2FINSTALL;h=2e374be47e7b8bdee0352465a1a3d6d256fe9a67;hp=c37e8824821b827b6eddd94e36525b0f84841cbc;hb=e5c3b478b3cd1707cf122833822f44b2ac09b8e9;hpb=0268d6925e117661769fbe1ed823cbef7e4da8e3 diff --git a/distrib/INSTALL b/distrib/INSTALL index c37e882..2e374be 100644 --- a/distrib/INSTALL +++ b/distrib/INSTALL @@ -1,80 +1,41 @@ -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 GHC. 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: +This distribution can be installed in a location of your choosing. -* use it in-place, i.e., don't go ahead with a - full install, but just set it up to use the unpacked - distribution in-situ. +To set the ball rolling, run the configure script (as usual, run the +script with --help to see what options it supports). eg. to set up +the package for installing in directory , use -* get it over with, and do the full install (details of how are ahead). + ./configure --prefix= -NOTE Win32 users: see comment below before continuing. +The default installation directory is /usr/local. -To set the ball rolling, run the configure script (as usual, run -the script with --help to see what options it supports). +The configure script 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. If +you're of a paranoid persuasion, you might want to take a look at this +Makefile to see if the information is correct. -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. +Now run: -[Win32 users: don't be alarmed if you should encounter the following - message from the configure script: - - not updating unwritable cache ./config.cache + make install -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.) -] +(`make show-install-setup' prints the details of where the different +pieces of the bundle are heading when -- possibly helpful). -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). +For more information, full GHC documentation is available from the +main GHC site: -For more information, please consult the installation guide in -{html,dvi,info}/ghc-/installing{.dvi,.info,_toc.html}. + http://www.haskell.org/ghc -Bug reports/suggestions for improvement to the installation procedure/setup -(as well as other GHC related troubles you're experiencing, of course), -gratefully received at glasgow-haskell-bugs@dcs.gla.ac.uk +Bug reports/suggestions for improvement to the installation +procedure/setup (as well as other GHC related troubles you're +experiencing, of course), gratefully received. Bug reporting +instructions are here: -Enjoy. + http://www.haskell.org/ghc/reportabug - --------Win32 users only---------------------------------------- -NOTE to Win32 users: to enjoy any sort of happiness with the GHC -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 cygwin tools -are available from - - http://sourceware.cygnus.com/cygwin/ - -GHC was built with beta20.1 of the cygwin tools and depends on it -to work. - -Install cygwin before continuing. Couple of things to remember -doing while installing these two: - - - 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. - -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.) - -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---------------------------------------- +Enjoy, +-- The GHC Team.