You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sc...@apache.org on 2003/08/02 20:28:19 UTC

cvs commit: jakarta-commons/lang STATUS.html RELEASE-NOTES.txt

scolebourne    2003/08/02 11:28:19

  Modified:    lang     STATUS.html RELEASE-NOTES.txt
  Log:
  Update status docs following CharRange/CharSet change
  
  Revision  Changes    Path
  1.45      +4 -3      jakarta-commons/lang/STATUS.html
  
  Index: STATUS.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/lang/STATUS.html,v
  retrieving revision 1.44
  retrieving revision 1.45
  diff -u -r1.44 -r1.45
  --- STATUS.html	20 Jul 2003 16:14:51 -0000	1.44
  +++ STATUS.html	2 Aug 2003 18:28:19 -0000	1.45
  @@ -29,6 +29,7 @@
   <ul>
    <li><strong>ArrayUtils</strong> - Helper for manipulating arrays.</li>
    <li><strong>BooleanUtils</strong> - Helper for boolean and java.lang.Boolean.</li>
  + <li><strong>CharRange</strong> - A range of characters.</li>
    <li><strong>CharSetUtils</strong> - Methods for dealing with CharSets, which are sets of characters such as [a-z] and [abcdez].</li>
    <li><strong>ClassUtils</strong> - Helper for manipulating java.lang.Class objects.</li>
    <li><strong>ObjectUtils</strong> - Helper for java.lang.Object.</li>
  @@ -121,7 +122,6 @@
   <h3>4.  KNOWN ISSUES</h3>
   <p>
   <ul>
  -<li>CharRange.UNSET - will have problems if we introduce reverse ranges that go down to \u0000.</lI>
   </ul>
   </p>
   
  @@ -132,7 +132,7 @@
   <p>Want to help?  Here's some "to do" items the team has identified as possibly being in scope for Lang.
   Note that all are still under discussion, so please mail the list before actioning.</p>
   <ul>
  -<li>Reflection utilities - work underway in reflect package.</li>
  +<li>Reflection utilities - work underway in reflect package. Move out of [lang]?</li>
   <li>DateRange/Duration class.</li>
   <li>DurationFormatUtils to be completed and made public.</li>
   <li>CloneUtils - utility class to enable cloning via various different mechanisms.</li>
  @@ -145,6 +145,7 @@
   <li>Faster StringTokeniser - Is Java's slow?</li>
   <li>Mutable Number classes - like Integer/Double but mutable.</li>
   <li>StringUtilsNPE - A StringUtils that doesn't like nulls.</li>
  +<li>CharSetUtils - refactor methods onto CharSet class.</li>
   </ul>
   
   
  
  
  
  1.18      +14 -6     jakarta-commons/lang/RELEASE-NOTES.txt
  
  Index: RELEASE-NOTES.txt
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/lang/RELEASE-NOTES.txt,v
  retrieving revision 1.17
  retrieving revision 1.18
  diff -u -r1.17 -r1.18
  --- RELEASE-NOTES.txt	30 Jul 2003 03:30:58 -0000	1.17
  +++ RELEASE-NOTES.txt	2 Aug 2003 18:28:19 -0000	1.18
  @@ -11,14 +11,18 @@
   Lang package. Commons Lang is a set of utility functions and reusable 
   components that should be a help in any Java environment.
   
  +This release has involved a major clean and tidy exercise.
  +Javadoc and Tests are now much more thorough.
  +All methods should now be much clearer in what they do in unusual cases.
  +
   
   INCOMPATIBLE CHANGES:
  -Some StringUtils methods have changed functionality from 1.0.
  +Some StringUtils methods have changed functionality from 1.0:
       isEmpty()
       chomp(String)
       chomp(String,String)
  -Other methods have changed null handling
  -Check your code before implementing this release.
  +Numerous other methods have changed null handling to accept nulls gracefully.
  +As with all major version releases, check your code for incompatibilities.
   
   
   NEW FEATURES:
  @@ -28,6 +32,7 @@
   lang package:
       ArrayUtils
       BooleanUtils
  +    CharRange (previously package scoped)
       ClassUtils
       StringEscapeUtils
       StringPrintWriter
  @@ -66,6 +71,9 @@
   Since the release of the 1.0 package the following classes have been changed:
   
   lang:
  +    CharSet:
  +        Added factory method, equals and hashCode().
  +        Better defined and tested the set syntax.
       CharSetUtils:
           added keep method:  keep any characters specified in the CharSet string
       RandomStringUtils:
  @@ -76,8 +84,8 @@
           isEmpty() changed to not trim
           chomp() changed to be more like Perl.
           Various methods changed in the handling of null (less exceptions).
  -        Thirty new methods.
  -        Seven methods deprecated.
  +        Many new methods.
  +        Various methods deprecated.
       SystemUtils:
           isJavaVersionAtLeast(int) added. getJavaVersion() deprecated.
           host of new constants.