From: simonpj Date: Mon, 24 Jan 2000 10:40:05 +0000 (+0000) Subject: [project @ 2000-01-24 10:40:05 by simonpj] X-Git-Tag: Approximately_9120_patches~5235 X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=8b298c81b8e6811a534d326392c19622e02e7c8a;p=ghc-hetmet.git [project @ 2000-01-24 10:40:05 by simonpj] Extra install stuff --- diff --git a/ghc/docs/users_guide/installing.sgml b/ghc/docs/users_guide/installing.sgml index ef02fcd..b9d37c1 100644 --- a/ghc/docs/users_guide/installing.sgml +++ b/ghc/docs/users_guide/installing.sgml @@ -540,7 +540,10 @@ To run GHC comfortably, your machine should have at least 32M of memory. Your environment variables -Much of the Unixy stuff below involves setting environment variables. For example, on WinNT/Win2k, to edit your PATH variable, +Much of the Unixy stuff below involves setting environment variables. +This section summarises how to set these variables on a Windows machine, in +case you don't know alread.y +On WinNT/Win2k, to edit your PATH variable (for example), do the following: @@ -582,10 +585,11 @@ the new settings take effect. Software required - - -The cygwin toolchain (beta20.1) - +You need two chunks of software other than GHC itself: the Cygwin toolchain, and +Perl. Here's how to get and install them. + +The cygwin toolchain (beta20.1) + GHC depends at the moment on the cygwin tools to operate, which dresses up the Win32 environment into something more UNIX-like. @@ -659,15 +663,14 @@ Add the two bin directories to your PATH -Copy bash.exe from the bin directory of the cygwin tree (cygwin-b20/H-i586-cygwin32/bin/bash.exe) to -/bin as sh.exe. This is where Emacs looks for a shell (I think). - - - - - -You might think that it was easier to use bash directly from it original -Cygwin directory, but (a) some UNIX utils have got /bin/sh hardwired in, and (b) the path following #! is limited to 32 characters. +Copy bash.exe from the bin +directory of the cygwin tree +(cygwin-b20/H-i586-cygwin32/bin/bash.exe) to +/bin as sh.exe. You might +think that it was easier to use bash directly from it original Cygwin +directory, but (a) some UNIX utils have got +/bin/sh hardwired in, and (b) the path following +#! is limited to 32 characters. @@ -707,9 +710,23 @@ this you get very weird messages when you type `make', such a -Set the TMPDIR user environment variable to /tmp. For some reason, Win2k invisibly sets this variable to point to a temporary directory in your profile, that contains embedded spaces. If GHC sees the TMPDIR variable set, it tries to use it for temporary files, but -Cygwin doesn't grok filenames with spaces, so disaster results. +Set the TMPDIR user environment variable to +c:/tmp. For some reason, Win2k invisibly sets +this variable to point to a temporary directory in your profile, that +contains embedded spaces. If GHC sees the TMPDIR +variable set, it tries to use it for temporary files, but Cygwin +doesn't grok filenames with spaces, so disaster results. + +Furthermore, it seems that TMPDIR must be set to a directory +in the same file system in which you invoke GHC. Otherwise you get very werid messages +when you invoke GHC, such as: + + does not exist + Action: openFile + Reason: file does not exist /tmp/ghc11068.cpp + +We think this is due to a bug in Cygwin. @@ -721,80 +738,21 @@ instructions on how to set this up. + - - +Perl5 - -Perl5 - + The driver script is written in Perl, so you'll need to have this installed too. However, the ghc binary distribution includes a perl binary for you to make use of, should you not already have a cygwin compatible one. Note: GHC does not work with the ActiveState port of perl. - - - - - + - -Installing the supporting software - - - - -Download cygwin beta20.1 (full.exe). Install this somewhere locally. - - - - - -After having successfully installed this, make sure you do the following: - - - - - -Create a /bin directory (using mkdir -p /bin). - - - - - -Copy bash.exe from the bin directory of the cygwin tree (cygwin-b20/H-i586-cygwin32/bin/bash.exe) to -/bin as sh.exe. - - - - - -If you haven't already got one, create a /tmp directory. - - - - - -If you're an Emacs user and want to be able to run bash -from within a shell buffer, see the NT Emacs home page for -instructions on how to set this up. - - - - - - - - - - -With the supporting software in place, we can finally get on to installing GHC itself. - - - + Installing GHC @@ -870,6 +828,10 @@ along your path too. +Make sure that you set all the environment variables described above +under Cygwin installation, including TMPDIR + + To test the fruits of your labour, try now to compile a simple Haskell program: