~ chicken-core (chicken-5) 073e60669c6871427451eb42a099094495e3a454

commit 073e60669c6871427451eb42a099094495e3a454
Author:     felix <felix@call-with-current-continuation.org>
AuthorDate: Sun Apr 11 00:11:38 2010 +0200
Commit:     felix <felix@call-with-current-continuation.org>
CommitDate: Sun Apr 11 00:11:38 2010 +0200

    comments

diff --git a/rules.make b/rules.make
index 80e9829c..87c32767 100644
--- a/rules.make
+++ b/rules.make
@@ -1043,6 +1043,8 @@ check: $(CHICKEN_SHARED_EXECUTABLE) $(CSI_SHARED_EXECUTABLE) $(CSC_PROGRAM)
 
 .PHONY: stage1 stage2 stage3
 
+# stage1: build static compiler from current sources with whatever chicken is 
+#         currently available
 stage1:
 	$(MAKE) -f $(SRCDIR)Makefile.$(PLATFORM) STATICBUILD=1 DEBUGBUILD=1 \
 	  CHICKEN=$(CHICKEN) confclean clean $(CHICKEN_PROGRAM)
@@ -1051,6 +1053,8 @@ stage1:
 	-touch *.scm
 	$(MAKE) -f $(SRCDIR)Makefile.$(PLATFORM) stage2
 
+# stage2: build chicken with compiler built from current sources, so that
+#         it supports all functionality that were recently added
 stage2:
 	$(MAKE) -f $(SRCDIR)Makefile.$(PLATFORM) STATICBUILD=1 DEBUGBUILD=1 \
 	  CHICKEN=./$(CHICKEN_PROGRAM)-stage1 clean $(CHICKEN_PROGRAM)
@@ -1059,6 +1063,9 @@ stage2:
 	-touch *.scm
 	$(MAKE) -f $(SRCDIR)Makefile.$(PLATFORM) stage3
 
+# stage3: build chicken with compiler built from compiler built from current 
+#         sources - this should normally not be contaminated by old compilers
+#         or runtime libraries
 stage3:
 	$(MAKE) -f $(SRCDIR)Makefile.$(PLATFORM) CONFIG=$(CONFIG) \
 	  CHICKEN=./$(CHICKEN_PROGRAM)-stage2 confclean clean all