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 2396</a>,
* Appendix 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.
