[[project @ 2001-01-10 11:50:43 by rrt] rrt**20010110115043 Improved Windows installation instructions, thanks to a test drive by Andrew Tolmach. ] { hunk ./ghc/docs/users_guide/installing.sgml 8 -(Why binaries? Because GHC is a Haskell compiler written in Haskell, -so you've got to “bootstrap” it, somehow. We provide +(Why binaries? Because GHC is a Haskell compiler written in Haskell, +so you've got to bootstrap it somehow. We provide hunk ./ghc/docs/users_guide/installing.sgml 13 -proceed. For the other fptools programs, many are written in Haskell, -so binary distributions allow you to install them without having a Haskell compiler.) +proceed. For the other fptools programs, many are written in Haskell, so binary distributions allow you to install them without having a Haskell compiler.) hunk ./ghc/docs/users_guide/installing.sgml 510 -your machine to run GHC (at least that's the intention ;-) +your machine to run GHC. hunk ./ghc/docs/users_guide/installing.sgml 516 -An installation of GHC requires ca. 200M of disk space, which is split -roughly 50-50 between GHC and the supporting software. To run GHC +An installation of GHC requires about 50M of disk space (which can be lowered by choosing a “compact” installation). The Cygwin support tools take another 200M or so (though if you really need to this can be halved by installing only the following packages: bash, binutils, cygwin, diff, fileutils, findutils, gcc, grep, make, perl, mingw, sed, textutils, w32api; however, it's fiddly and not recommended). To run GHC hunk ./ghc/docs/users_guide/installing.sgml 529 -The cygwin toolchain (1.1) +The Cygwin toolchain (1.1.x) hunk ./ghc/docs/users_guide/installing.sgml 532 -GHC depends at the moment on the cygwin tools to operate, which -dresses up the Win32 environment into something more UNIX-like. -(notably, it provides gcc, as and ld), -so you'll need to install these tools first. You also need -Cygwin to use CVS. (We don't yet support later versions of Cygwin.) +At the moment you'll need Cygwin to use GHC. Cygwin dresses up the Win32 +environment into something more UNIX-like; (notably, it provides +gcc, as and ld). +You also need Cygwin to use CVS. hunk ./ghc/docs/users_guide/installing.sgml 573 -Install Cygwin 1.1 from sources.redhat.com. If you -have an earlier version, you must deinstall this first. Choose DOS text -mode. After installation, start up a Cygwin shell and issue the following -commands: +Install the latest Cygwin 1.1.x from sources.redhat.com/cygwin. +If you have a pre-1.1 version, you should deinstall this first. Choose DOS +text mode. After installation, start up a Cygwin shell and issue the +following command: hunk ./ghc/docs/users_guide/installing.sgml 580 -mount -f c: / -mount c:\\cygwin\\usr\\include /usr/include +mount -f c: / hunk ./ghc/docs/users_guide/installing.sgml 589 -Create the following directories (if they aren't already there; substitute -the drive you installed Cygwin on for c:): - - - -c:/Temp -c:/etc -c:/bin -c:/usr/local/bin - - - -(using mkdir -p /bin, etc.) +Create C:/Temp if it doesn't already exist; substitute +the drive you installed Cygwin on for C:). hunk ./ghc/docs/users_guide/installing.sgml 622 -Add ";C:/whatever/" to the end of the string (for example) +Add ";C:\whatever" to the end of the string (for example) hunk ./ghc/docs/users_guide/installing.sgml 644 -Windows/system/Sysedit. You must reboot to make +Windows/System/Sysedit. You must reboot to make hunk ./ghc/docs/users_guide/installing.sgml 663 -Add c:/bin and c:/usr/local/bin. -These should come before the Windows system directories -(e.g. \WINNT\system32). You might want to set them in -your .bashrc rather than in the system-wide -PATH. +Add C:\usr\bin. +This should come before the Windows system directories +(e.g. \WINNT\system32). hunk ./ghc/docs/users_guide/installing.sgml 673 -c:/bin/sh. +C:/usr/bin/bash. hunk ./ghc/docs/users_guide/installing.sgml 681 -Set to point to your home directory. This is where, for example, +Set to point to your home directory (normally under +C:/WINNT/Profiles on Win2k). This is where, for example, hunk ./ghc/docs/users_guide/installing.sgml 693 -this you get very weird messages when you type `make', such as: +this you get very weird messages when you type make, such as: hunk ./ghc/docs/users_guide/installing.sgml 702 -Set 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. +Set to C:/Temp. 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. hunk ./ghc/docs/users_guide/installing.sgml 708 -Reason: file does not exist /tmp/ghc11068.cpp +Reason: file does not exist /Temp/ghc11068.cpp hunk ./ghc/docs/users_guide/installing.sgml 729 - -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. - - - - hunk ./ghc/docs/users_guide/installing.sgml 735 -Download a GHC distribution: +Download the latest GHC distribution: hunk ./ghc/docs/users_guide/installing.sgml 741 -ghc-4.08—InstallShield installer, 15M: ghc-4.08 InstallShield installer, 15M: bin/ directory to your path (i.e. -/path/to/wherever/ghc-4.08/bin ). -You need to do this in order to bring the various GHC DLLs into scope; -if not, then you need to copy the DLLs into a directory that is (the -system directory, for example). +ghc bin/ directory to your path (e.g. +/ghc/ghc-4.08/bin ). +You need to do this in order to bring the various GHC binaries into scope. hunk ./ghc/docs/users_guide/installing.sgml 779 -under Cygwin installation, including TMPDIR +under Cygwin installation, including TMPDIR. hunk ./ghc/docs/users_guide/installing.sgml 791 -bash$ /path/to/the/ghc/bin/directory/ghc-4.08 -o main main.hs +bash$ ghc -o main main.hs hunk ./ghc/docs/users_guide/installing.sgml 818 - - -Invoking ghc doesn't seem to do anything, it immediately returns without having compiled the input file. - - - - - One cause of this is that /bin/sh is missing. To -verify, open up a bash session and type ls -l -/bin/sh.exe. If sh.exe is reported as not -being there, copy bash.exe (which you'll find inside -the cygwin installation tree as bin/bash.exe) to -/bin/sh.exe. - - -All being well, ghc should then start to function. - - - - - - - hunk ./ghc/docs/users_guide/installing.sgml 838 -I'm getting ``permission denied'' messages from rm or +I'm getting &ldquote;permission denied&rdquote; messages from rm or hunk ./ghc/docs/users_guide/installing.sgml 869 - + }