D-Bus Java README
-----------------

Compilation and installation is described in the INSTALL file.

This will install two jar files, three binaries and some documentation in the
form of an HTML/PDF guide to writing D-Bus Java programs, JavaDoc API for the
library and man pages for the supplied programs. Read the documentation, it's
there for a reason.

The installed programs are documented in their respective man pages.

CreateInterface is a tool for creating interface stubs for D-Bus programs.  It
will connect to services running on the bus and introspect on them to find
their API. This will then be written as Java interface definitions suitable for
importing into your program. A file containing the introspection data can be
used instead.

ListDBus lists the names currently connected to a bus.

DBusViewer is a graphical tool which combines the two tools. It will list the
names on a bus and allow you to introspect on them and save the result as Java
interface files. This currently only introspects on the root object, however.

To run a Java program using D-Bus you need to have the libdbus-java,
libunix-java and libdebug jar files in your classpath and the libunix-java
shared library in your library path. With the default install paths you may
have to do something like:

java -cp /usr/local/share/java/dbus.jar:/usr/local/share/java/unix.jar:/usr/local/share/java/debug-disable.jar -Djava.library.path=/usr/local/lib/jni