[[project @ 2002-02-25 16:49:22 by simonpj]
simonpj**20020225164922
add win32 info
] {
hunk ./ghc/docs/users_guide/installing.sgml 530
-
-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.
-
+
+Getting the Glasgow Haskell Compiler (post 5.02) to run on Windows platforms is
+a snap: the Installshield does everything you need.
+
hunk ./ghc/docs/users_guide/installing.sgml 535
-
-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 on Windows
hunk ./ghc/docs/users_guide/installing.sgml 537
+
+To install GHC, use the following steps:
+
+
+Download the Installshield setup.exe
+from the GHC download page
+haskell.org.
+
hunk ./ghc/docs/users_guide/installing.sgml 547
-Installing GHC
-
-
-Download the latest GHC distribution (ghc-5.02 InstallShield installer, 27M)
-from 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".
+
+
hunk ./ghc/docs/users_guide/installing.sgml 558
-
-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.
-
+
+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
+
hunk ./ghc/docs/users_guide/installing.sgml 567
-
-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.
-
+
+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.
+
hunk ./ghc/docs/users_guide/installing.sgml 587
+
hunk ./ghc/docs/users_guide/installing.sgml 603
+
+
hunk ./ghc/docs/users_guide/installing.sgml 606
+
+
+You do not need the Cygwin toolchain, or anything
+else, to install and run GHC.
+
hunk ./ghc/docs/users_guide/installing.sgml 612
-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.
hunk ./ghc/docs/users_guide/installing.sgml 616
+
hunk ./ghc/docs/users_guide/installing.sgml 618
+Moving GHC around
hunk ./ghc/docs/users_guide/installing.sgml 620
-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.
hunk ./ghc/docs/users_guide/installing.sgml 633
-
-
-
+
hunk ./ghc/docs/users_guide/installing.sgml 679
+
+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.
+
}