From: rrt Date: Tue, 12 Sep 2000 13:13:55 +0000 (+0000) Subject: [project @ 2000-09-12 13:13:55 by rrt] X-Git-Tag: Approximately_9120_patches~3753 X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=a4d2e93301be52e25cff7be55e7cf41b6a054842;p=ghc-hetmet.git [project @ 2000-09-12 13:13:55 by rrt] Numerous fixes (thanks to Peter Achten for most of them) to the Windows instructions to make them more accurate and clearer. --- diff --git a/ghc/docs/users_guide/installing.sgml b/ghc/docs/users_guide/installing.sgml index 48d15f5..2d88695 100644 --- a/ghc/docs/users_guide/installing.sgml +++ b/ghc/docs/users_guide/installing.sgml @@ -573,18 +573,29 @@ Here's how to install Cygwin. -Install Cygwin 1.1 from -sources.redhat.com -Install this somewhere locally. Despite the warnings, things seem to work better if you install Cygwin into the root directory rather than cygwin, which is the default. If you're upgrading from Cygwin B20.1, running mount --import-old-mounts immediately after installation may help. Either way, you want to end up with your main drive mounted in textmode, and only the bin directories mounted in binmode. +Install Cygwin 1.1 from sources.redhat.com Install +this into your root directory (C:\), despite the +warnings (but you may want to back up C:\bin, +C:\etc, C:\lib, +C:\usr and C:\var first) and +choose DOS text mode. If you're upgrading from Cygwin B20.1, running +mount --import-old-mounts immediately after installation +may help. Either way, you want to end up with your main drive mounted in +textmode, and only the +bin directories mounted in binmode +(you can check by running mount). -Create the following directories (if they aren't already there; substitute the drive you installed Cygwin on for c:): +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 @@ -597,19 +608,6 @@ Create the following directories (if they aren't already there; substitute the d -Copy bash.exe from the bin -directory of the cygwin tree -(cygwin/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. - - - - - 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. @@ -677,13 +675,10 @@ The following environment variables must be set: PATH System -Add C:/cygnus/cygwin-b20/H-i586-cygwin32/bin. -bash needs this, and when it is invoked from -/bin it can't find it. c:/bin and -c:/usr/local/bin should also be added. These should all -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 +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. @@ -720,7 +715,7 @@ this you get very weird messages when you type `make', such a TMPDIR User -Set to c:/tmp (note the forward slash). 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:/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 weird messages when you invoke GHC, such as: @@ -773,12 +768,13 @@ Download a GHC distribution: ghc-4.08—InstallShield installer, 15M: http +URL="http://www.haskell.org/ghc/download.html">http -(The version number may change.) It is packaged up using an installer that should be familiar-looking to Windows users. +It is packaged up using an installer that should be familiar-looking to +Windows users. @@ -857,13 +853,12 @@ Invoking ghc doesn't seem to do anything, it immediately returns without having - -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 H-i586-cygwin32/bin/bash.exe) -to /bin/sh.exe. - + 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. @@ -1038,9 +1033,12 @@ just make a symlink from It's a good idea to use Norman Walsh's installation -notes as a guide. You should get version -3.1 of DocBook, and note that his file test.sgm won't -work, as it needs version 3.0. You should unpack Jade into \Jade, along with the entities, DocBook into \docbook, and the DocBook stylesheets into \docbook\stylesheets (so they actually end up in \docbook\stylesheets\docbook). +notes as a guide. You should get version 3.1 of DocBook, and note +that his file test.sgm won't work, as it needs version +3.0. You should unpack Jade into \Jade, along with the +entities, DocBook into \docbook, and the DocBook +stylesheets into \docbook\stylesheets (so they actually +end up in \docbook\stylesheets\docbook).