jJRU 0.1
========

jJRU is Free Software. See gpl.txt.

Contact me at mailto:schierlm@gmx.de or jabber:schierlm@a-message.de

Using jJRU:
-----------

jJRU needs Java 1.4 or higher.

Start it by double clicking jjru.jar or running

javaw or java -jar jjru.jar

You will see lots of debugging output on the console in the latter
case.

When started you will see a window where you can enter your account
data. All previous accounts used are listed in a drop down box so that
you can simply reuse them. If you select a profile there and change
data, the data of this profile is changed. If you select
"<newprofile>", all new profile is created. In the current stage of
development, there is no way to remove a profile except editing
the config file (~/.jruu) by hand.

When your account data is correct, click "Next >>". jJRU connects
to your jabber server and downloads the roster, which is shown next.
(If an error occurs, click "<< Back" to go back to the last step.)

You can now modify the roster (either by hand, or by using the Search
and/or Replace features).

"Load..." loads the roster from a text file

"Save..." saves it into a text file

"Normalize entries" parses the roster and converts it back to text, so
that all entries look "normalized".

"Import" does not do anything yet.

When you are finished with you changes, click "Next >>" again. If
there is any parse error, jJRU will show it in the roster with an
"<-------" arrow. Otherwise you will see a "diff" of all changes.

The characters in the first column indicate:

+ this JID has to be subscribed.
- this JID has to be unsubscribed
! this JID has to be updated (group list, real name)
? That was the value before updating.

You can place the cursor in a line and "Remove" it. You can as well
remove all additions, deletions or updates.

Now click "Next >>" again. Your changes will be performed then. A last
click onto "Next >>" brings you back to the first screen.

Enjoy!


Building:
---------

In a binary distribution, you find all the source in src.zip. Extract it
to the directory where it is in (so that it can find jabberbeans.jar).

Provided that you have Apache Ant installed, just run

ant dist

to build a binary distribution from the sources.

jjru needs Jabberbeans 0.9.1 (or higher) which is shipped with the
binary distribution. If jabberbeans.jar is not present in the project
directory, ant will download the full package and extract that file.

CAUTION: the full package is 5.5 megabytes and there is no smaller
         download available.

Changelog:
----------

+++ 2003-09-10 Version 0.1 released +++