rdonkin 2003/01/29 10:32:02
Modified: betwixt RELEASE-NOTES.txt
Log:
Made release notes for last release available in the main CVS
Revision Changes Path
1.2 +29 -7 jakarta-commons/betwixt/RELEASE-NOTES.txt
Index: RELEASE-NOTES.txt
===================================================================
RCS file: /home/cvs/jakarta-commons/betwixt/RELEASE-NOTES.txt,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- RELEASE-NOTES.txt 10 Jun 2002 17:53:32 -0000 1.1
+++ RELEASE-NOTES.txt 29 Jan 2003 18:32:02 -0000 1.2
@@ -1,23 +1,45 @@
$Id$
Commons Betwixt Package
- Version 1.0-dev
+ Version 1.0-Alpha-1
Release Notes
-
INTRODUCTION:
-This document contains the release notes for this version of the Commons
-Betwixt package, and highlights changes since the previous version. The
-current release adds new features and bug fixes, and is being done now to
-follow the release early/release often mentality.
+Betwixt provides a flexible way to map beans into XML - and vice versa. This is the
+first betwixt release.
+There's quite a lot of work to be done before Betwixt is ready for a full
+release - but it's already used by other projects. This alpha will give a
+versioned release for these projects to depend on. A word of warning - though
+the betwixt developers take backwards compatible very seriously, it's likely that
+some parts of the internal API are going to have to change - and some of these
+changes may break compatibility.
NEW FEATURES:
-*
+Everything :)
+
+But here's some features you might like to take a look at:
+
+* Betwixt can write beans to character streams or as SAX events
+* Betwixt builds on Digester (http://jakarta.apache.org/commons/digester.html)
+ to allow xml to be read (using SAX) and mapping into beans in a compatible way
+* Betwixt supports powerful pluggable general strategies but also allows mappings
+ to be customized at the bean level.
BUG FIXES:
+KNOWN LIMITATIONS:
+* This release of betwixt does not validate the element and attribute names
+ specified in .betwixt files to ensure that they will produce well formed xml.
+ Please take care to ensure that the names you choose for you elements and
+ attributes will result in well formed xml.
+* Betwixt is not usable for swing components, unless you write a wrapper class
+ around the Swing component. The XMLEncoder that is used in JDK 1.4.x does a
+ better job in this, by analyzing what is needed based on what clone() does and
+ custom processing for swing components. If you really need this and are writing
+ wrappers around swing components, please contribute it to the betwixt project.
+
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
