
To use all functionality provided by Kaffe, you need some freely available
libraries installed on your system.

Some of these libraries are absolutely required, in other cases, the
configure script detects whether the library is available and uses it
if so.  If your library is not installed in a standard place where
your compiler and linker finds it, you need to tell configure where to
find it, using the --with-libraries="/my/dir1/lib /my/dir2/lib ..." 
flag.  You may also have to specify the location of C header files,
--with-includes="/my/dir1/include /my/dir2/include ...".

Some operating system vendors, mostly Linux distributors, split their
packages of libraries into 'runtime' and 'development' versions. You
may have to install both on your system in order to successfully
compile kaffe to use the libraries. If you are looking for precompiled
versions of these libraries for your Linux distribution, and your
distributor uses the RPM packaging format, you should check out
http://www.rpmfind.net.

ZIP library
-----------

You'll need the zlib library for Kaffe to be able to use class libraries
stored in JAR archives. It is available at:
http://www.zlib.net

JAR tool
--------

You'll need a tool to create JAR achives of class libraries. Such a tool
is available in many distributions and the ports system as 'fastjar', or
alternatively at:
http://savannah.nongnu.org/projects/fastjar/


AWT backends
------------

Kaffe offers the choice between two AWT backends.

X11/XFree:
    If you are going to use the standard AWt backend, you need the X
    Window System. It is the most common graphical environment on Unix
    systems. It is available at:
    http://www.x.org/ 

    A very popular implementation is XFree86, available at :
    http://www.xfree86.org

Qt:
    If you are going to use the Qt tookit based AWT backend you can
    get the toolkit from:
    http://www.trolltech.com 

    More information on supported versions of the Qt toolkit is
    available in FAQ.awt.

Other AWT backends:
    PocketLinux kaffe comes with more AWT backends. You can get it
    from kaffe's CVS tree. It is no longer supported, though, as the
    company behind it, Transvirtual, has gone out of business.

    We would welcome contributions to merge these AWT backends with
    kaffe's own CVS tree. Please join the kaffe mailing list
    kaffe@kaffe.org, and read FAQ.awt if you have questions or want to
    help out.

Image libraries
---------------

You need the libraries if you want Kaffe to be able to decompress
images stored in GIF, JPEG or PNG formats.

libungif: 
    You need libungif 4.0 or newer if you want Kaffe's awt to be able
    to decompress gif images.  Note that earlier versions will not work.
    You can get libungif from:
    http://prtr-13.ucsc.edu/~badger/software/libungif/index.shtml

jpeg:
    Used by Kaffe's awt to decompress jpeg images.  Available at:
    http://www.ijg.org/

libpng:
    Ditto for png images.  Available at
    http://www.libpng.org/pub/png/libpng.html

Sound libraries
---------------

You need at least one of these libraries if you want to use kaffe's
Java Sound implementation, which has been merged in from the tritonus
project. More information on sound support in kaffe is available in
FAQ.sound.

ALSA:
	The Advanced Linux Sound Architecture backend provides both
	sampled sound and MIDI functionality. You need to have ALSA
	installed first, which is available at:
	http://www.alsa-project.org/

Esd:
	The Enlightened Sound Daemon provides sound playback
	functionality on many Unix implementations. It is available
	at:
	http://www.tux.org/~ricdude/EsounD.html

Mathematical libraries
----------------------

If you want to use arbitrary precision numbers provided by the
java.math package, you can install these libraries. If kaffe can not
find them, it will automatically use a pure java implementation from
GNU Classpath.

GNU MP:
    libgmp is used in the native implementation of
    java.math.BigInteger. It is available at:
    http://www.swox.com/gmp/

Cryptographical libraries
-------------------------

If you want to use cryptographical hashing algorithms, you need to
install these libraries.

libmd:
    This library is included with FreeBSD and may be included with
    other operating systems. It supplies implementations of the MD2,
    MD4, and MD5 hashing algorithms. If this library is not found by
    configure, then SHA is the only hashing algorithm that will be
    available. It can be found at:
    http://www.penguin.cz/~mhi/libmd/

Internationalization libraries
------------------------------

If you want to use native character set encoders and decoders, you
need to install these libraries.

libiconv:
    This library provides an iconv() implementation for converting
    text between native character set encodings and Unicode. It is
    available at:
    http://www.gnu.org/software/libiconv/

Other tools
-----------

If you want to debug kaffe, you need to have mktemp installed, in
order to allow creation of safe temporary files.

mktemp:
    A utility to create safe temporary files. Available at
    http://www.mktemp.org .
