============================================================================
BuzzTrollMud
============================================================================

This java program is intended to be used as a MudClient.  It sends telnet
strings in the exact format they are entered by the user.  The strings 
received by the server are given a color based on there content and displayed
as is to the screen.

BuzzTrollMud has only been tested with java version "1.4.0"
Other version of java may work but have never been tried.

Use this all you want, just don't make money off of it and give credit where
it is due.  Ummm and consider it GPL.

-----------------------------------------------------------------------------
To Build
-----------------------------------------------------------------------------

Prepare environment:
    Point to local installation of java 1.4.0
    % setenv variable JAVA_HOME 

    make sure the correct version of java is first in your PATH
    % setenv PATH ${JAVA_HOME}/bin:${PATH}

    force your envornment to uspdate its variables
    % rehash

    create the configure directory
    % mkdir ~/.btmudrc

Edit Makefile:

    set variable PREFIX_DIR to the directory you want the mud client installed
    and make sure that directory exists

    % make
    % make install

-----------------------------------------------------------------------------
To Run
-----------------------------------------------------------------------------
from mud directroy

java -classpath ./lib/wsdl4j.jar:./bin/BuzzTrollMud.jar:./lib/JFontChooser.jar org.buzztroll.mud.MudFrame

or use the script: ./bin/run.sh

-----------------------------------------------------------------------------
Configuration
-----------------------------------------------------------------------------
Configuration information will be stored in the directory $HOME/.btmudrc

There is a smaple configuration file included with this distribution
located at ./MCS.xml.  You need not understand this file to use BuzzTrollMud.
The application has a configuration GUI to help create these for you.

-----------------------------------------------------------------------------
Using it
-----------------------------------------------------------------------------
Follow the instruction in build and run.

The first time you start there will be no connections.  To add a connection
click on File->Add.  This will bring up a configuration window.  You must 
fill in all information on the "Host" tab, the rest are optional and can be 
configured later.  Once you are finished filling in information click "Save".
A Connection should now start.

Several connections can be added to a single instance of BuzzTrollMud.  To add
more simple go through the process described above.  As coonections are added
new tabs will be added.  There will be at most 2 connections per tab.

To reconfigure a connection simply right click on the connection window you
wish to reconfigure.  From the menu that pops up select "Configure".

There currently is no way to remove a connection built into the app.  To do 
this goto the directroy ~/.btmudrc.  In that directory you will find a 
xml file for every connection you added.  To remove a conneciton simply delete
the appropriate file.


------
ISSUES
------
adding jabber support
   add interceptor
      catch send messages before they go out on the wire
menus
focus problem
    when click on output window it takes the focus, 
    focus should always goto input window
remove a connection
saving state of GUI
    size of window
    fonts on each connection
    ordering of conections
    default font

saving password
    the password is not properly written to th config file.  For now
    users must open the ~/.btmudrc/ files and add the passwords manually.