[project @ 2002-04-10 09:49:47 by simonmar]
[ghc-hetmet.git] / docs / building / building.sgml
index 3b483b2..650596b 100644 (file)
@@ -127,6 +127,11 @@ machine in order to compile (most of) the sources, however.
       <varlistentry>
        <term>Build GHC from intermediate C <Filename>.hc</Filename> files<indexterm><primary>hc files</primary></indexterm>:</term>
        <listitem>
+         <para><emphasis>NOTE: GHC version 5.xx is significantly
+         harder to bootstrap from C than previous versions.  We
+         recommend starting from version 4.08.2 if you need to
+         bootstrap in this way.</emphasis></para>
+
          <para>You need a working GHC to use a source distribution.
           What if you don't have a working GHC? Then you may be able
           to bootstrap up from the intermediate C
@@ -1096,13 +1101,13 @@ or higher)</term>
        </varlistentry>
 
        <varlistentry>
-         <term>i386-unknown-cygwin32:</term>
-         <indexterm><primary>i386-unknown-cygwin32</primary></indexterm>
+         <term>i386-unknown-mingw32:</term>
+         <indexterm><primary>i386-unknown-mingw32</primary></indexterm>
          <listitem>
-           <para>Fully supported under Win9x/NT, including a native
-            code generator. Requires the <Literal>cygwin32</Literal>
-            compatibility library and a healthy collection of GNU
-            tools (i.e., gcc, GNU ld, bash etc.).</para>
+           <para>Fully supported under Win9x, WinNT, Win2k, and
+            WinXP.  Includes a native code generator.  Building from
+            source requires a recent <Literal>cygwin32</Literal>
+            distribution to be installed.</para>
          </listitem>
        </varlistentry>
 
@@ -3306,6 +3311,11 @@ the canned rules being included, and conflicting with yours.
 <indexterm><primary>booting GHC from .hc files</primary></indexterm>
 <indexterm><primary>porting GHC</primary></indexterm></Title>
 
+    <para><emphasis>NOTE: GHC version 5.xx is significantly harder to
+    bootstrap from C than previous versions.  We recommend starting
+    from version 4.08.2 if you need to bootstrap in this
+    way.</emphasis></para>
+
 <para>
 This section is for people trying to get GHC going by using the supplied
 intermediate C (<filename>.hc</filename>) files.  This would probably be