@node    Install,    Tools,  FAQ, Top
@chapter Install

Here lies some documentation about Japhar documentation. It is a supplement to the INSTALL file in the
top-level directory of the distribution.

@section Failure modes

Here are some common failure modes and their causes. If you were stumped by something that isn't in here, send it to me, please,
so no one else has to be.

@subsection Trouble with aclocal

@subsubsection Macro `AM_DISABLE_STATIC' not found in library

@example
bash-2.01$ aclocal                                
aclocal: configure.in: 16: macro `AM_DISABLE_STATIC' not found in library
@end example

You need to have libtool-1.2 installed.

@subsection Trouble with class library

@subsubsection NullPointerException
@example
java/lang/NullPointerException 
(objectref == null in call to virtual method 
'get Property' from java/lang/System.getProperty())
         in java/lang/System.getProperty(pc = 20)
         in sun/tools/javac/Main.main(pc = 9)
@end example 
This is the error you get when you use a pre-1.1.5 classes.zip file. Snag a 1.1.5 classes.zip file and try again.

@subsubsection Archive has a truncated file name

This is a problem with Solaris tar.  It seem to be incompatible with
GNU tar on long filenames. (Win95 GNU tar has also been reported to have problems.)

@subsubsection There is no classes.zip in ./japhar-0.04/classes 

You will need to fetch it from a preinstalled JDK.  You must give
--with-sun-jdk=<path> to configure.

@subsection General ailments

@subsubsection This release does not seem ready for public consumption.

Japhar is currently in development, and, yes, is not ready for prime-time. More
like late-night on Tuesday.

@subsubsection This thing sucks!

Yes, japhar sucks. We suck too. Even the documentation says so. :-b

