rdonkin 2003/01/25 12:15:21
Modified: betwixt Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH
RELEASE-NOTES.txt project.xml
betwixt/xdocs Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH
navigation.xml overview.xml
Added: betwixt/src/resource Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH
dotbetwixt.dtd
betwixt/xdocs Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH
tasks.xml
Removed: betwixt/xdocs Tag: BETWIXT_1_0_ALPHA_1_RELEASE_BRANCH
todo.xml
Log:
Added DTD from main branch. Also renamed todo.xml to tasks.xml (so that it's
compatible with maven). Also updated release notes.
Revision Changes Path
No revision
No revision
1.1.2.6 +21 -12 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.2.5
retrieving revision 1.1.2.6
diff -u -r1.1.2.5 -r1.1.2.6
--- RELEASE-NOTES.txt 19 Jan 2003 17:44:53 -0000 1.1.2.5
+++ RELEASE-NOTES.txt 25 Jan 2003 20:15:20 -0000 1.1.2.6
@@ -4,12 +4,17 @@
Version 1.0-Alpha-1
Release Notes
-
INTRODUCTION:
-This is the first release for betwixt. Betwixt provides a flexible way to map beans
into XML - and vice versa.
+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 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. Obviously,
these changes will be kept to a minimum.
+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:
@@ -18,19 +23,23 @@
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.
+* 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.
+* 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.
-
1.21.2.2 +5 -4 jakarta-commons/betwixt/project.xml
Index: project.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/betwixt/project.xml,v
retrieving revision 1.21.2.1
retrieving revision 1.21.2.2
diff -u -r1.21.2.1 -r1.21.2.2
--- project.xml 19 Jan 2003 14:43:34 -0000 1.21.2.1
+++ project.xml 25 Jan 2003 20:15:20 -0000 1.21.2.2
@@ -4,17 +4,18 @@
<extend>../project.xml</extend>
<name>Betwixt</name>
<id>commons-betwixt</id>
- <currentVersion>1.0-alpha-1</currentVersion>
+ <currentVersion>1.0-alpha-1RC1</currentVersion>
<inceptionYear>2002</inceptionYear>
<shortDescription>Commons Betwixt</shortDescription>
<description>Commons Betwixt: mapping beans to XML</description>
<url>http://jakarta.apache.org/commons/betwixt/</url>
+ <logo/>
<versions>
<version>
- <id>1.0-alpha-1</id>
- <name>1.0-alpha-1</name>
- <tag>1.0-alpha-1</tag>
+ <id>1.0-alpha-1RC1</id>
+ <name>1.0-alpha-1RC1</name>
+ <tag>1.0-alpha-1RC1</tag>
</version>
</versions>
No revision
No revision
1.1.2.1 +36 -0 jakarta-commons/betwixt/src/resource/Attic/dotbetwixt.dtd
No revision
No revision
1.3.2.1 +1 -1 jakarta-commons/betwixt/xdocs/navigation.xml
Index: navigation.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/navigation.xml,v
retrieving revision 1.3
retrieving revision 1.3.2.1
diff -u -r1.3 -r1.3.2.1
--- navigation.xml 2 Jan 2003 11:44:32 -0000 1.3
+++ navigation.xml 25 Jan 2003 20:15:21 -0000 1.3.2.1
@@ -10,7 +10,7 @@
<item name="FAQ" href="/faq.html"/>
<item name="Detail" href="/overview.html"/>
<item name="Community" href="/community.html"/>
- <item name="To Do List" href="/todo.html"/>
+ <item name="To Do List" href="/tasks.html"/>
<item name="Powered By" href="/powered.html"/>
</menu>
</body>
1.11.2.1 +1 -1 jakarta-commons/betwixt/xdocs/overview.xml
Index: overview.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/overview.xml,v
retrieving revision 1.11
retrieving revision 1.11.2.1
diff -u -r1.11 -r1.11.2.1
--- overview.xml 5 Jan 2003 16:27:16 -0000 1.11
+++ overview.xml 25 Jan 2003 20:15:21 -0000 1.11.2.1
@@ -100,6 +100,7 @@
<source><![CDATA[<?xml version='1.0' encoding='UTF-8' ?>
<info primitiveTypes='attribute'>
+<hide property='something'/>
<element name='channel'/>
<element name='customerList'>
<element name='customer' property='customers'/>
@@ -107,7 +108,6 @@
<element name='foo'>
<attribute name='qqq' property='ppp'/>
<element name='bar' property='xyz'/>
- <hide property='something'/>
<addDefaults/>
</element>
</info>
No revision
No revision
1.3.2.1 +41 -23 jakarta-commons/betwixt/xdocs/tasks.xml
Index: tasks.xml
===================================================================
RCS file: /home/cvs/jakarta-commons/betwixt/xdocs/tasks.xml,v
retrieving revision 1.3
retrieving revision 1.3.2.1
diff -u -r1.3 -r1.3.2.1
--- tasks.xml 19 Jan 2003 23:25:53 -0000 1.3
+++ tasks.xml 25 Jan 2003 20:15:21 -0000 1.3.2.1
@@ -171,40 +171,58 @@
</li>
</ul>
</subsection>
-</section>
-<section name='Completed'>
- <subsection name='Since 1.0-Alpha Release'>
+
+ <subsection name='Completed (Since Last Release)'>
<ul>
<li>
- <strong>Created DTD for .betwixt files.</strong>
+ Using \n as default and now shows a warning when an invalid
space character is used.<br/>
+ Adding a check to only accept valid characters as lineEndings,
so parsers actually
+ won't choke on the output xml.
+ BeanWriter should have a setEndOfLine() method to allow configurable
EOL strings, defaulting to "\n"
</li>
<li>
- <strong>Added validity check for element and attribute names in
.betwixt files</strong>
- .betwixt files contain names for xml elements and attributes. Only
certain names
- for elements and attributes are allowed by the xml specification.
Betwixt now
- check to ensure that the names are appropraite and terminates
processing with an
- Exception if they are not.
+ Create a SAXWriter class in the io package that takes a bean and
writes to a SAX ContentHandler
+ rather that outputting textual XML like BeanWriter does.
+ This will allow Betwixt to work nicely in XML pipelining
environments like Cocoon and Jelly.
+ </li>
+ <li> digester.peek() was giving warning. Now checking if it still has
something to peek.
+ Currently betwixt causes digester to output a warning '[WARN]
Digester - -Empty stack (returning null)'.
+ We should patch the way betwixt uses digester to avoid this warning
message.
</li>
<li>
- <strong>Created XMLUtils</strong>
- Separated out basic xml utilty methods into a static utility class
called XMLUtils.
- This should allow them to be reused in isolation.
+ <strong>Add description of digester-related limitation to
FAQ</strong>
</li>
- </ul>
- </subsection>
-</section>
-<section name='Deprecated'>
- <subsection name='Since 1.0-Alpha Release'>
- <ul>
- <li>
- <code>BeanWriter.escapeAttributeValue()</code> moved into XMLUtils
+ <li>
+ <strong>Upgrade To Latest Dependencies</strong>
+ Check that betwixt works with the latest versions of the dependent
+ Replace all references to deprecated methods.
+ </li>
+ <li>
+ <strong>Add read and write examples</strong>
+ Add simple read and write examples to getting started section.
</li>
- <li>
- <code>BeanWriter.escapeBodyValue()</code> moved into XMLUtils
+ <li>
+ <strong>Add strategy documentation. </strong>
+ This needs to be added to the main documentation.
+ Example code needs to be created.
+ This code can also be used for more test cases.
+ </li>
+ <li>
+ <strong>Add XMLRegistry documentation. </strong>
+ Add documentation about XMLRegistry to main documentation.
+ </li>
+ <li>
+ <strong>Add XMLIntrospector Setting Documentation. </strong>
+ Add documentation about the XMLIntrospector settings to main
documentation.
+ Make sure that warnings are added about consequences of changing
settings.
+ </li>
+ <li>
+ <strong>Improve Java Docs. </strong>
+ Go through java docs, add any which are missing, correct any
mistakes etc.
</li>
</ul>
</subsection>
-</section>
+ </section>
</body>
</document>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
