# HG changeset patch # User jjg # Date 1502744050 25200 # Node ID 51d10b05c78e19acd22f53aa0d64072ec755bfc4 # Parent 5fa789776f7dca9dc46230f857d275004f4ed8b6 8186156: Fix a11y and HTML issues in java.net and javax.net packages Reviewed-by: lancea, mchung diff -r 5fa789776f7d -r 51d10b05c78e jdk/src/java.base/share/classes/java/net/InetAddress.java --- a/jdk/src/java.base/share/classes/java/net/InetAddress.java Fri Jul 28 14:06:28 2017 +0200 +++ b/jdk/src/java.base/share/classes/java/net/InetAddress.java Mon Aug 14 13:54:10 2017 -0700 @@ -72,10 +72,13 @@ * *
+ *
* **
+ * + * + *+ * * - * Address Type Description unicast + *- * unicast *An identifier for a single interface. A packet sent to * a unicast address is delivered to the interface identified by * that address. @@ -94,12 +97,12 @@ * IP address loops around and becomes IP input on the local * host. This address is often used when testing a * client. multicast + ** - * multicast *An identifier for a set of interfaces (typically belonging * to different nodes). A packet sent to a multicast address is * delivered to all interfaces identified by that address. IP address scope
* @@ -163,8 +166,7 @@ *Two Java security properties control the TTL values used for * positive and negative host name resolution caching: * - *
- ** * @author Chris Warth * @see java.net.InetAddress#getByAddress(byte[]) diff -r 5fa789776f7d -r 51d10b05c78e jdk/src/java.base/share/classes/java/net/URI.java --- a/jdk/src/java.base/share/classes/java/net/URI.java Fri Jul 28 14:06:28 2017 +0200 +++ b/jdk/src/java.base/share/classes/java/net/URI.java Mon Aug 14 13:54:10 2017 -0700 @@ -132,23 +132,23 @@ * *+ *
*
- *- networkaddress.cache.ttl
*- Indicates the caching policy for successful name lookups from * the name service. The value is specified as an integer to indicate @@ -183,7 +185,6 @@ * A value of -1 indicates "cache forever". *
*All told, then, a URI instance has the following nine components: * - *
+ *
* * In a given instance any particular component is either undefined or * defined with a distinct value. Undefined string components are @@ -253,32 +253,35 @@ * which are taken from that specification, are used below to describe these * constraints: * - **
+ * * - *+ * Component Type * - * - * Component Type - * scheme {@code String} - * scheme-specific-part {@code String} - * authority {@code String} - * user-info {@code String} - * host {@code String} - * port {@code int} - * path {@code String} - * query {@code String} + * + * fragment {@code String} + * scheme {@code String} + * scheme-specific-part {@code String} + * authority {@code String} + * user-info {@code String} + * host {@code String} + * port {@code int} + * path {@code String} + * query {@code String} * - * fragment {@code String} + *
* **
+ * - * - *+ * alpha + * + *+ * + * Category Description - * alpha *The US-ASCII alphabetic characters, * {@code 'A'} through {@code 'Z'} * and {@code 'a'} through {@code 'z'} digit + *- * digit *The US-ASCII decimal digit characters, * {@code '0'} through {@code '9'} alphanum + *- * alphanum *All alpha and digit characters unreserved + *- * unreserved *All alphanum characters together with those in the string * {@code "_-!.~'()*"} punct + *- * punct *The characters in the string {@code ",;:$&+="} reserved + *- * reserved *All punct characters together with those in the string * {@code "?/[]@"} escaped + *- * escaped *Escaped octets, that is, triplets consisting of the percent * character ({@code '%'}) followed by two hexadecimal digits * ({@code '0'}-{@code '9'}, {@code 'A'}-{@code 'F'}, and * {@code 'a'}-{@code 'f'}) other + ** - * other *The Unicode characters that are not in the US-ASCII character set, * are not control characters (according to the {@link * java.lang.Character#isISOControl(char) Character.isISOControl} @@ -287,7 +290,7 @@ * method) (Deviation from RFC 2396, which is * limited to US-ASCII) The set of all legal URI characters consists of * the unreserved, reserved, escaped, and other diff -r 5fa789776f7d -r 51d10b05c78e jdk/src/java.base/share/classes/java/net/URLConnection.java --- a/jdk/src/java.base/share/classes/java/net/URLConnection.java Fri Jul 28 14:06:28 2017 +0200 +++ b/jdk/src/java.base/share/classes/java/net/URLConnection.java Mon Aug 14 13:54:10 2017 -0700 @@ -51,31 +51,16 @@ * The abstract class {@code URLConnection} is the superclass * of all classes that represent a communications link between the * application and a URL. Instances of this class can be used both to - * read from and to write to the resource referenced by the URL. In - * general, creating a connection to a URL is a multistep process: + * read from and to write to the resource referenced by the URL. * - *
- * + *- *
- * ----------------------------> - * - * - *- * - * - * {@code openConnection()} - *{@code connect()} - * - * Manipulate parameters that affect the connection to the remote - * resource. - *Interact with the resource; query header fields and - * contents.
time+ * In general, creating a connection to a URL is a multistep process: *
*
diff -r 5fa789776f7d -r 51d10b05c78e jdk/src/java.base/share/classes/java/net/URLPermission.java --- a/jdk/src/java.base/share/classes/java/net/URLPermission.java Fri Jul 28 14:06:28 2017 +0200 +++ b/jdk/src/java.base/share/classes/java/net/URLPermission.java Mon Aug 14 13:54:10 2017 -0700 @@ -72,22 +72,22 @@ * separated by '/' characters. path may also be empty. The path is specified * in a similar way to the path in {@link java.io.FilePermission}. There are * three different ways as the following examples show: - *- The connection object is created by invoking the - * {@code openConnection} method on a URL. + * {@link URL#openConnection() openConnection} method on a URL. *
- The setup parameters and general request properties are manipulated. *
- The actual connection to the remote object is made, using the - * {@code connect} method. + * {@link #connect() connect} method. *
- The remote object becomes available. The header fields and the contents * of the remote object can be accessed. *
+ *
*
URL Examples * - *+ * Example url Description * - * - * Example url Description + * http://www.oracle.com/a/b/c.html + *- * http://www.oracle.com/a/b/c.html *A url which identifies a specific (single) resource *http://www.oracle.com/a/b/* + *- * http://www.oracle.com/a/b/* *The '*' character refers to all resources in the same "directory" - in * other words all resources with the same number of path components, and * which only differ in the final path component, represented by the '*'. * *http://www.oracle.com/a/b/- + *http://www.oracle.com/a/b/- *The '-' character refers to all resources recursively below the * preceding path (eg. http://www.oracle.com/a/b/c/d/e.html matches this * example). @@ -114,11 +114,12 @@ * methods and permitted request headers of the permission (respectively). The two lists * are separated by a colon ':' character and elements of each list are comma separated. * Some examples are: - * - * "POST,GET,DELETE" - * "GET:X-Foo-Request,X-Bar-Request" - * "POST,GET:Header1,Header2" - *+ *+ *
+ *- "POST,GET,DELETE" + *
- "GET:X-Foo-Request,X-Bar-Request" + *
- "POST,GET:Header1,Header2" + *
* The first example specifies the methods: POST, GET and DELETE, but no request headers. * The second example specifies one request method and two headers. The third * example specifies two request methods, and two headers. @@ -253,16 +254,16 @@ *
*
*/ diff -r 5fa789776f7d -r 51d10b05c78e jdk/src/java.base/share/classes/java/net/doc-files/net-properties.html --- a/jdk/src/java.base/share/classes/java/net/doc-files/net-properties.html Fri Jul 28 14:06:28 2017 +0200 +++ b/jdk/src/java.base/share/classes/java/net/doc-files/net-properties.html Mon Aug 14 13:54:10 2017 -0700 @@ -23,7 +23,7 @@ or visit www.oracle.com if you need additional information or have any questions. --> - +Examples of Path Matching * - *+ * this's path p's path match * - * - * this's path p's path match - * /a/b /a/b yes - * /a/b/* /a/b/c yes - * /a/b/* /a/b/c/d no - * /a/b/- /a/b/c/d yes - * /a/b/- /a/b/c/d/e yes - * /a/b/- /a/b/c/* yes + * + * /a/b/* /a/b/c/- no + * /a/b /a/b yes + * /a/b/* /a/b/c yes + * /a/b/c/d no + * /a/b/c/- no + * /a/b/- /a/b/c/d yes + * /a/b/c/d/e yes * * /a/b/c/* yes Networking Properties @@ -35,7 +35,7 @@ java.net package. Some are checked only once at startup of the VM, and therefore are best set using the -D option of the java command, while others have a more dynamic nature and can also be changed using -the System.setProperty() API. +the System.setProperty() API. The purpose of this document is to list and detail all of these properties.If there is no special note, a property value is checked every time it is used.
diff -r 5fa789776f7d -r 51d10b05c78e jdk/src/java.base/share/classes/javax/net/ssl/SSLEngine.java --- a/jdk/src/java.base/share/classes/javax/net/ssl/SSLEngine.java Fri Jul 28 14:06:28 2017 +0200 +++ b/jdk/src/java.base/share/classes/javax/net/ssl/SSLEngine.java Mon Aug 14 13:54:10 2017 -0700 @@ -1292,7 +1292,7 @@ * href="http://www.ietf.org/rfc/rfc7301.txt"> RFC 7301 , the * Application-Layer Protocol Negotiation (ALPN), can negotiate * application-level values between peers. - *+ * * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. @@ -1317,7 +1317,7 @@ * Like {@link #getHandshakeSession()}, * a connection may be in the middle of a handshake. The * application protocol may or may not yet be available. - *
+ * * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. diff -r 5fa789776f7d -r 51d10b05c78e jdk/src/java.base/share/classes/javax/net/ssl/SSLParameters.java --- a/jdk/src/java.base/share/classes/javax/net/ssl/SSLParameters.java Fri Jul 28 14:06:28 2017 +0200 +++ b/jdk/src/java.base/share/classes/javax/net/ssl/SSLParameters.java Mon Aug 14 13:54:10 2017 -0700 @@ -646,7 +646,7 @@ * requested by the peer, the underlying protocol will determine what * action to take. (For example, ALPN will send a * {@code "no_application_protocol"} alert and terminate the connection.) - *
+ * * @implSpec * This method will make a copy of the {@code protocols} array. * diff -r 5fa789776f7d -r 51d10b05c78e jdk/src/java.base/share/classes/javax/net/ssl/SSLSocket.java --- a/jdk/src/java.base/share/classes/javax/net/ssl/SSLSocket.java Fri Jul 28 14:06:28 2017 +0200 +++ b/jdk/src/java.base/share/classes/javax/net/ssl/SSLSocket.java Mon Aug 14 13:54:10 2017 -0700 @@ -702,7 +702,7 @@ * href="http://www.ietf.org/rfc/rfc7301.txt"> RFC 7301 , the * Application-Layer Protocol Negotiation (ALPN), can negotiate * application-level values between peers. - *
+ * * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action. @@ -727,7 +727,7 @@ * Like {@link #getHandshakeSession()}, * a connection may be in the middle of a handshake. The * application protocol may or may not yet be available. - *
+ * * @implSpec * The implementation in this class throws * {@code UnsupportedOperationException} and performs no other action.