commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Niall Pemberton <niall.pember...@gmail.com>
Subject Re: svn commit: r1583482 - in /commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3: ./ builder/ concurrent/ event/ exception/ math/ reflect/ text/ text/translate/ time/
Date Tue, 01 Apr 2014 20:56:35 GMT
On Tue, Apr 1, 2014 at 3:32 AM, sebb <sebbaz@gmail.com> wrote:

> On 31 March 2014 23:54,  <niallp@apache.org> wrote:
> > Author: niallp
> > Date: Mon Mar 31 22:54:57 2014
> > New Revision: 1583482
> >
> > URL: http://svn.apache.org/r1583482
> > Log:
> > Fix JavaDoc issues with JDK 1.8
> >
> > Modified:
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/JavaVersion.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SerializationUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SystemUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Builder.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/CompareToBuilder.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Diff.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/HashCodeBuilder.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/StandardToStringStyle.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BasicThreadFactory.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/package-info.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/event/EventListenerSupport.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedException.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedRuntimeException.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/math/Fraction.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeLiteral.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrLookup.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrTokenizer.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/WordUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/translate/NumericEntityUnescaper.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DateUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/StopWatch.java
> >
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/package-info.java
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/JavaVersion.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/JavaVersion.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/JavaVersion.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/JavaVersion.java
> Mon Mar 31 22:54:57 2014
> > @@ -95,7 +95,7 @@ public enum JavaVersion {
> >      /**
> >       * <p>Whether this version of Java is at least the version of Java
> passed in.</p>
> >       *
> > -     * <p>For example:<br />
> > +     * <p>For example:<br>
> >       *  {@code myVersion.atLeast(JavaVersion.JAVA_1_4)}<p>
> >       *
> >       * @param requiredVersion  the version to check against, not null
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/ObjectUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -286,7 +286,7 @@ public class ObjectUtils {
> >       *
> >       * @param appendable  the appendable to append to
> >       * @param object  the object to create a toString for
> > -     * @throws IOException
> > +     * @throws IOException if an I/O error occurs
> >       * @since 3.2
> >       */
> >      public static void identityToString(final Appendable appendable,
> final Object object) throws IOException {
> > @@ -482,8 +482,8 @@ public class ObjectUtils {
> >       * @param <T> type of the values processed by this method
> >       * @param c1  the first comparable, may be null
> >       * @param c2  the second comparable, may be null
> > -     * @return a negative value if c1 < c2, zero if c1 = c2
> > -     *  and a positive value if c1 > c2
> > +     * @return a negative value if c1 &gt; c2, zero if c1 = c2
>
> Surely that should be   &lt; above?


Thanks, fixed

Niall



> > +     *  and a positive value if c1 &gt; c2
> >       */
> >      public static <T extends Comparable<? super T>> int compare(final T
> c1, final T c2) {
> >          return compare(c1, c2, false);
> > @@ -498,8 +498,8 @@ public class ObjectUtils {
> >       * @param nullGreater if true {@code null} is considered greater
> >       *  than a non-{@code null} value or if false {@code null} is
> >       *  considered less than a Non-{@code null} value
> > -     * @return a negative value if c1 < c2, zero if c1 = c2
> > -     *  and a positive value if c1 > c2
> > +     * @return a negative value if c1 &lt; c2, zero if c1 = c2
> > +     *  and a positive value if c1 &gt; c2
> >       * @see java.util.Comparator#compare(Object, Object)
> >       */
> >      public static <T extends Comparable<? super T>> int compare(final T
> c1, final T c2, final boolean nullGreater) {
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SerializationUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SerializationUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SerializationUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SerializationUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -31,7 +31,7 @@ import java.util.Map;
> >  /**
> >   * <p>Assists with the serialization process and performs additional
> functionality based
> >   * on serialization.</p>
> > - * <p>
> > + *
> >   * <ul>
> >   * <li>Deep clone using serialization
> >   * <li>Serialize managing finally and IOException
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringEscapeUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -420,8 +420,8 @@ public class StringEscapeUtils {
> >       * <p>{@code StringEscapeUtils} instances should NOT be constructed
> in
> >       * standard programming.</p>
> >       *
> > -     * <p>Instead, the class should be used as:
> > -     * <pre>StringEscapeUtils.escapeJava("foo");</pre></p>
> > +     * <p>Instead, the class should be used as:</p>
> > +     * <pre>StringEscapeUtils.escapeJava("foo");</pre>
> >       *
> >       * <p>This constructor is public to permit tools that require a
> JavaBean
> >       * instance to operate.</p>
> > @@ -443,12 +443,11 @@ public class StringEscapeUtils {
> >       * <p>The only difference between Java strings and JavaScript
> strings
> >       * is that in JavaScript, a single quote and forward-slash (/) are
> escaped.</p>
> >       *
> > -     * <p>Example:
> > +     * <p>Example:</p>
> >       * <pre>
> >       * input string: He didn't say, "Stop!"
> >       * output string: He didn't say, \"Stop!\"
> >       * </pre>
> > -     * </p>
> >       *
> >       * @param input  String to escape values in, may be null
> >       * @return String with escaped values, {@code null} if null string
> input
> > @@ -470,12 +469,11 @@ public class StringEscapeUtils {
> >       *
> >       * <p>Note that EcmaScript is best known by the JavaScript and
> ActionScript dialects. </p>
> >       *
> > -     * <p>Example:
> > +     * <p>Example:</p>
> >       * <pre>
> >       * input string: He didn't say, "Stop!"
> >       * output string: He didn\'t say, \"Stop!\"
> >       * </pre>
> > -     * </p>
> >       *
> >       * @param input  String to escape values in, may be null
> >       * @return String with escaped values, {@code null} if null string
> input
> > @@ -499,12 +497,11 @@ public class StringEscapeUtils {
> >       *
> >       * <p>See http://www.ietf.org/rfc/rfc4627.txt for further details.
> </p>
> >       *
> > -     * <p>Example:
> > +     * <p>Example:</p>
> >       * <pre>
> >       * input string: He didn't say, "Stop!"
> >       * output string: He didn't say, \"Stop!\"
> >       * </pre>
> > -     * </p>
> >       *
> >       * @param input  String to escape values in, may be null
> >       * @return String with escaped values, {@code null} if null string
> input
> > @@ -570,7 +567,7 @@ public class StringEscapeUtils {
> >       * <p>
> >       * For example:
> >       * </p>
> > -     * <p><code>"bread" & "butter"</code></p>
> > +     * <p><code>"bread" &amp; "butter"</code></p>
> >       * becomes:
> >       * <p>
> >       * <code>&amp;quot;bread&amp;quot; &amp;amp;
> &amp;quot;butter&amp;quot;</code>.
> > @@ -648,7 +645,7 @@ public class StringEscapeUtils {
> >      /**
> >       * <p>Escapes the characters in a {@code String} using XML
> entities.</p>
> >       *
> > -     * <p>For example: <tt>"bread" & "butter"</tt> =>
> > +     * <p>For example: <tt>"bread" &amp; "butter"</tt> =&gt;
> >       * <tt>&amp;quot;bread&amp;quot; &amp;amp;
> &amp;quot;butter&amp;quot;</tt>.
> >       * </p>
> >       *
> > @@ -673,7 +670,7 @@ public class StringEscapeUtils {
> >      /**
> >       * <p>Escapes the characters in a {@code String} using XML
> entities.</p>
> >       *
> > -     * <p>For example: <tt>"bread" & "butter"</tt> =>
> > +     * <p>For example: <tt>"bread" &amp; "butter"</tt> =&gt;
> >       * <tt>&amp;quot;bread&amp;quot; &amp;amp;
> &amp;quot;butter&amp;quot;</tt>.
> >       * </p>
> >       *
> > @@ -705,7 +702,7 @@ public class StringEscapeUtils {
> >      /**
> >       * <p>Escapes the characters in a {@code String} using XML
> entities.</p>
> >       *
> > -     * <p>For example: <tt>"bread" & "butter"</tt> =>
> > +     * <p>For example: <tt>"bread" &amp; "butter"</tt> =&gt;
> >       * <tt>&amp;quot;bread&amp;quot; &amp;amp;
> &amp;quot;butter&amp;quot;</tt>.
> >       * </p>
> >       *
> > @@ -762,13 +759,11 @@ public class StringEscapeUtils {
> >       *
> >       * <p>If the value contains a comma, newline or double quote, then
> the
> >       *    String value is returned enclosed in double quotes.</p>
> > -     * </p>
> >       *
> >       * <p>Any double quote characters in the value are escaped with
> another double quote.</p>
> >       *
> >       * <p>If the value does not contain a comma, newline or double
> quote, then the
> >       *    String value is returned unchanged.</p>
> > -     * </p>
> >       *
> >       * see <a href="http://en.wikipedia.org/wiki/Comma-separated_values">Wikipedia</a>
> and
> >       * <a href="http://tools.ietf.org/html/rfc4180">RFC 4180</a>.
> > @@ -794,7 +789,6 @@ public class StringEscapeUtils {
> >       *
> >       * <p>If the value is not enclosed in double quotes, or is and does
> not contain a
> >       *    comma, newline or double quote, then the String value is
> returned unchanged.</p>
> > -     * </p>
> >       *
> >       * see <a href="http://en.wikipedia.org/wiki/Comma-separated_values">Wikipedia</a>
> and
> >       * <a href="http://tools.ietf.org/html/rfc4180">RFC 4180</a>.
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/StringUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -706,7 +706,7 @@ public class StringUtils {
> >      /**
> >       * <p>Strips any of a set of characters from the start and end of
> every
> >       * String in an array.</p>
> > -     * Whitespace is defined by {@link
> Character#isWhitespace(char)}.</p>
> > +     * <p>Whitespace is defined by {@link
> Character#isWhitespace(char)}.</p>
> >       *
> >       * <p>A new array is returned each time, except for length zero.
> >       * A {@code null} array will return {@code null}.
> > @@ -3981,10 +3981,10 @@ public class StringUtils {
> >       * @return the joined String, {@code null} if null array input; or
> the empty string
> >       * if {@code endIndex - startIndex <= 0}. The number of joined
> entries is given by
> >       * {@code endIndex - startIndex}
> > -     * @throws ArrayIndexOutOfBoundsException ife<br/>
> > -     * {@code startIndex < 0} or <br/>
> > -     * {@code startIndex >= array.length()} or <br/>
> > -     * {@code endIndex < 0} or <br/>
> > +     * @throws ArrayIndexOutOfBoundsException ife<br>
> > +     * {@code startIndex < 0} or <br>
> > +     * {@code startIndex >= array.length()} or <br>
> > +     * {@code endIndex < 0} or <br>
> >       * {@code endIndex > array.length()}
> >       */
> >      public static String join(final Object[] array, String separator,
> final int startIndex, final int endIndex) {
> > @@ -4842,7 +4842,7 @@ public class StringUtils {
> >       * <p>Replaces multiple characters in a String in one go.
> >       * This method can also be used to delete characters.</p>
> >       *
> > -     * <p>For example:<br />
> > +     * <p>For example:<br>
> >       * <code>replaceChars(&quot;hello&quot;, &quot;ho&quot;,
> &quot;jy&quot;) = jelly</code>.</p>
> >       *
> >       * <p>A {@code null} string input returns {@code null}.
> > @@ -5457,7 +5457,7 @@ public class StringUtils {
> >
>  //-----------------------------------------------------------------------
> >      /**
> >       * <p>Centers a String in a larger String of size {@code size}
> > -     * using the space character (' ').<p>
> > +     * using the space character (' ').</p>
> >       *
> >       * <p>If the size is less than the String length, the String is
> returned.
> >       * A {@code null} String returns {@code null}.
> > @@ -6323,7 +6323,7 @@ public class StringUtils {
> >       * <p>Abbreviates a String using ellipses. This will turn
> >       * "Now is the time for all good men" into "Now is the time
> for..."</p>
> >       *
> > -     * <p>Specifically:
> > +     * <p>Specifically:</p>
> >       * <ul>
> >       *   <li>If {@code str} is less than {@code maxWidth} characters
> >       *       long, return it.</li>
> > @@ -6333,7 +6333,6 @@ public class StringUtils {
> >       *   <li>In no case will it return a String of length greater than
> >       *       {@code maxWidth}.</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * <pre>
> >       * StringUtils.abbreviate(null, *)      = null
> > @@ -6423,7 +6422,7 @@ public class StringUtils {
> >       * <p>Abbreviates a String to the length passed, replacing the
> middle characters with the supplied
> >       * replacement String.</p>
> >       *
> > -     * <p>This abbreviation only occurs if the following criteria is
> met:
> > +     * <p>This abbreviation only occurs if the following criteria is
> met:</p>
> >       * <ul>
> >       * <li>Neither the String for abbreviation nor the replacement
> String are null or empty </li>
> >       * <li>The length to truncate to is less than the length of the
> supplied String</li>
> > @@ -6431,7 +6430,7 @@ public class StringUtils {
> >       * <li>The abbreviated String will have enough room for the length
> supplied replacement String
> >       * and the first and last characters of the supplied String for
> abbreviation</li>
> >       * </ul>
> > -     * Otherwise, the returned String will be the same as the supplied
> String for abbreviation.
> > +     * <p>Otherwise, the returned String will be the same as the
> supplied String for abbreviation.
> >       * </p>
> >       *
> >       * <pre>
> > @@ -6562,7 +6561,7 @@ public class StringUtils {
> >       * CharSequences begin to differ.</p>
> >       *
> >       * <p>For example,
> > -     * <code>indexOfDifference(new String[] {"i am a machine", "i am a
> robot"}) -> 7</code></p>
> > +     * <code>indexOfDifference(new String[] {"i am a machine", "i am a
> robot"}) -&gt; 7</code></p>
> >       *
> >       * <pre>
> >       * StringUtils.indexOfDifference(null) = -1
> > @@ -6652,7 +6651,7 @@ public class StringUtils {
> >       * characters that is common to all of them.</p>
> >       *
> >       * <p>For example,
> > -     * <code>getCommonPrefix(new String[] {"i am a machine", "i am a
> robot"}) -> "i am a "</code></p>
> > +     * <code>getCommonPrefix(new String[] {"i am a machine", "i am a
> robot"}) -&gt; "i am a "</code></p>
> >       *
> >       * <pre>
> >       * StringUtils.getCommonPrefix(null) = ""
> > @@ -6997,7 +6996,7 @@ public class StringUtils {
> >       * StringUtils.getJaroWinklerDistance("hippo", "zzzzzzzz") = 0.0
> >       * StringUtils.getJaroWinklerDistance("hello", "hallo")    = 0.88
> >       * StringUtils.getJaroWinklerDistance("ABC Corporation", "ABC
> Corp") = 0.91
> > -     * StringUtils.getJaroWinklerDistance("D N H Enterprises Inc", "D &
> H Enterprises, Inc.") = 0.93
> > +     * StringUtils.getJaroWinklerDistance("D N H Enterprises Inc", "D
> &amp; H Enterprises, Inc.") = 0.93
> >       * StringUtils.getJaroWinklerDistance("My Gym Children's Fitness
> Center", "My Gym. Childrens Fitness") = 0.94
> >       * StringUtils.getJaroWinklerDistance("PENNSYLVANIA",
> "PENNCISYLVNIA")    = 0.9
> >       * </pre>
> > @@ -7335,8 +7334,8 @@ public class StringUtils {
> >       * href="http://www.w3.org/TR/REC-xml/#NT-S">S</a> production,
> which is S ::= (#x20 | #x9 | #xD | #xA)+
> >       * <p>
> >       * Java's regexp pattern \s defines whitespace as [ \t\n\x0B\f\r]
> > -     * <p>
> > -     * For reference:
> > +     *
> > +     * <p>For reference:</p>
> >       * <ul>
> >       * <li>\x0B = vertical tab</li>
> >       * <li>\f = #xC = form feed</li>
> > @@ -7345,7 +7344,7 @@ public class StringUtils {
> >       * <li>#xA = \n</li>
> >       * <li>#xD = \r</li>
> >       * </ul>
> > -     * </p>
> > +     *
> >       * <p>
> >       * The difference is that Java's whitespace includes vertical tab
> and form feed, which this functional will also
> >       * normalize. Additionally <code>{@link #trim(String)}</code>
> removes control characters (char &lt;= 32) from both
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SystemUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SystemUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SystemUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/SystemUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -114,11 +114,12 @@ public class SystemUtils {
> >       * <p>
> >       * The {@code file.separator} System Property.
> >       * The file separator is:
> > +     * </p>
> >       * <ul>
> > -     * <li>{@code "/"}</code> on UNIX</li>
> > -     * <li>{@code "\"}</code> on Windows.</li>
> > +     * <li>{@code "/"} on UNIX</li>
> > +     * <li>{@code "\"} on Windows.</li>
> >       * </ul>
> > -     * </p>
> > +     *
> >       * <p>
> >       * Defaults to {@code null} if the runtime does not have security
> access to read this property or the property does
> >       * not exist.
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/Validate.java
> Mon Mar 31 22:54:57 2014
> > @@ -35,7 +35,7 @@ import java.util.regex.Pattern;
> >   * as defined by the Java platform. For example:</p>
> >   *
> >   * <pre>
> > - * Validate.isTrue(i > 0, "The value must be greater than zero: %d", i);
> > + * Validate.isTrue(i &gt; 0, "The value must be greater than zero: %d",
> i);
> >   * Validate.notNull(surname, "The surname must not be %s", null);
> >   * </pre>
> >   *
> > @@ -88,7 +88,7 @@ public class Validate {
> >       * validating according to an arbitrary boolean expression, such as
> validating a
> >       * primitive number or using your own custom validation
> expression.</p>
> >       *
> > -     * <pre>Validate.isTrue(i > 0.0, "The value must be greater than
> zero: %d", i);</pre>
> > +     * <pre>Validate.isTrue(i &gt; 0.0, "The value must be greater than
> zero: &#37;d", i);</pre>
> >       *
> >       * <p>For performance reasons, the long value is passed as a
> separate parameter and
> >       * appended to the exception message only in the case of an
> error.</p>
> > @@ -113,7 +113,7 @@ public class Validate {
> >       * validating according to an arbitrary boolean expression, such as
> validating a
> >       * primitive number or using your own custom validation
> expression.</p>
> >       *
> > -     * <pre>Validate.isTrue(d > 0.0, "The value must be greater than
> zero: %s", d);</pre>
> > +     * <pre>Validate.isTrue(d &gt; 0.0, "The value must be greater than
> zero: &#37;s", d);</pre>
> >       *
> >       * <p>For performance reasons, the double value is passed as a
> separate parameter and
> >       * appended to the exception message only in the case of an
> error.</p>
> > @@ -139,7 +139,7 @@ public class Validate {
> >       * primitive number or using your own custom validation
> expression.</p>
> >       *
> >       * <pre>
> > -     * Validate.isTrue(i >= min && i <= max, "The value must be between
> %d and %d", min, max);
> > +     * Validate.isTrue(i &gt;= min &amp;&amp; i &lt;= max, "The value
> must be between &#37;d and &#37;d", min, max);
> >       * Validate.isTrue(myObject.isOk(), "The object is not okay");</pre>
> >       *
> >       * @param expression  the boolean expression to check
> > @@ -163,7 +163,7 @@ public class Validate {
> >       * primitive number or using your own custom validation
> expression.</p>
> >       *
> >       * <pre>
> > -     * Validate.isTrue(i > 0);
> > +     * Validate.isTrue(i &gt; 0);
> >       * Validate.isTrue(myObject.isOk());</pre>
> >       *
> >       * <p>The message of the exception is &quot;The validated
> expression is
> > @@ -516,7 +516,7 @@ public class Validate {
> >      /**
> >       * <p>Validate that the specified argument array is neither
> >       * {@code null} nor contains any elements that are {@code null};
> > -     * otherwise throwing an exception.
> > +     * otherwise throwing an exception.</p>
> >       *
> >       * <pre>Validate.noNullElements(myArray);</pre>
> >       *
> > @@ -525,7 +525,7 @@ public class Validate {
> >       *
> >       * <p>If the array has a {@code null} element, then the message in
> the
> >       * exception is &quot;The validated array contains null element at
> index:
> > -     * &quot followed by the index.</p>
> > +     * &quot; followed by the index.</p>
> >       *
> >       * @param <T> the array type
> >       * @param array  the array to check, validated not null by this
> method
> > @@ -588,7 +588,7 @@ public class Validate {
> >       *
> >       * <p>If the array has a {@code null} element, then the message in
> the
> >       * exception is &quot;The validated iterable contains null element
> at index:
> > -     * &quot followed by the index.</p>
> > +     * &quot; followed by the index.</p>
> >       *
> >       * @param <T> the iterable type
> >       * @param iterable  the iterable to check, validated not null by
> this method
> > @@ -787,7 +787,7 @@ public class Validate {
> >       * primitive number or using your own custom validation
> expression.</p>
> >       *
> >       * <pre>
> > -     * Validate.validState(field > 0);
> > +     * Validate.validState(field &gt; 0);
> >       * Validate.validState(this.isOk());</pre>
> >       *
> >       * <p>The message of the exception is &quot;The validated state is
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Builder.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Builder.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Builder.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Builder.java
> Mon Mar 31 22:54:57 2014
> > @@ -38,7 +38,7 @@ package org.apache.commons.lang3.builder
> >   *
> >   * <p>
> >   * Example Builder:
> > - * <code><pre>
> > + * <pre><code>
> >   * class FontBuilder implements Builder&lt;Font&gt; {
> >   *     private Font font;
> >   *
> > @@ -62,15 +62,15 @@ package org.apache.commons.lang3.builder
> >   *         return this.font;
> >   *     }
> >   * }
> > - * </pre></code>
> > + * </code></pre>
> >   *
> >   * Example Builder Usage:
> > - * <code><pre>
> > + * <pre><code>
> >   * Font bold14ptSansSerifFont = new FontBuilder(Font.SANS_SERIF).bold()
> >   *
>  .size(14.0f)
> >   *
>  .build();
> > - * </pre></code>
> > - * </p>
> > + * </code></pre>
> > + *
> >   *
> >   * @param <T> the type of object that the builder will construct or
> compute.
> >   *
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/CompareToBuilder.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/CompareToBuilder.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/CompareToBuilder.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/CompareToBuilder.java
> Mon Mar 31 22:54:57 2014
> > @@ -27,7 +27,7 @@ import org.apache.commons.lang3.ArrayUti
> >  /**
> >   * Assists in implementing {@link
> java.lang.Comparable#compareTo(Object)} methods.
> >   *
> > - * It is consistent with <code>equals(Object)</code> and
> > + * <p>It is consistent with <code>equals(Object)</code> and
> >   * <code>hashcode()</code> built with {@link EqualsBuilder} and
> >   * {@link HashCodeBuilder}.</p>
> >   *
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Diff.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Diff.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Diff.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/Diff.java
> Mon Mar 31 22:54:57 2014
> > @@ -88,13 +88,12 @@ public abstract class Diff<T> extends Pa
> >      /**
> >       * <p>
> >       * Returns a {@code String} representation of the {@code Diff},
> with the
> > -     * following format:
> > +     * following format:</p>
> >       *
> >       * <pre>
> >       * [fieldname: left-value, right-value]
> >       * </pre>
> >       *
> > -     * </p>
> >       *
> >       * @return the string representation
> >       */
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/HashCodeBuilder.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/HashCodeBuilder.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/HashCodeBuilder.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/HashCodeBuilder.java
> Mon Mar 31 22:54:57 2014
> > @@ -560,7 +560,7 @@ public class HashCodeBuilder implements
> >       * that represent <code>false</code>.
> >       * </p>
> >       * <p>
> > -     * This is in accordance with the <quote>Effective Java</quote>
> design.
> > +     * This is in accordance with the <i>Effective Java</i> design.
> >       * </p>
> >       *
> >       * @param value
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ReflectionToStringBuilder.java
> Mon Mar 31 22:54:57 2014
> > @@ -61,11 +61,11 @@ import org.apache.commons.lang3.ClassUti
> >   * </pre>
> >   * <p>
> >   * A subclass can control field output by overriding the methods:
> > + * </p>
> >   * <ul>
> >   * <li>{@link #accept(java.lang.reflect.Field)}</li>
> >   * <li>{@link #getValue(java.lang.reflect.Field)}</li>
> >   * </ul>
> > - * </p>
> >   * <p>
> >   * For example, this method does <i>not</i> include the
> <code>password</code> field in the returned <code>String</code>:
> >   * </p>
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/StandardToStringStyle.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/StandardToStringStyle.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/StandardToStringStyle.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/StandardToStringStyle.java
> Mon Mar 31 22:54:57 2014
> > @@ -465,7 +465,7 @@ public class StandardToStringStyle exten
> >
>  //---------------------------------------------------------------------
> >
> >      /**
> > -     * Gets the end text to output when a <code>Collection</code>,
> > +     * <p>Gets the end text to output when a <code>Collection</code>,
> >       * <code>Map</code> or <code>Array</code> size is output.</p>
> >       *
> >       * <p>This is output after the size value.</p>
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/builder/ToStringStyle.java
> Mon Mar 31 22:54:57 2014
> > @@ -48,6 +48,7 @@ import org.apache.commons.lang3.SystemUt
> >   *
> >   * <p>If you want to format the output of certain objects, such as
> dates, you
> >   * must create a subclass and override a method.
> > + * </p>
> >   * <pre>
> >   * public class MyStyle extends ToStringStyle {
> >   *   protected void appendDetail(StringBuffer buffer, String fieldName,
> Object value) {
> > @@ -58,7 +59,6 @@ import org.apache.commons.lang3.SystemUt
> >   *   }
> >   * }
> >   * </pre>
> > - * </p>
> >   *
> >   * @since 1.0
> >   * @version $Id$
> > @@ -298,7 +298,7 @@ public abstract class ToStringStyle impl
> >      private String nullText = "<null>";
> >
> >      /**
> > -     * The summary size text start <code>'<size'</code>.
> > +     * The summary size text start <code>'&lt;size'</code>.
> >       */
> >      private String sizeStartText = "<size=";
> >
> > @@ -608,7 +608,7 @@ public abstract class ToStringStyle impl
> >      }
> >
> >      /**
> > -     * <p>Append to the <code>toString</code> a <code>Map<code>.</p>
> > +     * <p>Append to the <code>toString</code> a <code>Map</code>.</p>
> >       *
> >       * @param buffer  the <code>StringBuffer</code> to populate
> >       * @param fieldName  the field name, typically not used as already
> appended
> > @@ -1526,7 +1526,7 @@ public abstract class ToStringStyle impl
> >      }
> >
> >      /**
> > -     * <p>Append to the <code>toString<code> the field end.</p>
> > +     * <p>Append to the <code>toString</code> the field end.</p>
> >       *
> >       * @param buffer  the <code>StringBuffer</code> to populate
> >       * @param fieldName  the field name, typically not used as already
> appended
> > @@ -1544,7 +1544,7 @@ public abstract class ToStringStyle impl
> >       * <p>The output consists of a prefix, the passed in size
> >       * and a suffix.</p>
> >       *
> > -     * <p>The default format is <code>'&lt;size=n&gt;'<code>.</p>
> > +     * <p>The default format is <code>'&lt;size=n&gt;'</code>.</p>
> >       *
> >       * @param buffer  the <code>StringBuffer</code> to populate
> >       * @param fieldName  the field name, typically not used as already
> appended
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/AtomicInitializer.java
> Mon Mar 31 22:54:57 2014
> > @@ -27,6 +27,7 @@ import java.util.concurrent.atomic.Atomi
> >   * This class maintains a member field of type {@code AtomicReference}.
> It
> >   * implements the following algorithm to create and initialize an
> object in its
> >   * {@link #get()} method:
> > + * </p>
> >   * <ul>
> >   * <li>First it is checked whether the {@code AtomicReference} variable
> contains
> >   * already a value. If this is the case, the value is directly
> returned.</li>
> > @@ -39,7 +40,6 @@ import java.util.concurrent.atomic.Atomi
> >   * in it and returned by this method.</li>
> >   * <li>Otherwise the value stored in the {@code AtomicReference} is
> returned.</li>
> >   * </ul>
> > - * </p>
> >   * <p>
> >   * Because atomic variables are used this class does not need any
> >   * synchronization. So there is no danger of deadlock, and access to
> the managed
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BackgroundInitializer.java
> Mon Mar 31 22:54:57 2014
> > @@ -41,6 +41,7 @@ import java.util.concurrent.Future;
> >   * initialization can be implemented, and a result object can be
> returned. With
> >   * this method in place the basic usage of this class is as follows
> (where
> >   * {@code MyBackgroundInitializer} is a concrete subclass):
> > + * </p>
> >   *
> >   * <pre>
> >   * MyBackgroundInitializer initializer = new MyBackgroundInitializer();
> > @@ -51,7 +52,6 @@ import java.util.concurrent.Future;
> >   * Object result = initializer.get();
> >   * </pre>
> >   *
> > - * </p>
> >   * <p>
> >   * After the construction of a {@code BackgroundInitializer} object its
> >   * {@link #start()} method has to be called. This starts the background
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BasicThreadFactory.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BasicThreadFactory.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BasicThreadFactory.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/BasicThreadFactory.java
> Mon Mar 31 22:54:57 2014
> > @@ -35,6 +35,7 @@ import java.util.concurrent.atomic.Atomi
> >   * <p>
> >   * This class provides some frequently needed configuration options for
> the
> >   * threads it creates. These are the following:
> > + * </p>
> >   * <ul>
> >   * <li>A name pattern for the threads created by this factory can be
> specified.
> >   * This is often useful if an application uses multiple executor
> services for
> > @@ -56,7 +57,6 @@ import java.util.concurrent.atomic.Atomi
> >   * <li>The {@code UncaughtExceptionHandler} for the thread. This
> handler is
> >   * called if an uncaught exception occurs within the thread.</li>
> >   * </ul>
> > - * </p>
> >   * <p>
> >   * {@code BasicThreadFactory} wraps another thread factory which
> actually
> >   * creates new threads. The configuration options are set on the
> threads created
> > @@ -70,6 +70,7 @@ import java.util.concurrent.atomic.Atomi
> >   * the configuration options an application is interested in need to be
> set. The
> >   * following example shows how a {@code BasicThreadFactory} is created
> and
> >   * installed in an {@code ExecutorService}:
> > + * </p>
> >   *
> >   * <pre>
> >   * // Create a factory that produces daemon threads with a naming
> pattern and
> > @@ -82,7 +83,6 @@ import java.util.concurrent.atomic.Atomi
> >   * // Create an executor service for single-threaded execution
> >   * ExecutorService exec = Executors.newSingleThreadExecutor(factory);
> >   * </pre>
> > - * </p>
> >   *
> >   * @since 3.0
> >   * @version $Id$
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/CallableBackgroundInitializer.java
> Mon Mar 31 22:54:57 2014
> > @@ -45,6 +45,7 @@ import java.util.concurrent.ExecutorServ
> >   * initializer's {@link #get()} method can be called (which may block
> until
> >   * background execution is complete). The following code fragment shows
> a
> >   * typical usage example:
> > + * </p>
> >   *
> >   * <pre>
> >   * // a Callable that performs a complex computation
> > @@ -59,7 +60,6 @@ import java.util.concurrent.ExecutorServ
> >   * Integer result = initializer.get();
> >   * </pre>
> >   *
> > - * </p>
> >   *
> >   * @since 3.0
> >   * @version $Id$
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/ConcurrentUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -212,6 +212,7 @@ public class ConcurrentUtils {
> >       * present. This method works similar to the {@code putIfAbsent()}
> method of
> >       * the {@code ConcurrentMap} interface, but the value returned is
> different.
> >       * Basically, this method is equivalent to the following code
> fragment:
> > +     * </p>
> >       *
> >       * <pre>
> >       * if (!map.containsKey(key)) {
> > @@ -222,6 +223,7 @@ public class ConcurrentUtils {
> >       * }
> >       * </pre>
> >       *
> > +     * <p>
> >       * except that the action is performed atomically. So this method
> always
> >       * returns the value which is stored in the map.
> >       * </p>
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/LazyInitializer.java
> Mon Mar 31 22:54:57 2014
> > @@ -40,6 +40,7 @@ package org.apache.commons.lang3.concurr
> >   * As an usage example consider that we have a class {@code
> ComplexObject} whose
> >   * instantiation is a complex operation. In order to apply lazy
> initialization
> >   * to this class, a subclass of {@code LazyInitializer} has to be
> created:
> > + * </p>
> >   *
> >   * <pre>
> >   * public class ComplexObjectInitializer extends
> LazyInitializer&lt;ComplexObject&gt; {
> > @@ -50,9 +51,11 @@ package org.apache.commons.lang3.concurr
> >   * }
> >   * </pre>
> >   *
> > + * <p>
> >   * Access to the data object is provided through the {@code get()}
> method. So,
> >   * code that wants to obtain the {@code ComplexObject} instance would
> simply
> >   * look like this:
> > + * </p>
> >   *
> >   * <pre>
> >   * // Create an instance of the lazy initializer
> > @@ -62,7 +65,6 @@ package org.apache.commons.lang3.concurr
> >   * ComplexObject cobj = initializer.get();
> >   * </pre>
> >   *
> > - * </p>
> >   * <p>
> >   * If multiple threads call the {@code get()} method when the object
> has not yet
> >   * been created, they are blocked until initialization completes. The
> algorithm
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/MultiBackgroundInitializer.java
> Mon Mar 31 22:54:57 2014
> > @@ -42,6 +42,7 @@ import java.util.concurrent.ExecutorServ
> >   * <p>
> >   * The typical usage scenario for {@code MultiBackgroundInitializer} is
> as
> >   * follows:
> > + * </p>
> >   * <ul>
> >   * <li>Create a new instance of the class. Optionally pass in a
> pre-configured
> >   * {@code ExecutorService}. Alternatively {@code
> MultiBackgroundInitializer} can
> > @@ -59,7 +60,6 @@ import java.util.concurrent.ExecutorServ
> >   * initialization. It also stores information about exceptions that have
> >   * occurred.</li>
> >   * </ul>
> > - * </p>
> >   * <p>
> >   * {@code MultiBackgroundInitializer} starts a special controller task
> that
> >   * starts all {@code BackgroundInitializer} objects added to the
> instance.
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/TimedSemaphore.java
> Mon Mar 31 22:54:57 2014
> > @@ -50,6 +50,7 @@ import java.util.concurrent.TimeUnit;
> >   * </p>
> >   * <p>
> >   * A thread class for performing database queries could look as follows:
> > + * </p>
> >   *
> >   * <pre>
> >   * public class StatisticsThread extends Thread {
> > @@ -74,9 +75,11 @@ import java.util.concurrent.TimeUnit;
> >   * }
> >   * </pre>
> >   *
> > + * <p>
> >   * The following code fragment shows how a {@code TimedSemaphore} is
> created
> >   * that allows only 10 operations per second and passed to the
> statistics
> >   * thread:
> > + * </p>
> >   *
> >   * <pre>
> >   * TimedSemaphore sem = new TimedSemaphore(1, TimeUnit.SECOND, 10);
> > @@ -84,7 +87,6 @@ import java.util.concurrent.TimeUnit;
> >   * thread.start();
> >   * </pre>
> >   *
> > - * </p>
> >   * <p>
> >   * When creating an instance the time period for the semaphore must be
> >   * specified. {@code TimedSemaphore} uses an executor service with a
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/package-info.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/package-info.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/package-info.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/concurrent/package-info.java
> Mon Mar 31 22:54:57 2014
> > @@ -28,7 +28,7 @@
> >   *
> >   * <pre>
> >   * <code>
> > - * public interface ConcurrentInitializer<T> {
> > + * public interface ConcurrentInitializer&lt;T&gt; {
> >   *    T get() throws ConcurrentException;
> >   * }
> >   * </code>
> > @@ -64,7 +64,7 @@
> >   *
> >   * <pre>
> >   * <code>
> > - * public class MessagingServiceInitializer extends
> LazyInitializer<MessagingService> {
> > + * public class MessagingServiceInitializer extends
> LazyInitializer&lt;MessagingService&gt; {
> >   *   protected MessagingService initialize() throws ConcurrentException
> {
> >   *     // Do all necessary steps to create and initialize the service
> object
> >   *     MessagingService service = ...
> > @@ -81,9 +81,9 @@
> >   * <code>
> >   * public class ServerThread implements Runnable {
> >   *  // The initializer for obtaining the messaging service.
> > - *  private final ConcurrentInitializer<MessagingService> initializer;
> > + *  private final ConcurrentInitializer&lt;MessagingService&gt;
> initializer;
> >   *
> > - *  public ServerThread(ConcurrentInitializer<MessagingService> init) {
> > + *  public ServerThread(ConcurrentInitializer&lt;MessagingService&gt;
> init) {
> >   *    initializer = init;
> >   *  }
> >   *
> > @@ -145,7 +145,7 @@
> >   *
> >   * <pre>
> >   * <code>
> > - * public class URLLoader extends BackgroundInitializer<String> {
> > + * public class URLLoader extends BackgroundInitializer&lt;String&gt; {
> >   *   // The URL to be loaded.
> >   *   private final URL url;
> >   *
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/event/EventListenerSupport.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/event/EventListenerSupport.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/event/EventListenerSupport.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/event/EventListenerSupport.java
> Mon Mar 31 22:54:57 2014
> > @@ -33,18 +33,20 @@ import java.util.concurrent.CopyOnWriteA
> >  import org.apache.commons.lang3.Validate;
> >
> >  /**
> > - * An EventListenerSupport object can be used to manage a list of event
> > + * <p>An EventListenerSupport object can be used to manage a list of
> event
> >   * listeners of a particular type. The class provides
> >   * {@link #addListener(Object)} and {@link #removeListener(Object)}
> methods
> >   * for registering listeners, as well as a {@link #fire()} method for
> firing
> >   * events to the listeners.
> > + * </p>
> >   *
> > - * <p/>
> > + * <p>
> >   * To use this class, suppose you want to support ActionEvents.  You
> would do:
> > - * <code><pre>
> > + * </p>
> > + * <pre><code>
> >   * public class MyActionEventSource
> >   * {
> > - *   private EventListenerSupport<ActionListener> actionListeners =
> > + *   private EventListenerSupport&lt;ActionListener&gt; actionListeners
> =
> >   *       EventListenerSupport.create(ActionListener.class);
> >   *
> >   *   public void someMethodThatFiresAction()
> > @@ -53,10 +55,12 @@ import org.apache.commons.lang3.Validate
> >   *     actionListeners.fire().actionPerformed(e);
> >   *   }
> >   * }
> > - * </pre></code>
> > + * </code></pre>
> >   *
> > + * <p>
> >   * Serializing an {@link EventListenerSupport} instance will result in
> any
> >   * non-{@link Serializable} listeners being silently dropped.
> > + * </p>
> >   *
> >   * @param <L> the type of event listener that is supported by this
> proxy.
> >   *
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedException.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedException.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedException.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedException.java
> Mon Mar 31 22:54:57 2014
> > @@ -48,7 +48,10 @@ import org.apache.commons.lang3.tuple.Pa
> >   *          .addContextValue("Previous Balance", previousBalance)
> >   *   }
> >   * }
> > - * </pre> or improve diagnose data at a higher level:
> > + * </pre>
> > + * <p>
> > + * or improve diagnose data at a higher level:
> > + * </p>
> >   * <pre>
> >   *   try {
> >   *     ...
> > @@ -62,8 +65,9 @@ import org.apache.commons.lang3.tuple.Pa
> >   *   }
> >   * }
> >   * </pre>
> > - * </p><p>
> > + * <p>
> >   * The output in a printStacktrace() (which often is written to a log)
> would look something like the following:
> > + * </p>
> >   * <pre>
> >   * org.apache.commons.lang3.exception.ContextedException:
> java.lang.Exception: Error posting account transaction
> >   *  Exception Context:
> > @@ -76,7 +80,6 @@ import org.apache.commons.lang3.tuple.Pa
> >   *  at
> org.apache.commons.lang3.exception.ContextedExceptionTest.testAddValue(ContextedExceptionTest.java:88)
> >   *  ..... (rest of trace)
> >   * </pre>
> > - * </p>
> >   *
> >   * @see ContextedRuntimeException
> >   * @since 3.0
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedRuntimeException.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedRuntimeException.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedRuntimeException.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/exception/ContextedRuntimeException.java
> Mon Mar 31 22:54:57 2014
> > @@ -48,7 +48,10 @@ import org.apache.commons.lang3.tuple.Pa
> >   *          .addContextValue("Previous Balance", previousBalance)
> >   *   }
> >   * }
> > - * </pre> or improve diagnose data at a higher level:
> > + * </pre>
> > + * <p>
> > + * or improve diagnose data at a higher level:
> > + * </p>
> >   * <pre>
> >   *   try {
> >   *     ...
> > @@ -62,8 +65,9 @@ import org.apache.commons.lang3.tuple.Pa
> >   *   }
> >   * }
> >   * </pre>
> > - * </p><p>
> > + * <p>
> >   * The output in a printStacktrace() (which often is written to a log)
> would look something like the following:
> > + * </p>
> >   * <pre>
> >   * org.apache.commons.lang3.exception.ContextedRuntimeException:
> java.lang.Exception: Error posting account transaction
> >   *  Exception Context:
> > @@ -76,7 +80,6 @@ import org.apache.commons.lang3.tuple.Pa
> >   *  at
> org.apache.commons.lang3.exception.ContextedRuntimeExceptionTest.testAddValue(ContextedExceptionTest.java:88)
> >   *  ..... (rest of trace)
> >   * </pre>
> > - * </p>
> >   *
> >   * @see ContextedException
> >   * @since 3.0
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/math/Fraction.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/math/Fraction.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/math/Fraction.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/math/Fraction.java
> Mon Mar 31 22:54:57 2014
> > @@ -241,7 +241,7 @@ public final class Fraction extends Numb
> >       *
> >       * @param value  the double value to convert
> >       * @return a new fraction instance that is close to the value
> > -     * @throws ArithmeticException if <code>|value| >
> Integer.MAX_VALUE</code>
> > +     * @throws ArithmeticException if <code>|value| &gt;
> Integer.MAX_VALUE</code>
> >       *  or <code>value = NaN</code>
> >       * @throws ArithmeticException if the calculated denominator is
> <code>zero</code>
> >       * @throws ArithmeticException if the the algorithm does not
> converge
> > @@ -309,7 +309,7 @@ public final class Fraction extends Numb
> >       *  <li>'Y/Z'</li>
> >       *  <li>'X' (a simple whole number)</li>
> >       * </ol>
> > -     * and a .</p>
> > +     * <p>and a .</p>
> >       *
> >       * @param str  the string to parse, must not be <code>null</code>
> >       * @return the new <code>Fraction</code> instance
> > @@ -517,7 +517,7 @@ public final class Fraction extends Numb
> >
> >      /**
> >       * <p>Gets a fraction that is the positive equivalent of this
> one.</p>
> > -     * <p>More precisely: <code>(fraction >= 0 ? this :
> -fraction)</code></p>
> > +     * <p>More precisely: <code>(fraction &gt;= 0 ? this :
> -fraction)</code></p>
> >       *
> >       * <p>The returned fraction is not reduced.</p>
> >       *
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/FieldUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -448,7 +448,7 @@ public class FieldUtils {
> >      }
> >
> >      /**
> > -     * <p<>Gets a {@link Field} value by name. Only the class of the
> specified object will be considered.
> > +     * Gets a {@link Field} value by name. Only the class of the
> specified object will be considered.
> >       *
> >       * @param target
> >       *            the object to reflect, must not be {@code null}
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/MethodUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -454,15 +454,17 @@ public class MethodUtils {
> >       * Compatible parameters mean that every method parameter is
> assignable from
> >       * the given parameters.
> >       * In other words, it finds a method with the given name
> > -     * that will take the parameters given.<p>
> > +     * that will take the parameters given.</p>
> >       *
> >       * <p>This method is used by
> >       * {@link
> >       * #invokeMethod(Object object, String methodName, Object[] args,
> Class[] parameterTypes)}.
> > +     * </p>
> >       *
> >       * <p>This method can match primitive parameter by passing in
> wrapper classes.
> >       * For example, a {@code Boolean} will match a primitive {@code
> boolean}
> >       * parameter.
> > +     * </p>
> >       *
> >       * @param cls find method in this class
> >       * @param methodName find method with this name
> > @@ -503,7 +505,7 @@ public class MethodUtils {
> >       * Get the hierarchy of overridden methods down to {@code result}
> respecting generics.
> >       * @param method lowest to consider
> >       * @param interfacesBehavior whether to search interfaces, {@code
> null} {@code implies} false
> > -     * @return Set<Method> in ascending order from sub- to superclass
> > +     * @return Set&lt;Method&gt; in ascending order from sub- to
> superclass
> >       * @throws NullPointerException if the specified method is {@code
> null}
> >       * @since 3.2
> >       */
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeLiteral.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeLiteral.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeLiteral.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeLiteral.java
> Mon Mar 31 22:54:57 2014
> > @@ -56,6 +56,7 @@ import org.apache.commons.lang3.Validate
> >   * <pre>
> >   * List&lt;String&gt; listOfString = typesafe.obtain(new
> TypeLiteral&lt;List&lt;String&gt;&gt;() {}, ...);
> >   * </pre>
> > + * <p>
> >   * This has the effect of "jumping up" a level to tie a {@code
> java.lang.reflect.Type}
> >   * to a type variable while simultaneously making it short work to
> obtain a
> >   * {@code Type} instance for any given type, inline.
> > @@ -63,10 +64,10 @@ import org.apache.commons.lang3.Validate
> >   * <p>Additionally {@link TypeLiteral} implements the {@link Typed}
> interface which
> >   * is a generalization of this concept, and which may be implemented in
> custom classes.
> >   * It is suggested that APIs be defined in terms of the interface, in
> the following manner:
> > + * </p>
> >   * <pre>
> >   *   &lt;T&gt; T obtain(Typed&lt;T&gt; typed, ...);
> >   * </pre>
> > - * </p>
> >   *
> >   * @version $Id$
> >   * @since 3.2
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/reflect/TypeUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -753,8 +753,8 @@ public class TypeUtils {
> >       * instance, this method will determine that both of the parameters
> for the
> >       * interface {@link Map} are {@link Object} for the subtype
> >       * {@link java.util.Properties Properties} even though the subtype
> does not
> > -     * directly implement the {@code Map} interface.<p> </p>This method
> > -     * returns {@code null} if {@code type} is not assignable to
> > +     * directly implement the {@code Map} interface.</p>
> > +     * <p>This method returns {@code null} if {@code type} is not
> assignable to
> >       * {@code toClass}. It returns an empty map if none of the classes
> or
> >       * interfaces in its inheritance hierarchy specify any type
> arguments.</p>
> >       * <p>A side effect of this method is that it also retrieves the
> type
> > @@ -1110,13 +1110,13 @@ public class TypeUtils {
> >       * <pre>&lt;K extends java.util.Collection&lt;String&gt; &amp;
> >       * java.util.List&lt;String&gt;&gt;</pre>
> >       *
> > +     * <p>
> >       * since {@code List} is a subinterface of {@code Collection},
> >       * this method will return the bounds as if the declaration had
> been:
> > +     * </p>
> >       *
> >       * <pre>&lt;K extends java.util.List&lt;String&gt;&gt;</pre>
> >       *
> > -     * </p>
> > -     *
> >       * @param bounds an array of types representing the upper bounds of
> either
> >       * {@link WildcardType} or {@link TypeVariable}, not {@code null}.
> >       * @return an array containing the values from {@code bounds} minus
> the
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/ExtendedMessageFormat.java
> Mon Mar 31 22:54:57 2014
> > @@ -36,7 +36,7 @@ import org.apache.commons.lang3.Validate
> >   * parsed from the message pattern.  In this way custom patterns can be
> specified,
> >   * and the formats supported by <code>java.text.MessageFormat</code>
> can be overridden
> >   * at the format and/or format style level (see MessageFormat).  A
> "format element"
> > - * embedded in the message pattern is specified (<b>()?</b> signifies
> optionality):<br />
> > + * embedded in the message pattern is specified (<b>()?</b> signifies
> optionality):<br>
> >   *
> <code>{</code><i>argument-number</i><b>(</b><code>,</code><i>format-name</i><b>
> >   * (</b><code>,</code><i>format-style</i><b>)?)?</b><code>}</code>
> >   *
> > @@ -55,14 +55,13 @@ import org.apache.commons.lang3.Validate
> >   * <code>UnsupportedOperationException</code> if called.
> >   * </p>
> >   *
> > - * <p>Limitations inherited from <code>java.text.MessageFormat</code>:
> > + * <p>Limitations inherited from
> <code>java.text.MessageFormat</code>:</p>
> >   * <ul>
> >   * <li>When using "choice" subformats, support for nested formatting
> instructions is limited
> >   *     to that provided by the base class.</li>
> >   * <li>Thread-safety of <code>Format</code>s, including
> <code>MessageFormat</code> and thus
> >   *     <code>ExtendedMessageFormat</code>, is not guaranteed.</li>
> >   * </ul>
> > - * </p>
> >   *
> >   * @since 2.4
> >   * @version $Id$
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrBuilder.java
> Mon Mar 31 22:54:57 2014
> > @@ -32,6 +32,7 @@ import org.apache.commons.lang3.builder.
> >   * than StringBuffer.
> >   * <p>
> >   * The main differences from StringBuffer/StringBuilder are:
> > + * </p>
> >   * <ul>
> >   * <li>Not synchronized</li>
> >   * <li>Not final</li>
> > @@ -49,7 +50,6 @@ import org.apache.commons.lang3.builder.
> >   *   <li>size/clear/isEmpty - collections style API methods</li>
> >   *  </ul>
> >   * </li>
> > - * </ul>
> >   * <li>Views
> >   *  <ul>
> >   *   <li>asTokenizer - uses the internal buffer as the source of a
> StrTokenizer</li>
> > @@ -1302,8 +1302,9 @@ public class StrBuilder implements CharS
> >       * <p>
> >       * This method is useful for adding a separator each time around the
> >       * loop except the first.
> > +     * </p>
> >       * <pre>
> > -     * for (int i = 0; i < list.size(); i++) {
> > +     * for (int i = 0; i &lt; list.size(); i++) {
> >       *   appendSeparator(",", i);
> >       *   append(list.get(i));
> >       * }
> > @@ -1329,8 +1330,9 @@ public class StrBuilder implements CharS
> >       * <p>
> >       * This method is useful for adding a separator each time around the
> >       * loop except the first.
> > +     * </p>
> >       * <pre>
> > -     * for (int i = 0; i < list.size(); i++) {
> > +     * for (int i = 0; i &lt; list.size(); i++) {
> >       *   appendSeparator(",", i);
> >       *   append(list.get(i));
> >       * }
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrLookup.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrLookup.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrLookup.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrLookup.java
> Mon Mar 31 22:54:57 2014
> > @@ -121,7 +121,7 @@ public abstract class StrLookup<V> {
> >       * The {@link #lookup(String)} method always returns a String,
> regardless of
> >       * the underlying data, by converting it as necessary. For example:
> >       * <pre>
> > -     * Map<String, Object> map = new HashMap<String, Object>();
> > +     * Map&lt;String, Object&gt; map = new HashMap&lt;String,
> Object&gt;();
> >       * map.put("number", Integer.valueOf(2));
> >       * assertEquals("2", StrLookup.mapLookup(map).lookup("number"));
> >       * </pre>
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrTokenizer.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrTokenizer.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrTokenizer.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/StrTokenizer.java
> Mon Mar 31 22:54:57 2014
> > @@ -61,7 +61,7 @@ import org.apache.commons.lang3.StringUt
> >   *
> >   * This tokenizer has the following properties and options:
> >   *
> > - * <table>
> > + * <table summary="Tokenizer Properties">
> >   *  <tr>
> >   *   <th>Property</th><th>Type</th><th>Default</th>
> >   *  </tr>
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/WordUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/WordUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/WordUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/WordUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -54,10 +54,10 @@ public class WordUtils {
> >       * <p>Leading spaces on a new line are stripped.
> >       * Trailing spaces are not stripped.</p>
> >       *
> > -     * <table border="1">
> > +     * <table border="1" summary="Wrap Results">
> >       *  <tr>
> >       *   <th>input</th>
> > -     *   <th>wrapLenght</th>
> > +     *   <th>wrapLength</th>
> >       *   <th>result</th>
> >       *  </tr>
> >       *  <tr>
> > @@ -103,7 +103,7 @@ public class WordUtils {
> >       * <p>Leading spaces on a new line are stripped.
> >       * Trailing spaces are not stripped.</p>
> >       *
> > -     * <table border="1">
> > +     * <table border="1" summary="Wrap Results">
> >       *  <tr>
> >       *   <th>input</th>
> >       *   <th>wrapLenght</th>
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/translate/NumericEntityUnescaper.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/translate/NumericEntityUnescaper.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/translate/NumericEntityUnescaper.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/text/translate/NumericEntityUnescaper.java
> Mon Mar 31 22:54:57 2014
> > @@ -22,7 +22,7 @@ import java.util.Arrays;
> >  import java.util.EnumSet;
> >
> >  /**
> > - * Translate XML numeric entities of the form &#[xX]?\d+;? to
> > + * Translate XML numeric entities of the form &amp;#[xX]?\d+;? to
> >   * the specific codepoint.
> >   *
> >   * Note that the semi-colon is optional.
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DateUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DateUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DateUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DateUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -684,13 +684,13 @@ public class DateUtils {
> >       * saving time, rounding to Calendar.HOUR_OF_DAY will behave as
> follows.
> >       * Suppose daylight saving time begins at 02:00 on March 30.
> Rounding a
> >       * date that crosses this time would produce the following values:
> > +     * </p>
> >       * <ul>
> >       * <li>March 30, 2003 01:10 rounds to March 30, 2003 01:00</li>
> >       * <li>March 30, 2003 01:40 rounds to March 30, 2003 03:00</li>
> >       * <li>March 30, 2003 02:10 rounds to March 30, 2003 03:00</li>
> >       * <li>March 30, 2003 02:40 rounds to March 30, 2003 04:00</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param date  the date to work with, not null
> >       * @param field  the field from {@code Calendar} or {@code
> SEMI_MONTH}
> > @@ -720,13 +720,13 @@ public class DateUtils {
> >       * saving time, rounding to Calendar.HOUR_OF_DAY will behave as
> follows.
> >       * Suppose daylight saving time begins at 02:00 on March 30.
> Rounding a
> >       * date that crosses this time would produce the following values:
> > +     * </p>
> >       * <ul>
> >       * <li>March 30, 2003 01:10 rounds to March 30, 2003 01:00</li>
> >       * <li>March 30, 2003 01:40 rounds to March 30, 2003 03:00</li>
> >       * <li>March 30, 2003 02:10 rounds to March 30, 2003 03:00</li>
> >       * <li>March 30, 2003 02:40 rounds to March 30, 2003 04:00</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param date  the date to work with, not null
> >       * @param field  the field from {@code Calendar} or
> <code>SEMI_MONTH</code>
> > @@ -756,13 +756,13 @@ public class DateUtils {
> >       * saving time, rounding to Calendar.HOUR_OF_DAY will behave as
> follows.
> >       * Suppose daylight saving time begins at 02:00 on March 30.
> Rounding a
> >       * date that crosses this time would produce the following values:
> > +     * </p>
> >       * <ul>
> >       * <li>March 30, 2003 01:10 rounds to March 30, 2003 01:00</li>
> >       * <li>March 30, 2003 01:40 rounds to March 30, 2003 03:00</li>
> >       * <li>March 30, 2003 02:10 rounds to March 30, 2003 03:00</li>
> >       * <li>March 30, 2003 02:40 rounds to March 30, 2003 04:00</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param date  the date to work with, either {@code Date} or
> {@code Calendar}, not null
> >       * @param field  the field from {@code Calendar} or
> <code>SEMI_MONTH</code>
> > @@ -1271,7 +1271,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a SECOND field will return
> 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 1, 2008 7:15:10.538 with Calendar.SECOND as
> fragment will return 538</li>
> >       *  <li>January 6, 2008 7:15:10.538 with Calendar.SECOND as
> fragment will return 538</li>
> > @@ -1279,7 +1278,6 @@ public class DateUtils {
> >       *  <li>January 16, 2008 7:15:10.538 with Calendar.MILLISECOND as
> fragment will return 0
> >       *   (a millisecond cannot be split in milliseconds)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param date the date to work with, not null
> >       * @param fragment the {@code Calendar} field part of date to
> calculate
> > @@ -1308,7 +1306,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a SECOND field will return
> 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 1, 2008 7:15:10.538 with Calendar.MINUTE as
> fragment will return 10
> >       *   (equivalent to deprecated date.getSeconds())</li>
> > @@ -1319,7 +1316,6 @@ public class DateUtils {
> >       *  <li>January 16, 2008 7:15:10.538 with Calendar.MILLISECOND as
> fragment will return 0
> >       *   (a millisecond cannot be split in seconds)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param date the date to work with, not null
> >       * @param fragment the {@code Calendar} field part of date to
> calculate
> > @@ -1348,7 +1344,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a MINUTE field will return
> 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 1, 2008 7:15:10.538 with Calendar.HOUR_OF_DAY as
> fragment will return 15
> >       *   (equivalent to deprecated date.getMinutes())</li>
> > @@ -1359,7 +1354,6 @@ public class DateUtils {
> >       *  <li>January 16, 2008 7:15:10.538 with Calendar.MILLISECOND as
> fragment will return 0
> >       *   (a millisecond cannot be split in minutes)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param date the date to work with, not null
> >       * @param fragment the {@code Calendar} field part of date to
> calculate
> > @@ -1388,7 +1382,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a HOUR field will return 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 1, 2008 7:15:10.538 with Calendar.DAY_OF_YEAR as
> fragment will return 7
> >       *   (equivalent to deprecated date.getHours())</li>
> > @@ -1399,7 +1392,6 @@ public class DateUtils {
> >       *  <li>January 16, 2008 7:15:10.538 with Calendar.MILLISECOND as
> fragment will return 0
> >       *   (a millisecond cannot be split in hours)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param date the date to work with, not null
> >       * @param fragment the {@code Calendar} field part of date to
> calculate
> > @@ -1428,7 +1420,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a DAY field will return 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 28, 2008 with Calendar.MONTH as fragment will
> return 28
> >       *   (equivalent to deprecated date.getDay())</li>
> > @@ -1439,7 +1430,6 @@ public class DateUtils {
> >       *  <li>January 28, 2008 with Calendar.MILLISECOND as fragment will
> return 0
> >       *   (a millisecond cannot be split in days)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param date the date to work with, not null
> >       * @param fragment the {@code Calendar} field part of date to
> calculate
> > @@ -1468,7 +1458,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a MILLISECOND field will return
> 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 1, 2008 7:15:10.538 with Calendar.SECOND as
> fragment will return 538
> >       *   (equivalent to calendar.get(Calendar.MILLISECOND))</li>
> > @@ -1479,7 +1468,6 @@ public class DateUtils {
> >       *  <li>January 16, 2008 7:15:10.538 with Calendar.MILLISECOND as
> fragment will return 0
> >       *   (a millisecond cannot be split in milliseconds)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param calendar the calendar to work with, not null
> >       * @param fragment the {@code Calendar} field part of calendar to
> calculate
> > @@ -1507,7 +1495,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a SECOND field will return
> 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 1, 2008 7:15:10.538 with Calendar.MINUTE as
> fragment will return 10
> >       *   (equivalent to calendar.get(Calendar.SECOND))</li>
> > @@ -1518,7 +1505,6 @@ public class DateUtils {
> >       *  <li>January 16, 2008 7:15:10.538 with Calendar.MILLISECOND as
> fragment will return 0
> >       *   (a millisecond cannot be split in seconds)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param calendar the calendar to work with, not null
> >       * @param fragment the {@code Calendar} field part of calendar to
> calculate
> > @@ -1547,7 +1533,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a MINUTE field will return
> 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 1, 2008 7:15:10.538 with Calendar.HOUR_OF_DAY as
> fragment will return 15
> >       *   (equivalent to calendar.get(Calendar.MINUTES))</li>
> > @@ -1558,7 +1543,6 @@ public class DateUtils {
> >       *  <li>January 16, 2008 7:15:10.538 with Calendar.MILLISECOND as
> fragment will return 0
> >       *   (a millisecond cannot be split in minutes)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param calendar the calendar to work with, not null
> >       * @param fragment the {@code Calendar} field part of calendar to
> calculate
> > @@ -1587,7 +1571,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a HOUR field will return 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 1, 2008 7:15:10.538 with Calendar.DAY_OF_YEAR as
> fragment will return 7
> >       *   (equivalent to calendar.get(Calendar.HOUR_OF_DAY))</li>
> > @@ -1598,7 +1581,6 @@ public class DateUtils {
> >       *  <li>January 16, 2008 7:15:10.538 with Calendar.MILLISECOND as
> fragment will return 0
> >       *   (a millisecond cannot be split in hours)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param calendar the calendar to work with, not null
> >       * @param fragment the {@code Calendar} field part of calendar to
> calculate
> > @@ -1627,7 +1609,6 @@ public class DateUtils {
> >       * Calendar.MINUTE, Calendar.SECOND and Calendar.MILLISECOND
> >       * A fragment less than or equal to a DAY field will return 0.</p>
> >       *
> > -     * <p>
> >       * <ul>
> >       *  <li>January 28, 2008 with Calendar.MONTH as fragment will
> return 28
> >       *   (equivalent to calendar.get(Calendar.DAY_OF_MONTH))</li>
> > @@ -1640,7 +1621,6 @@ public class DateUtils {
> >       *  <li>January 28, 2008 with Calendar.MILLISECOND as fragment will
> return 0
> >       *   (a millisecond cannot be split in days)</li>
> >       * </ul>
> > -     * </p>
> >       *
> >       * @param calendar the calendar to work with, not null
> >       * @param fragment the {@code Calendar} field part of calendar to
> calculate
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/DurationFormatUtils.java
> Mon Mar 31 22:54:57 2014
> > @@ -27,7 +27,7 @@ import org.apache.commons.lang3.StringUt
> >  /**
> >   * <p>Duration formatting utilities and constants. The following table
> describes the tokens
> >   * used in the pattern language for formatting. </p>
> > - * <table border="1">
> > + * <table border="1" summary="Pattern Tokens">
> >   *  <tr><th>character</th><th>duration element</th></tr>
> >   *  <tr><td>y</td><td>years</td></tr>
> >   *  <tr><td>M</td><td>months</td></tr>
> > @@ -40,7 +40,7 @@ import org.apache.commons.lang3.StringUt
> >   * </table>
> >   *
> >   * <b>Note: It's not currently possible to include a single-quote in a
> format.</b>
> > - * <br/>
> > + * <br>
> >   * Token values are printed using decimal digits.
> >   * A token character can be repeated to ensure that the field occupies
> a certain minimum
> >   * size. Values will be left-padded with 0 unless padding is disabled
> in the method invocation.
> > @@ -252,9 +252,9 @@ public class DurationFormatUtils {
> >       * <p>When calculating the difference between months/days, it
> chooses to
> >       * calculate months first. So when working out the number of months
> and
> >       * days between January 15th and March 10th, it choose 1 month and
> > -     * 23 days gained by choosing January->February = 1 month and then
> > +     * 23 days gained by choosing January-&gt;February = 1 month and
> then
> >       * calculating days forwards, and not the 1 month and 26 days
> gained by
> > -     * choosing March -> February = 1 month and then calculating days
> > +     * choosing March -&gt; February = 1 month and then calculating days
> >       * backwards. </p>
> >       *
> >       * <p>For more control, the <a href="http://joda-time.sf.net/
> ">Joda-Time</a>
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/StopWatch.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/StopWatch.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/StopWatch.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/StopWatch.java
> Mon Mar 31 22:54:57 2014
> > @@ -44,9 +44,9 @@ package org.apache.commons.lang3.time;
> >   * </p>
> >   *
> >   * <p>
> > - * 1. split(), suspend(), or stop() cannot be invoked twice<br />
> > - * 2. unsplit() may only be called if the watch has been split()<br />
> > - * 3. resume() may only be called if the watch has been suspend()<br />
> > + * 1. split(), suspend(), or stop() cannot be invoked twice<br>
> > + * 2. unsplit() may only be called if the watch has been split()<br>
> > + * 3. resume() may only be called if the watch has been suspend()<br>
> >   * 4. start() cannot be called twice without calling reset()
> >   * </p>
> >   *
> >
> > Modified:
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/package-info.java
> > URL:
> http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/package-info.java?rev=1583482&r1=1583481&r2=1583482&view=diff
> >
> ==============================================================================
> > ---
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/package-info.java
> (original)
> > +++
> commons/proper/lang/trunk/src/main/java/org/apache/commons/lang3/time/package-info.java
> Mon Mar 31 22:54:57 2014
> > @@ -18,7 +18,7 @@
> >   * <p>Provides classes and methods to work with dates and durations.
> >   * These classes are immutable (and therefore thread-safe) apart from
> {@link org.apache.commons.lang3.time.StopWatch}.</p>
> >   *
> > - * The time package contains some basic utilities for manipulating time
> (a delorean, police box and grandfather clock?).
> > + * <p>The time package contains some basic utilities for manipulating
> time (a delorean, police box and grandfather clock?).
> >   * These include a {@link org.apache.commons.lang3.time.StopWatch} for
> simple performance measurements and an optimised {@link
> org.apache.commons.lang3.time.FastDateFormat} class.</p>
> >   *
> >   * <p>New in Lang 2.1 is the {@link
> org.apache.commons.lang3.time.DurationFormatUtils} class, which provides
> various methods for formatting durations.</p>
> >
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message