[m-dev.] for review: document bootstrapping tag procedure

Tyson Dowd trd at cs.mu.OZ.AU
Mon Jul 19 11:59:33 AEST 1999


Hi,

Fergus -- since I had to look up the mail archive to find this
message I thought I'd document it somewhere easy to find and 
add a suggested format for the tag.

===================================================================


Estimated hours taken: 0.5

compiler/notes/bootstrapping.html:
	Document the procedure for setting tags with changes that
	stop bootstrapping with previous version of the compiler.


Index: bootstrapping.html
===================================================================
RCS file: bootstrapping.html
diff -N bootstrapping.html
--- /dev/null	Thu Mar  4 04:20:11 1999
+++ bootstrapping.html	Mon Jul 19 11:54:55 1999
@@ -0,0 +1,45 @@
+
+<html>
+<head>
+<title>
+	Bootstrapping
+</title>
+</head>
+
+<body
+	bgcolor="#ffffff"
+	text="#000000"
+>
+
+
+<hr>
+
+<h2> Changes that don't bootstrap </h2>
+
+<p>
+
+Sometimes changes need to be made to the Mercury system that mean
+previous versions of the compiler will no longer successfully compile.
+<p>
+
+Whenever anyone makes a change which prevents bootstrapping with a
+previous version of the compiler, they should add a cvs tag to all the
+files in the relevant directories before *commiting*, and mention this tag
+in the log message.  The tag should be of the form
+bootstrap_YYYYMMDD_<short_description_of_change>.
+<p>
+
+The rationale for the cvs tag is that it allows machines to be
+bootstrapped (if they didn't manage to do it in an overnight build)
+by doing `cvs update -r<tag>' on the relevant build directory.
+After that compiler has been installed, a `cvs update -A' will remove
+the cvs sticky tags.
+<p>
+
+Optionally, a test should be added to the configuration script so
+that people installing from CVS don't use an outdated compiler to
+bootstrap.  Practically this may be difficult to achieve in some cases.
+
+<hr>
+
+Last update was $Date: 1997/12/05 02:05:50 $ by $Author: trd $@cs.mu.oz.au. <br>
+</body>
+</html>


-- 
       Tyson Dowd           # 
                            #  Surreal humour isn't eveyone's cup of fur.
     trd at cs.mu.oz.au        # 
http://www.cs.mu.oz.au/~trd #
--------------------------------------------------------------------------
mercury-developers mailing list
Post messages to:       mercury-developers at cs.mu.oz.au
Administrative Queries: owner-mercury-developers at cs.mu.oz.au
Subscriptions:          mercury-developers-request at cs.mu.oz.au
--------------------------------------------------------------------------



More information about the developers mailing list