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> ->
<code>org.apache.commons</code></p>
<p><code>artifactId</code>: <code>commons-lang</code> ->
<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>
<!--
