[project @ 2000-08-25 12:49:54 by rrt]
[ghc-hetmet.git] / docs / building.sgml
index eebe7aa..3836d23 100644 (file)
@@ -1230,7 +1230,8 @@ programs.  It also builds the necessary tools for compilation to proceed.
 You should say <Command>gmake boot</Command> right after configuring your build tree,
 but note that this is a one-off, i.e., there's no need to re-do
 <Command>gmake boot</Command> if you should re-configure your build tree at a later
-stage (no harm caused if you do though).
+stage (no harm caused if you do though).  Notably, you should say
+<Command>gmake boot</Command> before you say <Command>gmake clean</Command>.
 </Para>
 </ListItem></VarListEntry>
 <VarListEntry>
@@ -1268,11 +1269,11 @@ reverses the effect of <Literal>install</Literal>.
 <Term><Literal>clean</Literal>:</Term>
 <ListItem>
 <Para>
-Delete all files from the current directory that are normally
-created by building the program.  Don't delete the files that
-record the configuration. Also preserve files that could be made
-by building, but normally aren't because the distribution comes
-with them.</para>
+Delete all files from the current directory that are normally created
+by building the program.  Don't delete the files that record the
+configuration, or files generated by <Command>gmake boot</Command>.
+Also preserve files that could be made by building, but normally
+aren't because the distribution comes with them.</para>
 </ListItem></VarListEntry>
 
 <varlistentry>
@@ -2633,7 +2634,12 @@ Workaround: don't put weird things in string args to <Command>cpp</Command> macr
 
 <Para>
 This section summarises how to get the utilities you need on your
-Win95/98/NT/2000 machine to use CVS and build GHC. Similar notes for installing and running GHC may be found in the user guide. In general, Win95/Win98 behave the same, and WinNT/Win2k behave the same. It is based largely on detailed advice from Sigbj&oslash;rn Finne.
+Win95/98/NT/2000 machine to use CVS and build GHC. Similar notes for
+installing and running GHC may be found in the user guide. In general,
+Win95/Win98 behave the same, and WinNT/Win2k behave the same. It is based
+largely on detailed advice from Sigbj&oslash;rn Finne. You should read the
+GHC installation guide sections on Windows (in the user guide) before
+continuing to read these notes.
 </Para>
 
 
@@ -2966,30 +2972,13 @@ configure: error: ./configure failed for ghc
 <Para>
 You need <Filename>ghc</Filename> to be in your <Constant>PATH</Constant> before you run
 <Command>configure</Command>.  The default GHC InstallShield creates only
-<Filename>ghc-4.05</Filename>, so you may need to duplicate this file as <Filename>ghc</Filename>
+<Filename>ghc-4.08</Filename>, so you may need to duplicate this file as <Filename>ghc</Filename>
 in the same directory, in order that <Command>configure</Command> will see it (or
-just rename <Filename>ghc-4.05</Filename> to <Filename>ghc</Filename>.
+just rename <Filename>ghc-4.08</Filename> to <Filename>ghc</Filename>.
 And make sure that the directory is in your path.
 </Para>
 </ListItem>
 
-<ListItem>
-<Para>
-Compile <Command>happy</Command> and <Command>ghc</Command> 
-with <Option>-static</Option>.  To do this, set
-</Para>
-
-<ProgramListing>
-GhcHcOpts=-static
-HappyHcOpts=-static
-</ProgramListing>
-
-<Para>
-in your <Filename>build.mk</Filename> file.
-[Actually, I successfully compiled Happy without <Option>-static</Option> on Win2k, but not GHC.]
-</Para>
-</ListItem>
-
 </ItemizedList>
 
 </Sect2>