\input texinfo   @c -*-texinfo-*-
@c %**start of header
@setfilename japhar.info
@settitle Japhar documentation
@c %**end of header

@setchapternewpage odd

@dircategory Java Tools
@direntry
* japhar::                           Japhar Java Virtual Machine
@end direntry

@ifinfo
This is the info documentation for Japhar.

@c ?? Copyright 1998 Hungry Programmers, Inc.
@end ifinfo

@titlepage
@sp 10
@center @titlefont{Japhar}

@page
@vskip 0pt plus 1filll
@c ?? Copyright @copyright{} 1998 Hungry Programmers, Inc.
@end titlepage

@node    Top,  About Japhar,    , (dir)
@comment node-name, next,previous, up

@menu
* About Japhar::        Overview of the Japhar VM.
* FAQ::                 Frequently Asked Questions about Japhar.
* Install::             Installing Japhar.
* Tools::               The Japhar command set.
* Index::               The index, or course.
@end menu

@node    About Japhar, FAQ, Top, Top
@chapter About Japhar

@section What is it?
Japhar is the Hungry Programer's Java VM. It has been built from the ground up without consulting Sun's sources. 

@section Why another Java VM?
Japhar is different because it was designed from the beginning to conform to the JNI Spec published by Sun. So, it's
easy to actually embed Japhar in your own programs (you can even create more than one Japhar VM in the same
process.) 

Performance is important to us, but it is secondary to our primary goal, which is to very quickly follow specifications
as they are published. We have, for example, begun work on following the Java VM Debugger Interface (JVMDI).
The goal is to hook up GDB to this interface to provide a consistent debugging environment. 

That being said, there are plans to work on a JIT for japhar. Please contact japhar@@hungry.com for more info, or if
you'd like to help out (or write the entire thing :) 

Also, japhar uses thread libraries that are native to the machine. Both pthreads and cthreads are supported. 

Downloads of the distribution are available at: ftp://ftp.hungry.com/pub/hungry/japhar. 

@section Mailing List : Want to Help?
We've set up a mailing list for discussion about japhar. The address is japhar@@hungry.com.
To subscribe, send a message with subscribe in the Subject: line to japhar-request@@hungry.com. 

@section Regression Testing
We have made a DejaGNU testsuite for Java which we use to assure that no new bugs sneak into the distribution. We
recommend that you run the tests and check for new bugs before you send patches. You will need the DejaGNU
distribution to get 'runtest'. It can be found at ftp://ftp.cygnus.com/pub/dejagnu. 
To actually run the tests, cd to the 'testsuite' directory and do 'make check'. 

@include faq.texi
@include install.texi
@include tools.texi

@node   Index,  ,       Tools,  Top
@unnumbered Index
@printindex cp

@contents
@bye

