8016217: More javadoc warnings

Alan Bateman Alan.Bateman at oracle.com
Mon Jun 10 17:56:29 UTC 2013


On 10/06/2013 18:29, Iris Clark wrote:
> Hi, Alan.
>
> The changes look good to me.
>
> One thing caught my eye.  In java.util.Calendar, around lines 2681 and later around 2702 you removed the "<blockquote>"
>
> --- old/src/share/classes/java/util/Calendar.java	2013-06-10 10:37:52.585879060 +0100
> +++ new/src/share/classes/java/util/Calendar.java	2013-06-10 10:37:52.297879063 +0100
> @@ -2681,9 +2681,9 @@
>        * Returns whether this<code>Calendar</code>  represents a time
>        * before the time represented by the specified
>        *<code>Object</code>. This method is equivalent to:
> -     *<pre><blockquote>
> +     *<pre>{@code
>        *         compareTo(when)<  0
> -     *</blockquote></pre>
> +     * }</pre>
>        * if and only if<code>when</code>  is a<code>Calendar</code>
>        * instance. Otherwise, the method returns<code>false</code>.
>        *
>
> But you left them in java.io.Console, javax.security.sasl.SasClient, etc.
>
The <blockquote> isn't really needed here (and in several other places). 
I did experimental with removing a few of them, I guess I just didn't 
revert these two (but it's completely harmless). Thanks for paying close 
attention.

-Alan



More information about the core-libs-dev mailing list