From e1e9aa56fe5ba07f8cfa9feac121d48ecd861010 Mon Sep 17 00:00:00 2001 From: Henri Yandell Date: Wed, 25 Sep 2002 01:33:06 +0000 Subject: [PATCH] Release notes for Lang 1.0. git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/lang/trunk@137058 13f79535-47bb-0310-9956-ffa450edef68 --- RELEASE-NOTES.txt | 150 ++++++++++++++++++++++++++++++++++++++++------ 1 file changed, 131 insertions(+), 19 deletions(-) diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index 8349ffac5..7ef5730c7 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,34 +1,146 @@ -$Id: RELEASE-NOTES.txt,v 1.2 2002/07/25 22:44:29 bayard Exp $ +$Id: RELEASE-NOTES.txt,v 1.3 2002/09/25 01:33:06 bayard Exp $ Commons Lang Package - Version 1.0-b1 + Version 1.0 Release Notes INTRODUCTION: This document contains the release notes for this version of the Commons -Lang package. - -There is a high demand for the functionality found in Commons Lang in other -Jakarta projects. Some are already using it, often because they submitted -the original code, other times because they find the functionality useful, -and other times because they want to release and don't want to depend upon a -nightly build of Commons Lang. - -Therefore this is a beta release of a stable api for these projects and any -other interested project to depend upon. - -It is important to note that this is not a traditional beta, a piece of -code thrown out with many bugs remaining. It is a beta because additional -classes are expected to be added before a full release, but the classes -contained in this release are not expected to change. - +Lang package. Commons Lang is a set of utility functions and reusable +components that should be a help in any Java environment. NEW FEATURES: -It's all a new feature. +Since the release of the b1 package the following have been added: + +lang. + SystemUtils: + Brings together many system specific variables under one easy component. + +exception. + ExceptionUtils: + Provides helpful static functions for dealing with Exceptions. + NestableError : + Adds nesting ability to Errors. + +enum sub-package: + A solid version of the typical Java translation of a C struct. + +builder sub-package: + A series of helpers for handling standard Object methods such as equals, + toString, compareTo and hashCode in a professional manner. + BUG FIXES: +StringUtils.stripStart and stripEnd were improved to match their Javadoc. +StringUtils.convertUnicodeToNative and convertNativeToUnicode both removed. + Both methods did not work properly. + + +DEPRECATIONS: + +Much of the exception subpackage was reworked betwen 1.0-b1 and 1.0. Apart +from this the API should have a high level of backward compatibility. + + +CHANGES: [In 'diff' format] + +Jar changes +=========== +> org.apache.commons.lang.exception.ExceptionUtils +> org.apache.commons.lang.exception.NestableError +> org.apache.commons.lang.ObjectUtils$Null +> org.apache.commons.lang.ObjectUtils$1 +> org.apache.commons.lang.enum.Enum$Entry +> org.apache.commons.lang.enum.Enum$1 +> org.apache.commons.lang.enum.Enum +> org.apache.commons.lang.enum.EnumUtils +> org.apache.commons.lang.enum.ValuedEnum +> org.apache.commons.lang.builder.CompareToBuilder +> org.apache.commons.lang.builder.EqualsBuilder +> org.apache.commons.lang.builder.HashCodeBuilder +> org.apache.commons.lang.builder.StandardToStringStyle +> org.apache.commons.lang.builder.ToStringStyle$DefaultToStringStyle +> org.apache.commons.lang.builder.ToStringStyle$NoFieldNameToStringStyle +> org.apache.commons.lang.builder.ToStringStyle$SimpleToStringStyle +> org.apache.commons.lang.builder.ToStringStyle$MultiLineToStringStyle +> org.apache.commons.lang.builder.ToStringStyle$1 +> org.apache.commons.lang.builder.ToStringStyle +> org.apache.commons.lang.builder.ToStringBuilder +> org.apache.commons.lang.SystemUtils + + +Class changes +============= +org.apache.commons.lang.exception.Nestable +-------------------- +< public abstract int getLength(); +> public abstract int getThrowableCount(); +< public abstract int indexOfThrowable(int, java.lang.Class); +--- +> public abstract int indexOfThrowable(java.lang.Class, int); +> public abstract void printStackTrace(java.io.PrintStream); + +org.apache.commons.lang.exception.NestableDelegate +-------------------- +< int getLength(); +< java.lang.String getMessage(java.lang.String); +> java.lang.String getMessage(java.lang.String); +> java.lang.String getMessages()[]; +> int getThrowableCount(); +< java.lang.String getMessages()[]; +< int indexOfThrowable(int, java.lang.Class); +--- +> int indexOfThrowable(java.lang.Class, int); + +org.apache.commons.lang.exception.NestableException +-------------------- +< public int getLength(); +> public java.lang.String getMessage(int); +> public int getThrowableCount(); +< public java.lang.String getMessage(int); +< public int indexOfThrowable(int, java.lang.Class); +--- +> public int indexOfThrowable(java.lang.Class, int); + +org.apache.commons.lang.exception.NestableRuntimeException +-------------------- +< public int getLength(); +> public java.lang.String getMessage(int); +> public int getThrowableCount(); +< public java.lang.String getMessage(int); +< public int indexOfThrowable(int, java.lang.Class); +--- +> public int indexOfThrowable(java.lang.Class, int); + +org.apache.commons.lang.NumberUtils +-------------------- +> public static long minimum(long, long, long); +> public static long maximum(long, long, long); +> public static int compare(double, double); +> public static int compare(float, float); + +org.apache.commons.lang.ObjectUtils +-------------------- +> public static final org.apache.commons.lang.ObjectUtils.Null NULL; +> public org.apache.commons.lang.ObjectUtils(); +> public static java.lang.String identityToString(java.lang.Object); +> static {}; +> public static class org.apache.commons.lang.ObjectUtils. Null extends java.lang.Object implements java.io.Serializable + +org.apache.commons.lang.RandomStringUtils +-------------------- +> public org.apache.commons.lang.RandomStringUtils(); + +org.apache.commons.lang.StringUtils +-------------------- +> public org.apache.commons.lang.StringUtils(); +< public static java.lang.String stackTrace(java.lang.Throwable); +< public static java.lang.String convertUnicodeToNative(java.lang.String, java.lang.String) throws java.io.IOException; +< public static java.lang.String convertNativeToUnicode(java.lang.String, java.lang.String) throws java.io.IOException; +--- +> public static boolean containsOnly(java.lang.String, char[]);