From f126b0cb2fc29e415ab616e95fc10345dfe91d8c Mon Sep 17 00:00:00 2001 From: simonpj Date: Mon, 25 Feb 2002 16:49:22 +0000 Subject: [PATCH] [project @ 2002-02-25 16:49:22 by simonpj] add win32 info --- ghc/docs/users_guide/installing.sgml | 131 ++++++++++++++++++++++------------ 1 file changed, 87 insertions(+), 44 deletions(-) diff --git a/ghc/docs/users_guide/installing.sgml b/ghc/docs/users_guide/installing.sgml index a7b2cd0..fd6feda 100644 --- a/ghc/docs/users_guide/installing.sgml +++ b/ghc/docs/users_guide/installing.sgml @@ -527,43 +527,64 @@ on... Installing on Windows - -Getting the Glasgow Haskell Compiler (GHC) to run on Windows platforms can -be a bit of a trying experience. It should be much easier now than in the -past, since all the software required to use GHC is included in -the InstallShield. - - - -An installation of GHC requires about 140M of disk space. -To run GHC comfortably, your machine should have at least -64M of memory. - - - -Installing GHC + +Getting the Glasgow Haskell Compiler (post 5.02) to run on Windows platforms is +a snap: the Installshield does everything you need. + - -Download the latest GHC distribution (ghc-5.02 InstallShield installer, 27M) -from haskell.org. - +Installing GHC on Windows - -When the installer has completed, make sure you add the location of the -ghc bin/ directory to your path, as directed in the -final dialog of the installer. You need to do this in order to bring the -various GHC binaries into scope. - + +To install GHC, use the following steps: + + +Download the Installshield setup.exe +from the GHC download page +haskell.org. + + +Run setup.exe. +(If you have a previous version of GHC, Installshield will offer to "modify", +or "remove" GHC. Choose "remove"; then run setup.exe a +second time. This time it should offer to install.) + + +At this point you should find GHCi and the GHC documentation are +available in your Start menu under "Start/Programs/Glasgow Haskell Compiler". + + - -You can freely move the GHC tree once you've installed it just by copying -the ghc-x.yy directory. You might want to do this in -order to use GHC with tools that don't like spaces in paths (GHC is -installed in \Program Files\Glasgow Haskell -Compiler by default. - + +The final dialogue box from the install process tells you where GHC has +been installed. If you want to invoke GHC from a command line, add this +to your PATH environment variable. Usually, GHC installs into +c:/ghc/ghc-5.02, though the last part of this path +depends on which version of GHC you are installing, of course. +You need to add c:/ghc/ghc-5.02/bin to your path if yo + + + +GHC needs a directory in which to create, and later delete, temporary files. +It uses the standard Windows procedure GetTempPath() to +find a suitable directory. This procedure returns: + +The path in environment variable TMP, +if TMP is set. +Otherwise, the path in environment variable TEMP, +if TEMP is set. +Otherwise, there is a per-user default which varies +between versions of Windows. On NT and XP-ish versions, it might +be: +c:\Documents and Settings\<username>\Local Settings\Temp + + +The main point is that if you don't do anything GHC will work fine; +but if you want to control where the directory is, you can do so by +setting TMP or TEMP. + + To test the fruits of your labour, try now to compile a simple Haskell program: @@ -579,23 +600,37 @@ bash$ ghc -o main main.hs bash$ ./main Hello, world! bash$ + + + + +You do not need the Cygwin toolchain, or anything +else, to install and run GHC. + -OK, assuming that worked, you're all set. Go forth and write useful -Haskell programs :-) If not, consult the installation FAQ (); if that still doesn't help then please report the problems you're experiencing (see ). +An installation of GHC requires about 140M of disk space. +To run GHC comfortably, your machine should have at least +64M of memory. + +Moving GHC around -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. +At the moment, GHC installs in a fixed place (c:/ghc/ghc-x.yy, +but once it is installed, you can freely move the entire GHC tree just by copying +the ghc-x.yy directory. (You may need to fix up +the links in "Start/Programs/Glasgow Haskell Compiler" if you do this.) + + +It is OK to put GHC tree in a directory whose path involves spaces. However, +don't do this if you use want to use GHC with the Cygwin tools, +because Cygwin can get confused when this happpens. +We havn't quite got to the bottom of this, but so far as we know it's not +a problem with GHC itself. Nevertheless, just to keep life simple we usually +put GHC in a place with a space-free path. - - - + Installing ghc-win32 FAQ @@ -641,6 +676,14 @@ on or rebooting may be the quickest cure. + +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. + -- 1.7.10.4