commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bay...@apache.org
Subject svn commit: r1072856 - /commons/proper/lang/trunk/src/site/xdoc/article3_0.xml
Date Mon, 21 Feb 2011 06:36:57 GMT
Author: bayard
Date: Mon Feb 21 06:36:57 2011
New Revision: 1072856

URL: http://svn.apache.org/viewvc?rev=1072856&view=rev
Log:
Lowering the bar for the article so a release isn't held up by talking about the release

Modified:
    commons/proper/lang/trunk/src/site/xdoc/article3_0.xml

Modified: commons/proper/lang/trunk/src/site/xdoc/article3_0.xml
URL: http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/site/xdoc/article3_0.xml?rev=1072856&r1=1072855&r2=1072856&view=diff
==============================================================================
--- commons/proper/lang/trunk/src/site/xdoc/article3_0.xml (original)
+++ commons/proper/lang/trunk/src/site/xdoc/article3_0.xml Mon Feb 21 06:36:57 2011
@@ -32,12 +32,14 @@ limitations under the License.
 <p>Lang is now Java 5 based. We've generified the API, moved certain APIs to support
<code>varargs</code> and thrown out any features 
 that are now supported by Java itself. We've removed the deprecated parts of the API and
have also removed some features that 
 were deemed weak or unnecessary. All of this means that Lang 3.0 is not backwards compatible.
</p>
-<p>To that end we have changed the package name, allowing Lang 3.0 to sit side-by-side
with your previous version of Lang without any bad side effects. The new package name is the
exciting and original <code>org.apache.commons.lang3</code>. </p>
+<p>To that end we have changed the package name, allowing Lang 3.0 to sit side-by-side
with your previous version of Lang without any bad side effects. The new package name is the
exciting and original <code>org.apache.commons.lang3</code>. This also forces
you to recompile your code, making sure the compiler can let you know if a backwards incompatibility
affects you. </p>
 <p>As you'd expect, there are also new features, enhancements and bugs fixed. </p>
 </section>
+<!--
 <section name="The build">
 <p>We built 3.0 using Maven 2.2.1 and Java 1.5. <strong>Needs confirmation before
release of actual build details</strong></p>
 </section>
+-->
 <section name="Migrating from 2.x">
 <h3>Java code</h3>
 <p>Despite the label of backwards incompatibility, in the vast majority of cases the
simple addition of a <code>'3'</code> to an import statement will suffice for
your migration. </p><br/>
@@ -46,6 +48,7 @@ were deemed weak or unnecessary. All of 
 <p><code>groupId</code>: <code>commons-lang</code> -&gt;
<code>org.apache.commons</code></p>
 <p><code>artifactId</code>: <code>commons-lang</code> -&gt;
<code>commons-lang3</code></p>
 </section>
+
 <section name="What's gone?">
 <h3>Enum package</h3>
 <p>Java 5 provided enums out of the box, therefore we dispensed with both the deprecated
enum package, 
@@ -76,31 +79,31 @@ we will remove the related methods in La
 <section name="New packages">
 <p>Two new packages have shown up. org.apache.commons.lang3.concurrent, which unsurprisingly
provides support classes for 
 multi-threaded programming, and org.apache.commons.lang3.text.translate, which provides a
pluggable API for text transformation. </p>
-TODO: Add examples
+<!-- TODO: Add examples -->
 </section>
-<section name="New classes">
-<p><code>CharSequenceUtils</code></p>
-<p><code>EnumUtils</code></p>
-<p><code>JavaVersion</code></p>
-<p><code>Pair</code></p>
-<p><code>Range</code></p>
-<p><code>builder.Builder</code></p>
-<p><code>exception.ContextedException</code></p>
-<p><code>exception.CloneFailedException</code></p>
-<p><code>reflect.ConstructorUtils</code></p>
-<p><code>reflect.FieldUtils</code></p>
-<p><code>reflect.MethodUtils</code></p>
-<p><code>reflect.TypeUtils</code></p>
-<p><code>text.WordUtils</code></p>
-</section>
-<section name="New methods">
-</section>
-
-<section name="What's changed?">
-  <p>Add info about SystemUtils moving over to the JavaVersion enum and away from int/float.
</p>
+<section name="New classes + methods">
+<p>There are many new classes and methods in Lang 3.0 - the most complete way to see
the changes is via this <a href="lang2-lang3-clirr-report.html">Lang2 to Lang3 Clirr
report</a>. </p>
+<p>Here is a summary of the new classes: </p>
+<ul>
+<li><code>AnnotationUtils</code></li>
+<li><code>CharSequenceUtils</code></li>
+<li><code>EnumUtils</code></li>
+<li><code>JavaVersion</code> - used in SystemUtils</li>
+<li><code>Pair</code></li>
+<li><code>Range</code> - replaces the old math.*Range classes</li>
+<li><code>builder.Builder</code></li>
+<li><code>exception.ContextedException</code></li>
+<li><code>exception.CloneFailedException</code></li>
+<li><code>reflect.ConstructorUtils</code></li>
+<li><code>reflect.FieldUtils</code></li>
+<li><code>reflect.MethodUtils</code></li>
+<li><code>reflect.TypeUtils</code></li>
+<li><code>text.WordUtils</code></li>
+</ul>
 </section>
 
-<section name="What's fixed?">
+<section name="Bugfixes?">
+<p>See the <a href="changes-report.html#3.0">3.0 changes report</a> for
the list of fixed bugs and other enhancements. </p>
 </section>
 
 <!--



Mime
View raw message