From 51df463c17d9cb149b4b0c5a1981cb3645d980b1 Mon Sep 17 00:00:00 2001 From: rrt Date: Wed, 9 Aug 2000 13:37:56 +0000 Subject: [PATCH] [project @ 2000-08-09 13:37:56 by rrt] Updates to Windows docs to cope with changes in new Cygwin and head of tree GHC. --- ghc/docs/users_guide/installing.sgml | 64 ++++++++++++++++++---------------- ghc/docs/users_guide/using.sgml | 2 +- ghc/docs/users_guide/win32-dlls.sgml | 4 +-- 3 files changed, 35 insertions(+), 35 deletions(-) diff --git a/ghc/docs/users_guide/installing.sgml b/ghc/docs/users_guide/installing.sgml index 36c776f..fa3c6cf 100644 --- a/ghc/docs/users_guide/installing.sgml +++ b/ghc/docs/users_guide/installing.sgml @@ -514,13 +514,9 @@ your machine to run GHC (at least that's the intention ;-) System requirements -An installation of GHC requires ca. 70M of disk space. The size of the -installed GHC distribution is just(!) 17M, the rest is needed by -supporting software. - - - -To run GHC comfortably, your machine should have at least 32M of memory. +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 +comfortably, your machine should have at least 64M of memory. @@ -532,7 +528,7 @@ To run GHC comfortably, your machine should have at least 32M of memory. 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) +The cygwin toolchain (1.1) GHC depends at the moment on the cygwin tools to operate, which @@ -577,15 +573,15 @@ Here's how to install Cygwin. -Download cygwin, beta20.1 (full.exe) from -sourceware.cygnus.com -Install this somewhere locally. +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. -Create the following directories (if they aren't already there): +Create the following directories (if they aren't already there; substitute the drive you installed Cygwin on for c:): @@ -603,7 +599,7 @@ Create the following directories (if they aren't already there): Copy bash.exe from the bin directory of the cygwin tree -(cygwin-b20/H-i586-cygwin32/bin/bash.exe) to +(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 @@ -724,15 +720,9 @@ this you get very weird messages when you type `make', such a TMPDIR User -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:/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. -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: +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: does not exist Action: openFile @@ -788,7 +778,7 @@ URL="http://www.haskell.org/ghc/dist/ghc-4-08.exe">http -(The version number may change.) It is packaged up using an installer that should be familiar-looking to Windows users. Unpack and double click on setup.exe. +(The version number may change.) It is packaged up using an installer that should be familiar-looking to Windows users. @@ -799,11 +789,6 @@ in /Program Files/!) -When the installer has completed its job, you may delete the -ghcInstall directory. - - - When the installer has completed, make sure you add the location of the ghc bin/ directory to your path (i.e. /path/to/wherever/ghc-4.08/bin ). @@ -813,9 +798,10 @@ system directory, for example). -Note: In case you haven't got perl already installed, -you will have to manually copy the perl.exe binary from the -ghc bin/ into your /bin directory before continuing—the installer will not currently do this. +Note: If you haven't got perl already installed, you will have to manually +copy the perl.exe binary from the ghc +bin/ into your /bin directory +before continuing—the installer will not currently do this. @@ -849,7 +835,7 @@ Haskell programs :-) If not, consult the installation FAQ (Sigbjørn Finne's pages. +Further information on using GHC under Windows can be found in Sigbjørn Finne's pages. Note: ignore the installation instructions, which are rather out of date; the Miscellaneous section at the bottom of the page is of most interest, covering topics beyond the scope of this manual. @@ -905,6 +891,22 @@ work with symlinks. +I'm having trouble with . + + + + + +Static linking is no longer supported under Windows, and probably won't work. + + + + + + + + + I'm getting ``permission denied'' messages from rm or mv. diff --git a/ghc/docs/users_guide/using.sgml b/ghc/docs/users_guide/using.sgml index 7663cd7..08d629a 100644 --- a/ghc/docs/users_guide/using.sgml +++ b/ghc/docs/users_guide/using.sgml @@ -2697,7 +2697,7 @@ Where to find user-supplied libraries… Prepend the directory -static option -Tell the linker to avoid shared libraries. +Tell the linker to avoid shared libraries. This option should not be used under Windows. diff --git a/ghc/docs/users_guide/win32-dlls.sgml b/ghc/docs/users_guide/win32-dlls.sgml index ce1cbff..75284d7 100644 --- a/ghc/docs/users_guide/win32-dlls.sgml +++ b/ghc/docs/users_guide/win32-dlls.sgml @@ -54,9 +54,7 @@ will give you a binary as before, but the main.exe generate -static option (Win32) -If you want to build an executable that doesn't depend on any -ghc-compiled DLLs, use the option to link in -the code statically. +This is no longer supported, and probably doesn't work; but if you want to build an executable that doesn't depend on any ghc-compiled DLLs, use the option to link in the code statically. -- 1.7.10.4