README 	   : jHomeNet UI library
Released   : March 15, 2007
Version    : 0.2
Written by : Dave Irwin (jhomenet at gmail dot com)

_________________________________________________________________________________
OVERVIEW

The jHomeNet UI library is a library that provides most of the UI functionality for
the jHomeNet suite of tools including the jHomeNet server.

This release is considered an alpha release of the software and as such is still
under a considerable amount of development. Expect major changes in the API between
this and future releases of the jHomenet server. Not all features are implemented
in this release. This release also does not contain all the necessary documentation.
This release was published in order to provide a preview to users of features in
development.

The distribution includes the following folder and files:

      o conf		contains configuration files
      o docs		contains documentation including the API
      o images		contains any necessary images
      o lib		contains all the necessary library files
      o logs		contains any log files produced by the jHomenet server
      o plugins		contains any jHomenet server plugins
      o resources	contains any other resource files
      o src		source tree

In addition, the current distribution also includes an Apache Ant build
file (build.xml) for building the application from the source and a
Windows batch files for running the application.

_________________________________________________________________________________
GENERAL INFORMATION

Refer to the jHomenet Sourceforge project website (http://jhomenet.sourceforge.net/)
for general information about the jHomenet suite of applications.

To post a comment or a request for help, visit the following website: 
https://sourceforge.net/forum/?group_id=140953

To report a bug, use the bug submit form found on the Sourceforge website at the 
following address: https://sourceforge.net/tracker/?func=add&group_id=140953&atid=747884.

_________________________________________________________________________________
RUNTIME ENVIRONMENT

Several sections of the software has been developed using Sun's JDK 1.5
software development kit features. As such, it's required that Sun's latest
1.5 compatible JRE be installed to run the applications, and Sun's lastest
1.5 compatible SDK be installed to for development.

Development of the current version of the jHomenet server has used JDK 1.6.

In order to make use of the included build files, a copy of Apache Ant should be
installed and properly configured. A copy of Ant can be freely downloaded from
the following site: http://ant.apache.org/.

Eclipse 3.1 was used for development along with Ant version 1.6.1.

_________________________________________________________________________________
SOURCE COMPILING

The project comes with an Apache Ant build.xml file for use in compiling the
source. To build the Java sources, at the command line type:

	jhomenet-ui-[versionid]> ant 

This builds the sources and places the compiled class files in the build\classes
folder. The process also copies the necessary configuration, library, and image
files to the correct folder within the build\classes root directory. The current
distribution does not include pre-compiled binary class files.