[project @ 2001-05-16 09:55:27 by rrt]
[ghc-hetmet.git] / distrib / INSTALL
index 445a71c..679c621 100644 (file)
@@ -1,3 +1,33 @@
+
+--------------------------------------------------------------------
+
+The short story (if you are installing GHC from a binary dist):
+
+- Decide where you want to install it.
+- Do    ./configure --prefix=where-i-want-to-install-it
+- Do    make install
+
+That installs everything - the compiler, interactive system,
+libraries, and documentation.  At the end of 'make install' you will
+be informed of what you need to add to your PATH, and also the
+location of the documentation.
+
+Linux users: GHCi-5.00 needs libreadline.so.3.  Newer Linuxes (SuSE
+7.1, possibly RH 7.X, possibly Mandrake 8.X) only come with
+libreadline.so.4.  If you need libreadline.so.3 and only have the .4
+version, you might be able to get things working by making a symbolic
+link from libreadline.so.4 to libreadline.so.3.  We tried this on a
+SuSE 7.1 box and it seemed to work.
+
+If something doesn't work as it should, please contact us at
+glasgow-haskell-bugs@haskell.org.
+
+JRS, 10 April 2001.
+
+--------------------------------------------------------------------
+
+The Long Story
+
 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.
@@ -46,40 +76,8 @@ 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),
-gratefully received at glasgow-haskell-bugs@dcs.gla.ac.uk
+gratefully received at glasgow-haskell-bugs@haskell.org
 
 Enjoy.
 
-
--------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----------------------------------------
+--------------------------------------------------------------------