[project @ 2001-05-16 09:55:27 by rrt]
[ghc-hetmet.git] / distrib / INSTALL
index 6e209cd..679c621 100644 (file)
@@ -1,7 +1,36 @@
-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.
+
+--------------------------------------------------------------------
+
+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.
 
 To start using the bundle, you can either:
 
@@ -26,72 +55,29 @@ template to give you a real Makefile.
       not updating unwritable cache ./config.cache
 
 This is a known problem of generated autoconf configure scripts running
-on cygwin32, but harmless (it only means you get to re-do all the configure
+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),
-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 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
-
-    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.
-
-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 
-
-   ftp://ftp.dcs.gla.ac.uk/pub/haskell/glasgow/working/perl5-004pl1.zip
-
-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.)
-
-Install both cygwin32&perl5 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.
-  - If you don't have a good reason not to, it is also recommended
-    that you also put the perl binary inside /bin as well. Don't
-    put it inside the bin/ directory inside the installed cygwin32
-    tree, as this is likely to cause #! not to work on perl scripts
-    (path is likely to exceed 32 chars.)
-
-NOTE: If you're planning to install ghc on a drive different from
-where you're going to compile programs, you either need to
-change the TMPDIR variable in the Makefile to "." or the
-environment variable TMPDIR to "." when running ghc. This is clearly
-not desirable, but the only solution known to work under beta18.
-
--------Win32 users only----------------------------------------
+--------------------------------------------------------------------