commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bay...@apache.org
Subject svn commit: r1148224 - /commons/proper/lang/trunk/src/site/xdoc/userguide.xml
Date Tue, 19 Jul 2011 08:28:57 GMT
Author: bayard
Date: Tue Jul 19 08:28:56 2011
New Revision: 1148224

URL: http://svn.apache.org/viewvc?rev=1148224&view=rev
Log:
Added note on Lang 3.0 being useable beside earlier versions; and removing the lang3.exception
header

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

Modified: commons/proper/lang/trunk/src/site/xdoc/userguide.xml
URL: http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/site/xdoc/userguide.xml?rev=1148224&r1=1148223&r2=1148224&view=diff
==============================================================================
--- commons/proper/lang/trunk/src/site/xdoc/userguide.xml (original)
+++ commons/proper/lang/trunk/src/site/xdoc/userguide.xml Tue Jul 19 08:28:56 2011
@@ -34,7 +34,6 @@ limitations under the License.
       <a href="#Description">[Description]</a>
       <a href="#lang3.">[lang3.*]</a>
       <a href="#lang3.builder.">[lang3.builder.*]</a>
-      <a href="#lang3.exception.">[lang3.exception.*]</a>
       <a href="#lang3.math.">[lang3.math.*]</a>
       <a href="#lang3.mutable.">[lang3.mutable.*]</a>
       <a href="#lang3.text.">[lang3.text.*]</a>
@@ -47,7 +46,7 @@ limitations under the License.
   <section name="Description">
    <p>The Commons Lang library provides much needed additions to the standard JDK's
java.lang package. Very generic, very reusable components for everyday use.</p>
    <p>The top level package contains various Utils classes, whilst there are various
subpackages including math, concurrent and builder. Using the Utils classes is generally simplicity
itself. They are the equivalent of global functions in another language, a collection of stand-alone,
thread-safe, static methods. In contrast, subpackages may contain interfaces which may have
to be implemented or classes which may need to be extended to get the full functionality from
the code. They may, however, contain more global-like functions. </p>
-   <p>Lang 3.0 is JDK 1.5+; before that Lang was JDK 1.2+. In both cases you can find
features of later JDKs being maintained by us and likely to be removed or modified in favour
of the JDK in the next major version. </p>
+   <p>Lang 3.0 is JDK 1.5+; before that Lang was JDK 1.2+. In both cases you can find
features of later JDKs being maintained by us and likely to be removed or modified in favour
of the JDK in the next major version. Note that Lang 3.0 uses a different package than its
predecessors, allowing it to be used at the same time as an earlier version. </p>
    <p>You will find deprecated methods as you stroll through the Lang documentation.
These are removed in the next major version. </p>
    <p>Before we begin, it's a good time to mention the Utils classes. They all contain
empty public constructors with warnings not to use. This may seem an odd thing to do, but
it allows tools like Velocity to access the class as if it were a bean. In other words, yes
we know about private constructors and have chosen not to use them. </p>
   </section>



Mime
View raw message