Jolene version 0.9
Copyright (c) 2008 Dan Howard
All rights reserved.

Introduction
============

Thank you for using Jolene.

License
=======

Jolene uses 2 licenses. The core of Jolene is licensed under the LGPL verion 2.1 and the jolene plugins use a BSD
style license.  The reason for the BSD license for the plugins is to allow developers to freely create alternate
implementations for commercial or non-commercial purposes based on the plugin code already provided with the
distribution.  Currently the distribution contains a plugin for Struts 1.2/1.3 which uses DispatchAction. If
developers want to use another mechanism to make Jolene work with Struts they may need to make use of the code
provided in the jolene-plugin-struts-0.9.jar.

Distribution
============

The package you downloaded should be jolene-full-0.9.zip this file contains the following files:
jolene-build-src-0.9.zip     Buildable source code for Jolene including build scripts and project files.
jolene-core-0.9.jar          Jolene core library.
jolene-doc-0.9.jar           Jolene javadocs.
jolene-plugin-struts-0.9.jar Default Struts plugin implementation for Struts 1.2/1.3.
jolene-src-0.9.jar           Jolene sources.
kbsample.war                 Sample application.
kbsample-src.zip             Sampple application source.

Status
======

Late beta. Jolene has been in development for several years. The main work done on it over the last year has been
mostly to prepare it for release as open source.

To Do
=====

* Develop mechanism to ease internationalization.
* Implement default attriutes for objects based on a properties file. Maybe.
* Finish work to ensure XHTML works properly.
* Add support for optiongroup.
* Add objects to Document even if they live outside the form.
* Support LINKS as objects? Maybe.

Known issues
============

* The parser does not find any forms if there is no </body>.
* The HTML must have body /body tags and *should* have head tags.
* Elements which are surrounded by comments are added to the document object.

Building
========
Use the supplied ANT build.xml file. You will need to modify build.properties to suit your environment.

Contacts
========
You can always contact me at: sproket AT videotron.ca

Unit Tests
==========
Currently using 58 unit tests. See http://jolene.sourceforge.net/coverage/index.html for code coverage.