X-Git-Url: http://git.megacz.com/?a=blobdiff_plain;f=distrib%2FINSTALL;h=679c62124ef4353a384fa32c7832f4cc533549b1;hb=2744e4fb443cbfe1f3eeeb781079382071ca3cda;hp=6e209cd0e782d8651f7e51f6ef20dd4c38dbe93f;hpb=e32b12a400e9e5e5aac2f7878d123df02286bb9d;p=ghc-hetmet.git diff --git a/distrib/INSTALL b/distrib/INSTALL index 6e209cd..679c621 100644 --- a/distrib/INSTALL +++ b/distrib/INSTALL @@ -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---------------------------------------- +--------------------------------------------------------------------