diff options
author | Ian Lynagh <igloo@earth.li> | 2007-05-29 15:28:48 +0000 |
---|---|---|
committer | Ian Lynagh <igloo@earth.li> | 2007-05-29 15:28:48 +0000 |
commit | 455a8da72d0340c1e9b9c6c946ca2aba7c78e59a (patch) | |
tree | d68c6e270dd97047318d7451f7ef1e5f41b54729 /docs | |
parent | 78d145815572a7b28d6fb9169a5567a604e38846 (diff) | |
download | haskell-455a8da72d0340c1e9b9c6c946ca2aba7c78e59a.tar.gz |
Update Windows installation docs
Diffstat (limited to 'docs')
-rw-r--r-- | docs/users_guide/installing.xml | 64 |
1 files changed, 23 insertions, 41 deletions
diff --git a/docs/users_guide/installing.xml b/docs/users_guide/installing.xml index 6e6a56e672..71113ee51b 100644 --- a/docs/users_guide/installing.xml +++ b/docs/users_guide/installing.xml @@ -533,7 +533,7 @@ on...</para> <para> Getting the Glasgow Haskell Compiler (post 5.02) to run on Windows platforms is -a snap: the Installshield does everything you need. +a snap: the installer does everything you need. </para> <sect2><title>Installing GHC on Windows</title> @@ -542,38 +542,29 @@ a snap: the Installshield does everything you need. To install GHC, use the following steps: </para> <itemizedlist> -<listitem><para>Download the Installshield <filename>setup.exe</filename> -from the GHC download page +<listitem><para>Download the installer +from the <ulink -url="http://www.haskell.org/ghc">haskell.org</ulink>. +url="http://www.haskell.org/ghc/download.html">GHC download page</ulink>. </para></listitem> -<listitem><para>Run <filename>setup.exe</filename>. +<listitem><para>Run the installer. On Windows, all of GHC's files are installed in a single directory. -If you choose ``Custom'' from the list of install options, you will be given a -choice about where this directory is; otherwise it will be installed -in <filename>c:/ghc/<replaceable>ghc-version</replaceable></filename>. -The executable binary for GHC will be installed in the <filename>bin/</filename> sub-directory -of the installation directory you choose. -</para> -<para>(If you have already installed the same version of GHC, Installshield will offer to "modify", -or "remove" GHC. Choose "remove"; then run <filename>setup.exe</filename> a -second time. This time it should offer to install.) +You can override it, but by default this directory is +<filename>c:/ghc/<replaceable>ghc-version</replaceable></filename>. +The executable binary for GHC will be installed in the +<filename>bin/</filename> sub-directory of the installation directory. +If you want to invoke GHC from a command line, add this +to your PATH environment variable. </para> <para> -When installation is complete, you should find GHCi and the GHC documentation are -available in your Start menu under "Start/Programs/Glasgow Haskell Compiler". +When installation is complete, you should find GHCi and the GHC +documentation are available in your Start menu under +"Start/All Programs/GHC/<replaceable>ghc-version</replaceable>". </para> </listitem> <listitem><para> -The final dialogue box from the install process reminds you where the GHC binary -has been installed (usually <filename>c:/ghc/<replaceable>ghc-version</replaceable>/bin/</filename>. -If you want to invoke GHC from a command line, add this -to your PATH environment variable. -</para></listitem> - -<listitem><para> GHC needs a directory in which to create, and later delete, temporary files. It uses the standard Windows procedure <literal>GetTempPath()</literal> to find a suitable directory. This procedure returns: @@ -608,7 +599,7 @@ bash$ ghc -o main main.hs .. bash$ ./main Hello, world! -bash$ </screen> +bash$</screen> </listitem> </itemizedlist> @@ -617,7 +608,7 @@ You do <emphasis>not</emphasis> need the Cygwin toolchain, or anything else, to install and run GHC. </para> <para> -An installation of GHC requires about 140M of disk space. +An installation of GHC requires about 340M of disk space. To run GHC comfortably, your machine should have at least 64M of memory. </para> @@ -625,10 +616,11 @@ To run GHC comfortably, your machine should have at least <sect2><title>Moving GHC around</title> <para> -At the moment, GHC installs in a fixed place (<filename>c:/ghc/ghc-x.yy</filename>, -but once it is installed, you can freely move the entire GHC tree just by copying -the <filename>ghc-x.yy</filename> directory. (You may need to fix up -the links in "Start/Programs/Glasgow Haskell Compiler" if you do this.) +Once GHC is installed, you can freely move the entire GHC tree just by copying +the <filename>c:/ghc/<replaceable>ghc-version</replaceable></filename> +directory. (You will need to fix up +the links in "Start/All Programs/GHC/<replaceable>ghc-version</replaceable>" +if you do this.) </para> <para> It is OK to put GHC tree in a directory whose path involves spaces. However, @@ -647,7 +639,8 @@ put GHC in a place with a space-free path. <varlistentry> <term>I'm having trouble with symlinks.</term> <listitem> - <para>Symlinks only work under Cygwin (<xref linkend="install" />), so binaries not linked to the Cygwin + <para>Symlinks only work under Cygwin (<xref linkend="install" />), + so binaries not linked to the Cygwin DLL, in particular those built for Mingwin, will not work with symlinks.</para> </listitem> @@ -665,17 +658,6 @@ put GHC in a place with a space-free path. </listitem> </varlistentry> </variablelist> - -<!-- doesn't add much value any longer; leave out [sof 7/2002]. -<para> -Further information on using GHC under Windows can be found in <ulink -url="http://www.dcs.gla.ac.uk/~sof/ghc-win32.html">Sigbjørn Finne's -pages</ulink>. Note: ignore the installation instructions, which are rather -out of date; the <emphasis>Miscellaneous</emphasis> section at the bottom of -the page is of most interest, covering topics beyond the scope of this -manual. -</para> ---> </sect2> </sect1> |