[[project @ 2000-08-09 13:37:56 by rrt] rrt**20000809133756 Updates to Windows docs to cope with changes in new Cygwin and head of tree GHC. ] { hunk ./ghc/docs/users_guide/installing.sgml 517 -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. hunk ./ghc/docs/users_guide/installing.sgml 531 -The cygwin toolchain (beta20.1) +The cygwin toolchain (1.1) hunk ./ghc/docs/users_guide/installing.sgml 576 -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. hunk ./ghc/docs/users_guide/installing.sgml 584 -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:): hunk ./ghc/docs/users_guide/installing.sgml 602 -(cygwin-b20/H-i586-cygwin32/bin/bash.exe) to +(cygwin/bin/bash.exe) to hunk ./ghc/docs/users_guide/installing.sgml 723 -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. hunk ./ghc/docs/users_guide/installing.sgml 725 -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: hunk ./ghc/docs/users_guide/installing.sgml 781 -(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. hunk ./ghc/docs/users_guide/installing.sgml 791 - -When the installer has completed its job, you may delete the -ghcInstall directory. - - hunk ./ghc/docs/users_guide/installing.sgml 801 -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. hunk ./ghc/docs/users_guide/installing.sgml 838 -Further information on using GHC under Windows can be found in 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. hunk ./ghc/docs/users_guide/installing.sgml 886 + + + + + + + + +I'm having trouble with . + + + + + +Static linking is no longer supported under Windows, and probably won't work. + hunk ./ghc/docs/users_guide/using.sgml 2700 -Tell the linker to avoid shared libraries. +Tell the linker to avoid shared libraries. This option should not be used under Windows. hunk ./ghc/docs/users_guide/win32-dlls.sgml 57 -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. }