From: simonmar <unknown>
Date: Mon, 11 Mar 2002 11:17:01 +0000 (+0000)
Subject: [project @ 2002-03-11 11:17:01 by simonmar]
X-Git-Tag: Approx_11550_changesets_converted~2289
X-Git-Url: http://git.megacz.com/?a=commitdiff_plain;h=4d46f8cccb6f5f0059729a06e4b2d64074410c6f;p=ghc-hetmet.git

[project @ 2002-03-11 11:17:01 by simonmar]
Add a warning about booting from .hc files on GHC 5.xx, and recommend
using 4.08.2 instead.
---

diff --git a/docs/building/building.sgml b/docs/building/building.sgml
index 3b483b2..73032ef 100644
--- a/docs/building/building.sgml
+++ b/docs/building/building.sgml
@@ -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
@@ -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