commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rdon...@apache.org
Subject cvs commit: jakarta-commons/betwixt/xdocs tasks.xml navigation.xml overview.xml todo.xml
Date Sat, 25 Jan 2003 20:15:21 GMT
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:commons-dev-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:commons-dev-help@jakarta.apache.org>


Mime
View raw message