This is kissme, a free Java Virtual Machine
-------------------------------------------

Building
--------

Read doc/BUILDING

Running
-------

To run, simply invoke the binary and give it a path to the class library files:

./kissme  -bootclasspath /usr/share/kissme/classpath:/usr/share/java/antlrall.jar antlr.Tool 

You can create a kissmerc file to store the location of the system classes:

skami> cat /etc/kissme/kissmerc
classpath=/usr/share/kissme/classpath

You can also put it in the current directory, or in ~/.kissme/

If you have a working kissmerc file, use kissme like this:

./kissme  -cp /usr/share/java/antlrall.jar antlr.Tool 

Release:
--------

You can get release files at: 

http://kissme.sourceforge.net/ and
http://sourceforge.net/project/showfiles.php?group_id=784

Latest release is 0.17
0.16
0.15
0.14
See 0.13

0.13

Update for release 0.13: The files are very similar to 0.11, just the version has changed. 

Release notes:

- Now supports the use of .jar and .zip files for user classes (not system classes)
- Added -bootclasspath option

0.11

http://prdownloads.sourceforge.net/kissme/kissme-binary-0.11.tar.gz
http://prdownloads.sourceforge.net/kissme/kissme-0.11.tar.gz

http://prdownloads.sourceforge.net/kissme/kissme-classpath-binary-0.11.tar.gz
http://prdownloads.sourceforge.net/kissme/kissme-classpath-build-files.tar.gz

Class libraries
---------------

At this point kissme will *only* work with Classpath java libraries. Using a classes.zip from Sun's JDK or IBM's JDK will crash it. 

Use the kissme-classpath-binaries-0.11.tar.gz file from the sourceforge project page. Release notes for that file:

These are the classpath .class files from CVS (around May 1).

Also included are the kissme-specific .class files (java/lang/Throwable etc).

The source for these is in the kissme CVS tree, and in the release file.

The source for the classpath code can be obtained by checkout their CVS tree. (use makeme to build these)

Documentation
-------------

doc/BUGS describes the bugs I know about 
doc/BUILDING describes my build system and make tool
doc/BUILDING_OSKIT describes how to build an OSKIT multiboot image from kissme
doc/BUILDING_CLASSES_ZIP describes how to build a classes.zip file containing only the classes needed to run a certain program

useful_scripts/run_kjc      just has the commands to run the kjc java compiler (works intermittently)
mauveMakefile		    runs the mauve tests with kissme. The paths are hard-coded for my machine

Build Options
-------------

You can configure different parts of the build with some defines in the config.h file.

This should be done with care though.

Reporting bugs
--------------

Please report bugs to me by sending me the java source code and .class files of the program you tried to run. Also include a description of what happened. If possible run gdb on the core file and get a backtrace by typing 'bt'. 

John Leuner
jewel@pixie.co.za

Updated: August 3 2001







