CVS kaffe (robilad): update mauve FAQ

PatchSet 7635 
Date: 2007/12/31 16:54:17
Author: robilad
Branch: HEAD
Tag: (none) 
Log:
update mauve FAQ

2007-12-31  Dalibor Topic  <[email protected]>

        * FAQ/FAQ.mauve: Updated.

Members: 
	ChangeLog:1.5133->1.5134 
	FAQ/FAQ.mauve:1.2->1.3 

Index: kaffe/ChangeLog
diff -u kaffe/ChangeLog:1.5133 kaffe/ChangeLog:1.5134
--- kaffe/ChangeLog:1.5133	Mon Dec 31 16:44:58 2007
+++ kaffe/ChangeLog	Mon Dec 31 16:54:17 2007
@@ -1,5 +1,9 @@
 2007-12-31  Dalibor Topic  <[email protected]>
 
+	* FAQ/FAQ.mauve: Updated.
+
+2007-12-31  Dalibor Topic  <[email protected]>
+
 	*  developers/mauve-html-gen.pl, developers/mauve-kaffe,
 	developers/mauve-results.sh: Removed.
 	* developers/README: Removed references to deleted files.
Index: kaffe/FAQ/FAQ.mauve
diff -u kaffe/FAQ/FAQ.mauve:1.2 kaffe/FAQ/FAQ.mauve:1.3
--- kaffe/FAQ/FAQ.mauve:1.2	Tue May 27 11:02:41 2003
+++ kaffe/FAQ/FAQ.mauve	Mon Dec 31 16:54:23 2007
@@ -1,6 +1,6 @@
 Running Mauve with Kaffe
 ========================
-Author: Dalibor Topic <[email protected]>
+Author: Dalibor Topic <[email protected]>
 
 Introduction
 ============
@@ -18,15 +18,7 @@
 
 Q: How well does Mauve run on Kaffe?
 
-A: The tests for Java 1.0 and Java 1.1 APIs build and run on
-kaffe. The tests for other API versions don't build due to missing
-methods and classes in kaffe's class library. Nevertheless, you can
-test specific classes and packages by using KEYS="\!java. x.y.z"
-to test a specific package or class x.y.z.
-
-In your runs, you should exclude the Unicode tests, since they result
-in a ton of errors, most of which are bogus. You should run mauve with
-"\!java.lang.Character.unicode" in your KEYS string.
+A: As of 2008, around 200 of more than 3000 tests fail.
 
 Installation
 ============
@@ -39,30 +31,16 @@
 
 4. autoreconf (you need latest auto* tools for this step)
 
-5. ./configure JAVA=/path/to/kaffe JAVAC=/path/to/kjc
+5. ./configure
 
 Running
 ========
 
-In order to test kaffe's compatibiity with some Java API release:
+A quick way to run the whole test suite is to call
 
-make check KEYS="JDK 1.release \!java.lang.Character.unicode" > kaffe.log
-
-Mauve has an option to group the KEYS you are using. When you create a
-file "mauve-kaffe" with your normal KEYS settings then you can then do
-"make check KEYS=kaffe". Kaffe comes with a "mauve-kaffe" file in the
-developers directory. Don't forget to do a "rm .save-keys choices"
-after editing the "mauve-kaffe" file before rerunning "make check
-KEYS=kaffe" to make sure the changes get picked up.
-
-If you want extra verbose output, use make check KEYS=something
-TESTFLAGS="-verbose". You can pick single tests to run, by using make
-check KEYS="JDK1.release \!java. \!javax. package.class.test"
-
-Finally, you can pipe the output of the verbose runs into a perl
-script that generates nice web pages. The script mauve-html-gen.pl can
-be found in the developers directory.
+$ kaffe Harness gnu.testlet -vm /path/to/kaffe
 
+Take a look at the mauve documentation for more details. 
 
 Helping Out
 ===========
@@ -72,10 +50,9 @@
 Running Mauve Regularly
 -----------------------
 
-Despite everyone's efforts to improve kaffe, sometimes fixes break
-other things on other platforms. In order to be able to find out early
-when things break, we need contributors that run mauve regularly on
-their platforms, publish the results, and report regressions.
+There is a regular run of Mauve nightly on the 
+developer.classpath.org virtual instance. Adding Kaffe to the set
+of VMs already using the setup would be very useful.
 
 Fixing Issues You Find
 ----------------------
@@ -93,12 +70,3 @@
 to the mauve mailing list. That way, other free Java virtual machine
 and class library implementations can use the test case to check their
 own work.
-
-Known Issues
-============
-
-The Unicode tests result in a ton of failures. According to
-developers/README.unicode, it's the Unicode tests that need fixing.
-
-Some tests can not be built since kaffe doesn't implement the APIs
-yet. They have been commented out in the "mauve-kaffe" file.