[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