[kaffe] CVS kaffe (dalibor):

Wed Aug 13 04:31:02 PDT 2003

PatchSet 3939 
Date: 2003/08/13 12:26:28
Author: dalibor
Branch: HEAD
Tag: (none) 
Log:
Updated FAQs with latest information on building the class library

Members: 
	ChangeLog:1.1541->1.1542 
	FAQ/FAQ.classlibrary-compile:1.13->1.14 
	FAQ/FAQ.embedded:1.1->1.2 

Index: kaffe/ChangeLog
diff -u kaffe/ChangeLog:1.1541 kaffe/ChangeLog:1.1542

--- kaffe/ChangeLog:1.1541	Tue Aug 12 21:30:46 2003
+++ kaffe/ChangeLog	Wed Aug 13 04:26:28 2003
@@ -1,3 +1,13 @@
+2003-08-13  Dalibor Topic <robilad at kaffe.org>
+
+	* FAQ/FAQ.classlibrary-compile:
+	Updated information on make targets, setting the compiler, jikes,
+	javac and gcj.
+
+	* FAQ/FAQ.embedded:
+	Updated information on class library size, and building the class
+	library.
+	
 2003-08-12  Jim Pick  <jim at kaffe.org>
 
 	* Testing new loginfo / cvsps script.
Index: kaffe/FAQ/FAQ.classlibrary-compile
diff -u kaffe/FAQ/FAQ.classlibrary-compile:1.13 kaffe/FAQ/FAQ.classlibrary-compile:1.14
--- kaffe/FAQ/FAQ.classlibrary-compile:1.13	Wed Jul  2 10:57:18 2003
+++ kaffe/FAQ/FAQ.classlibrary-compile	Wed Aug 13 04:26:29 2003
@@ -5,9 +5,9 @@
 Cd to your build directory (the same as the source directory if you
 did ./configure), then cd to libraries/javalib.
 
-Type "make Klasses".
+Type "make".
 
-This will build the java libraries, put them in a Klasses.jar file
+This will build the java libraries, put them in a rt.jar file
 and overwrite the version in your source tree.  Type "make install"
 to install the jar file in your target prefix.
 
@@ -28,11 +28,14 @@
 How do I set the compiler?
 --------------------------
 
-The ./configure script has the --with-jikes option. Not setting it at
-all will use the included kjc Java compiler. Setting it to
---with-jikes=yes will use the jikes compiler if one can be found. You
-can also specify the absolute path to a jikes executable using
---with-jikes=/absolute-path-to/jikes.
+The ./configure script has the --with-jikes option. If you don't set
+it at all, the build system will use the compiler specified by the
+JAVAC environment variable. If no compiler is specified in JAVAC, the
+build system will use the included kjc Java compiler.
+
+Setting --with-jikes=yes will use the jikes compiler if one can
+be found. You can also specify the absolute path to a jikes executable
+using --with-jikes=/absolute-path-to/jikes.
 
 You can also use the absolute path to specify other Java
 compilers. For example, in order to use gcj to compile the class
@@ -65,10 +68,7 @@
   http://www10.software.ibm.com/developerworks/opensource/jikes/
 
 Please note that jikes 1.14 and 1.15 have bugs that result in a
-miscompiled Klasses.jar file. If you use jikes 1.18, you need to pass
-it the "-source 1.1" option. Jikes 1.18 generates class files for JDK
-1.4 by default, and kaffe complains about an unknown version
-number.
+miscompiled Klasses.jar file.
 
 The recommended version of jikes is 1.18.
 
@@ -80,10 +80,9 @@
 
 * javac 
 
-Sun's javac compiler from JDK 1.3 and JDK 1.4 works as well. If you
-are using javac from JDK 1.4, please make sure that you specify the
--target 1.1 option. Failing to do so will result in a lot of annoying
-warning messages when you install and use the Klasses.jar file.
+Sun's javac compiler from JDK 1.3 and JDK 1.4 works as well. You have
+to add "-bootclasspath lib/" to your JAVAC_FLAGS to avoid build
+problems due to Sun's javac linking Sun's class libraries with kaffe's.
 
 No known older version of Sun's javac compiler (up through JDK 1.2)
 will compile Kaffe's classes, due to bugs that Sun has yet to fix.
@@ -91,7 +90,7 @@
 What compilers are known not to work?
 -------------------------------------
 
-FSF's gcj doesn't work up to version 3.2.
+FSF's gcj doesn't work up to version 3.3.
 
 In order to compile the class library with gcj to bytecodes instead of
 native code, you need to pass it the "-C" flag. Unfortunately, gcj has
Index: kaffe/FAQ/FAQ.embedded
diff -u kaffe/FAQ/FAQ.embedded:1.1 kaffe/FAQ/FAQ.embedded:1.2
--- kaffe/FAQ/FAQ.embedded:1.1	Sun Jul  7 12:22:14 2002
+++ kaffe/FAQ/FAQ.embedded	Wed Aug 13 04:26:30 2003
@@ -72,7 +72,7 @@
 ---------------------
 
 You can compile the classes that will be included in the rt.jar archive without debugging.
-Currently (06.06.2002) the rt.jar archive is about 1054K with debugging and 916K without 
+Currently (13.08.2003) the rt.jar archive is about 2425K with debugging and 2117K without 
 debugging info in the classes.
 You can compile the classes without debugging using the compiler from SUN's or IBM's JDK 
 with the -g:none option.
@@ -80,7 +80,8 @@
 export -n JAVA
 export -n JAVAC
 export -n CLASSPATH
-export JAVAC="<PATH_TO_JDK>/bin/javac -g:none"
+export JAVAC="<PATH_TO_JDK>/bin/javac"
+export JAVAC_FLAGS="-g:none -bootclasspath lib/"
 make Klasses
 
 For more details on recompiling Klasses.jar check FAQ/FAQ.classlibrary-compile.


