For review: Change INSTALL_CVS to use/mention stage 2 directory

Warwick Harvey wharvey at cs.monash.edu.au
Tue Jul 14 18:20:27 AEST 1998


Can Fergus or someone please review this?


Estimated hours taken: 1

Some changes to the compiler require that a user trying to build and install 
a new version of the compiler from Mercury sources do the `mmake install' 
step from the stage 2 directory.  This was not mentioned in the INSTALL_CVS; 
this change fixes that omission.

INSTALL_CVS:
	Now runs a bootcheck by default and performs the `mmake install'
	from the stage 2 directory.  Updated the instructions to tell the
	user how to install without the bootcheck, and the implications of
	doing this.

Index: INSTALL_CVS
===================================================================
RCS file: /home/mercury1/repository/mercury/INSTALL_CVS,v
retrieving revision 1.5
diff -u -r1.5 INSTALL_CVS
--- INSTALL_CVS	1996/07/24 16:35:01	1.5
+++ INSTALL_CVS	1998/07/14 08:02:46
@@ -16,10 +16,24 @@
 #
 # Step 3.  mmake
 #
-# Step 4.  mmake install
+# Step 4.  tools/bootcheck
+#
+# Step 5.  cd stage2 && mmake install
 #
 #	   If you just want to do a `make' rather than a `make install',
 #	   then comment out the `mmake install' line below.
+#
+#	   If you want to install without doing a boot check, then comment
+#	   out the `tools/bootcheck && cd stage2' line below.  If the
+#	   version of the compiler you checked out is buggy and you don't
+#	   perform a boot check first, you risk installing a version of the
+#	   compiler incapable of compiling itself.  Make sure you have a
+#	   fall-back plan if you do this.
+#	   Note also that occasionally changes made to the compiler mean
+#	   that installing from a stage 1 build will fail, even when the
+#	   compiler is fine.  In such cases the only way to install the
+#	   compiler is from the stage 2 directory.
+#
 #	   If you don't want to do a parallel make, comment out the
 #	   `parallel=-j3' line below.
 
@@ -30,5 +44,6 @@
 touch Mmake.params &&
 mmake depend $parallel &&
 mmake MMAKEFLAGS=$parallel &&
+tools/bootcheck $parallel && cd stage2 &&
 mmake install MMAKEFLAGS=$parallel &&
 true





More information about the developers mailing list