RFR doclint issues in java.net

[Lance Andersen - Oracle]

Good to go
On Jul 25, 2013, at 6:00 AM, Chris Hegarty wrote:

> This is a request for review for some doclint warnings in the java.net package. Trivially, the list type should be left to the CSS.
> 
> Note: with these changes there are still warnings for two DatagramPacket constructors that are missing @throws for SocketException. I do not see any reason that these constructors need to throw SE, and I will file a separate bug to follow up.
> 
> diff -r fd1b5adcfdf0 src/share/classes/java/net/URI.java
> --- a/src/share/classes/java/net/URI.java       Wed Jul 24 22:52:01 2013 +0100
> +++ b/src/share/classes/java/net/URI.java       Thu Jul 25 10:56:25 2013 +0100
> @@ -530,7 +530,7 @@ public final class URI
>      * href="http://www.ietf.org/rfc/rfc2396.txt">RFC&nbsp;2396</a>,
>      * Appendix&nbsp;A, <b><i>except for the following deviations:</i></b> </p>
>      *
> -     * <ul type=disc>
> +     * <ul>
>      *
>      *   <li><p> An empty authority component is permitted as long as it is
>      *   followed by a non-empty path, a query component, or a fragment
> @@ -993,7 +993,7 @@ public final class URI
>      *   <li><p> Otherwise the new URI's authority component is copied from
>      *   this URI, and its path is computed as follows: </p>
>      *
> -     *   <ol type=a>
> +     *   <ol>
>      *
>      *     <li><p> If the given URI's path is absolute then the new URI's path
>      *     is taken from the given URI. </p></li>
> @@ -1241,7 +1241,7 @@ public final class URI
>      * <p> The host component of a URI, if defined, will have one of the
>      * following forms: </p>
>      *
> -     * <ul type=disc>
> +     * <ul>
>      *
>      *   <li><p> A domain name consisting of one or more <i>labels</i>
>      *   separated by period characters (<tt>'.'</tt>), optionally followed by
> @@ -1495,7 +1495,7 @@ public final class URI
>      *
>      * <p> The ordering of URIs is defined as follows: </p>
>      *
> -     * <ul type=disc>
> +     * <ul>
>      *
>      *   <li><p> Two URIs with different schemes are ordered according the
>      *   ordering of their schemes, without regard to case. </p></li>
> @@ -1513,7 +1513,7 @@ public final class URI
>      *   <li><p> Two hierarchical URIs with identical schemes are ordered
>      *   according to the ordering of their authority components: </p>
>      *
> -     *   <ul type=disc>
> +     *   <ul>
>      *
>      *     <li><p> If both authority components are server-based then the URIs
>      *     are ordered according to their user-information components; if these
> 
> 
> -Chris.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: oracle_sig_logo.gif
Type: image/gif
Size: 658 bytes
Desc: not available
Url : http://mail.openjdk.java.net/pipermail/net-dev/attachments/20130725/213349ed/oracle_sig_logo.gif 
-------------- next part --------------

Lance Andersen| Principal Member of Technical Staff | +1.781.442.2037
Oracle Java Engineering 
1 Network Drive 
Burlington, MA 01803
Lance.Andersen at oracle.com