additions from Reilly Hayes
[ghc-hetmet.git] / distrib / INSTALL
index 53b9449..1e8ad14 100644 (file)
@@ -1,72 +1,48 @@
-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 either be installed in a location of your
+choosing, or it can be used directly in-place (but it needs to be set
+up first, read on).
 
-* 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.
+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 <my-dir>, use
 
-* get it over with, and do the full install (details of how are ahead).
+       ./configure --prefix=<my-dir>
 
-NOTE Win32 users: see comment below before continuing.
+The default installation directory is /usr/local.  To use GHC
+in-place, the --prefix option can be omitted.
 
-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.
+To use the software in-place, now run:
 
-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).
+       make in-place
 
-For more information, please consult the installation guide in
-{html,dvi,info}/ghc-2.02/installing{.dvi,.info,_toc.html}.
+or if you're installing,  run
 
-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
+       make install 
 
-Enjoy.
+(`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:
 
--------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
-up the Win32 environment into something more UNIX-like (which
-this initial port of ghc relies on being the case). The cygwin32 tools
-are available from
+  http://www.haskell.org/ghc
 
-    ftp://ftp.cygnus.com/pub/gnu-win32/gnu-win32-b17.1/   
-       (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)
+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:
 
-GHC was built with beta17 - you *might* get away with beta16 if you've already got it
-installed...not tested this though.
+  http://www.haskell.org/ghc/reportabug
 
-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 port of perl5.003 done on top of cygwin32-b17 is just
-the ticket though, it is available from 
-
-   http://www.edv.agrar.tu-muenchen.de/~syring/gnu-win32/
-
-this port is not complete - but the binaries available from there
-are sufficiently wonderful.
-
-Install both cygwin32&perl5 before continuing.
-
-Future releases of GHC for Win32 may very well avoid relying on
-cygwin32 to operate, for various reasons..
-
--------Win32 users only----------------------------------------
+Enjoy,
+-- The GHC Team.