char | | C
+ *
+ * Element types and encodings
+ *
+ * Element Type | Encoding
+ * |
+ *
+ * boolean | Z
+ * | byte | B
+ * | char | C
* | class or interface
- * | | Lclassname;
- * | double | | D
- * | float | | F
- * | int | | I
- * | long | | J
- * | short | | S
+ * | Lclassname;
+ * | double | D
+ * | float | F
+ * | int | I
+ * | long | J
+ * | short | S
+ * |
*
*
* The class or interface name classname is the binary name of
--- old/src/java.base/share/classes/java/lang/Double.java 2017-05-03 14:00:26.012514053 -0700
+++ new/src/java.base/share/classes/java/lang/Double.java 2017-05-03 14:00:25.888508690 -0700
@@ -255,9 +255,12 @@
*
*
*
- *
+ *
* Examples
+ *
* Floating-point Value | Hexadecimal String |
+ *
+ *
* {@code 1.0} | {@code 0x1.0p0} |
* {@code -1.0} | {@code -0x1.0p0} |
* {@code 2.0} | {@code 0x1.0p1} |
@@ -272,6 +275,7 @@
* {@code 0x0.fffffffffffffp-1022} |
* {@code Double.MIN_VALUE} |
* {@code 0x0.0000000000001p-1022} |
+ *
*
* @param d the {@code double} to be converted.
* @return a hex string representation of the argument.
--- old/src/java.base/share/classes/java/lang/Float.java 2017-05-03 14:00:26.484534469 -0700
+++ new/src/java.base/share/classes/java/lang/Float.java 2017-05-03 14:00:26.348528586 -0700
@@ -256,9 +256,12 @@
*
*
*
- *
+ *
* Examples
+ *
* Floating-point Value | Hexadecimal String |
+ *
+ *
* {@code 1.0} | {@code 0x1.0p0} |
* {@code -1.0} | {@code -0x1.0p0} |
* {@code 2.0} | {@code 0x1.0p1} |
@@ -273,6 +276,7 @@
* {@code 0x0.fffffep-126} |
* {@code Float.MIN_VALUE} |
* {@code 0x0.000002p-126} |
+ *
*
* @param f the {@code float} to be converted.
* @return a hex string representation of the argument.
--- old/src/java.base/share/classes/java/lang/RuntimePermission.java 2017-05-03 14:00:26.848550212 -0700
+++ new/src/java.base/share/classes/java/lang/RuntimePermission.java 2017-05-03 14:00:26.744545715 -0700
@@ -43,13 +43,17 @@
* target names, and for each provides a description of what the permission
* allows and a discussion of the risks of granting code the permission.
*
- *
+ *
+ * permission target name,
+ * what the target allows, and associated risks
+ *
*
* Permission Target Name |
* What the Permission Allows |
* Risks of Allowing this Permission |
*
+ *
+ *
*
*
* createClassLoader |
@@ -383,6 +387,7 @@
* {@linkplain ModuleFinder#ofSystem system modules} in the runtime image.
*
*
+ *
*
*
* @implNote
--- old/src/java.base/share/classes/java/lang/String.java 2017-05-03 14:00:27.252567687 -0700
+++ new/src/java.base/share/classes/java/lang/String.java 2017-05-03 14:00:27.148563189 -0700
@@ -2203,12 +2203,16 @@
* The string {@code "boo:and:foo"}, for example, yields the
* following results with these parameters:
*
- *
+ *
+ * Split example showing regex, limit, and result
+ *
*
* Regex |
* Limit |
* Result |
*
+ *
+ *
* : |
* 2 |
* {@code { "boo", "and:foo" }} |
@@ -2227,6 +2231,7 @@
* o |
* 0 |
* {@code { "b", "", ":and:f" }} |
+ *
*
*
* An invocation of this method of the form
@@ -2326,15 +2331,20 @@
* The string {@code "boo:and:foo"}, for example, yields the following
* results with these expressions:
*
- *
+ *
+ * Split examples showing regex and result
+ *
*
* Regex |
* Result |
*
+ *
+ *
* : |
* {@code { "boo", "and", "foo" }} |
* o |
* {@code { "b", "", ":and:f" }} |
+ *
*
*
*
@@ -2445,13 +2455,17 @@
* {@code String} may be a different length than the original {@code String}.
*
* Examples of lowercase mappings are in the following table:
- *
+ *
+ * Lowercase mapping examples showing language code of locale, upper case, lower case, and description
+ *
*
* Language Code of Locale |
* Upper Case |
* Lower Case |
* Description |
*
+ *
+ *
*
* tr (Turkish) |
* \u0130 |
@@ -2480,6 +2494,7 @@
*
* lowercased all chars in String |
*
+ *
*
*
* @param locale use the case transformation rules for this locale
@@ -2526,13 +2541,17 @@
*
* Examples of locale-sensitive and 1:M case mappings are in the following table.
*
- *
+ *
+ * Examples of locale-sensitive and 1:M case mappings. Shows Language code of locale, lower case, upper case, and description.
+ *
*
* Language Code of Locale |
* Lower Case |
* Upper Case |
* Description |
*
+ *
+ *
*
* tr (Turkish) |
* \u0069 |
@@ -2557,6 +2576,7 @@
* FAHRVERGNÜGEN |
* |
*
+ *
*
* @param locale use the case transformation rules for this locale
* @return the {@code String}, converted to uppercase.
--- old/src/java.base/share/classes/java/lang/System.java 2017-05-03 14:00:27.680586200 -0700
+++ new/src/java.base/share/classes/java/lang/System.java 2017-05-03 14:00:27.584582047 -0700
@@ -576,9 +576,13 @@
* system properties, a set of system properties is first created and
* initialized. This set of system properties always includes values
* for the following keys:
- *
+ *
+ * Shows property keys and associated values
+ *
* Key |
* Description of Associated Value |
+ *
+ *
* java.version |
* Java Runtime Environment version which may be interpreted
* as a {@link Runtime.Version} |
@@ -637,6 +641,7 @@
* User's home directory |
* user.dir |
* User's current working directory |
+ *
*
*
* Multiple paths in a system property value are separated by the path
@@ -648,9 +653,13 @@
*
* @implNote In addition to the standard system properties, the system
* properties may include the following keys:
- *
+ *
+ * Shows property keys and associated values
+ *
* Key |
* Description of Associated Value |
+ *
+ *
* {@code jdk.module.path} |
* The application module path |
* {@code jdk.module.upgrade.path} |
@@ -659,6 +668,7 @@
* The module name of the initial/main module |
* {@code jdk.module.main.class} |
* The main class name of the initial module |
+ *
*
*
* @return the system properties
--- old/src/java.base/share/classes/java/lang/invoke/LambdaMetafactory.java 2017-05-03 14:00:28.124605404 -0700
+++ new/src/java.base/share/classes/java/lang/invoke/LambdaMetafactory.java 2017-05-03 14:00:27.992599695 -0700
@@ -149,8 +149,12 @@
* capture argument (corresponding to the receiver) must be non-null.
*
* A type Q is considered adaptable to S as follows:
- *
+ *
+ * adaptable types
+ *
* Q | S | Link-time checks | Invocation-time checks |
+ *
+ *
*
* Primitive | Primitive |
* Q can be converted to S via a primitive widening conversion |
@@ -176,6 +180,7 @@
* for return types: none
* Cast from Q to S |
*
+ *
*
*
* @apiNote These linkage methods are designed to support the evaluation
--- old/src/java.base/share/classes/java/lang/invoke/MethodHandleInfo.java 2017-05-03 14:00:28.524622705 -0700
+++ new/src/java.base/share/classes/java/lang/invoke/MethodHandleInfo.java 2017-05-03 14:00:28.428618553 -0700
@@ -81,8 +81,12 @@
* The Lookup Factory Methods
* correspond to all major use cases for methods, constructors, and fields.
* These use cases may be distinguished using small integers as follows:
- *
+ *
+ * reference kinds
+ *
* reference kind | descriptive name | scope | member | behavior |
+ *
+ *
*
* {@code 1} | {@code REF_getField} | {@code class} |
* {@code FT f;} | {@code (T) this.f;} |
@@ -119,6 +123,7 @@
* {@code 9} | {@code REF_invokeInterface} | {@code interface} |
* {@code T m(A*);} | {@code (T) this.m(arg*);} |
*
+ *
*
* @since 1.8
*/
--- old/src/java.base/share/classes/java/lang/invoke/MethodHandles.java 2017-05-03 14:00:28.916639662 -0700
+++ new/src/java.base/share/classes/java/lang/invoke/MethodHandles.java 2017-05-03 14:00:28.816635337 -0700
@@ -265,12 +265,16 @@
* (Bytecode behaviors are described in section 5.4.3.5 of the Java Virtual Machine Specification.)
* Here is a summary of the correspondence between these factory methods and
* the behavior of the resulting method handles:
- *
+ *
+ * lookup method behaviors
+ *
*
* lookup expression |
* member |
* bytecode behavior |
*
+ *
+ *
*
* {@link java.lang.invoke.MethodHandles.Lookup#findGetter lookup.findGetter(C.class,"f",FT.class)} |
* {@code FT f;} | {@code (T) this.f;} |
@@ -327,6 +331,7 @@
* {@link java.lang.invoke.MethodHandles.Lookup#findClass lookup.findClass("C")} |
* {@code class C { ... }} | {@code C.class;} |
*
+ *
*
*
* Here, the type {@code C} is the class or interface being searched for a member,
--- old/src/java.base/share/classes/java/lang/reflect/AnnotatedElement.java 2017-05-03 14:00:29.448662673 -0700
+++ new/src/java.base/share/classes/java/lang/reflect/AnnotatedElement.java 2017-05-03 14:00:29.312656791 -0700
@@ -105,10 +105,13 @@
* The table below summarizes which kind of annotation presence
* different methods in this interface examine.
*
- *
+ *
* Overview of kind of presence detected by different AnnotatedElement methods
+ *
* | Kind of Presence |
*
---|
Method | Directly Present | Indirectly Present | Present | Associated |
+ *
+ *
* {@code T} | {@link #getAnnotation(Class) getAnnotation(Class<T>)}
* | | | X | |
*
@@ -127,6 +130,7 @@
* {@code T[]} | {@link #getDeclaredAnnotationsByType(Class) getDeclaredAnnotationsByType(Class<T>)}
* | X | X | | |
*
+ *
*
*
* For an invocation of {@code get[Declared]AnnotationsByType( Class <
--- old/src/java.base/share/classes/java/lang/reflect/ReflectPermission.java 2017-05-03 14:00:29.904682397 -0700
+++ new/src/java.base/share/classes/java/lang/reflect/ReflectPermission.java 2017-05-03 14:00:29.772676686 -0700
@@ -32,12 +32,16 @@
* provides a summary description of what the permission allows,
* and discusses the risks of granting code the permission.
*
- *
+ *
+ * Table shows permission target name, what the permission allows, and associated risks
+ *
*
* Permission Target Name |
* What the Permission Allows |
* Risks of Allowing this Permission |
*
+ *
+ *
*
*
* suppressAccessChecks |
@@ -58,6 +62,7 @@
* help in its attempt to compromise security in the system.
*
*
+ *
*
*
* @see java.security.Permission
--- old/src/java.base/share/classes/java/math/BigDecimal.java 2017-05-03 14:00:30.300699526 -0700
+++ new/src/java.base/share/classes/java/math/BigDecimal.java 2017-05-03 14:00:30.168693815 -0700
@@ -120,15 +120,19 @@
* preferred scale for representing a result. The preferred
* scale for each operation is listed in the table below.
*
- *
+ *
* Preferred Scales for Results of Arithmetic Operations
*
+ *
* Operation | Preferred Scale of Result |
+ *
+ *
* Add | max(addend.scale(), augend.scale()) |
* Subtract | max(minuend.scale(), subtrahend.scale()) |
* Multiply | multiplier.scale() + multiplicand.scale() |
* Divide | dividend.scale() - divisor.scale() |
* Square root | radicand.scale()/2 |
+ *
*
*
* These scales are the ones used by the methods which return exact
--- old/src/java.base/share/classes/java/math/RoundingMode.java 2017-05-03 14:00:30.812721672 -0700
+++ new/src/java.base/share/classes/java/math/RoundingMode.java 2017-05-03 14:00:30.688716307 -0700
@@ -51,8 +51,9 @@
* proper {@code MathContext}. A summary table showing the results
* of these rounding operations for all rounding modes appears below.
*
- *
+ *
* Summary of Rounding Operations Under Different Rounding Modes
+ *
* | Result of rounding input to one digit with the given
* rounding mode |
*
---|
@@ -64,6 +65,8 @@
* {@code HALF_DOWN} |
* {@code HALF_EVEN} |
* {@code UNNECESSARY} |
+ *
+ *
*
* 5.5 | 6 | 5 | 6 | 5 | 6 | 5 | 6 | throw {@code ArithmeticException} |
* 2.5 | 3 | 2 | 3 | 2 | 3 | 2 | 2 | throw {@code ArithmeticException} |
@@ -75,7 +78,8 @@
* -1.6 | -2 | -1 | -1 | -2 | -2 | -2 | -2 | throw {@code ArithmeticException} |
* -2.5 | -3 | -2 | -2 | -3 | -3 | -2 | -2 | throw {@code ArithmeticException} |
* -5.5 | -6 | -5 | -5 | -6 | -6 | -5 | -6 | throw {@code ArithmeticException} |
- *
+ *
+ *
*
*
* This {@code enum} is intended to replace the integer-based
@@ -100,10 +104,13 @@
* value.
*
* Example:
- *
+ *
* Rounding mode UP Examples
+ *
*Input Number |
* Input rounded to one digit with {@code UP} rounding
+ * |
+ *
*5.5 | 6 |
* 2.5 | 3 |
* 1.6 | 2 |
@@ -114,6 +121,7 @@
* -1.6 | -2 |
* -2.5 | -3 |
* -5.5 | -6 |
+ *
*
*/
UP(BigDecimal.ROUND_UP),
@@ -124,10 +132,13 @@
* rounding mode never increases the magnitude of the calculated value.
*
*Example:
- *
+ *
* Rounding mode DOWN Examples
+ *
*Input Number |
* Input rounded to one digit with {@code DOWN} rounding
+ * |
+ *
*5.5 | 5 |
* 2.5 | 2 |
* 1.6 | 1 |
@@ -138,6 +149,7 @@
* -1.6 | -1 |
* -2.5 | -2 |
* -5.5 | -5 |
+ *
*
*/
DOWN(BigDecimal.ROUND_DOWN),
@@ -149,10 +161,13 @@
* that this rounding mode never decreases the calculated value.
*
*Example:
- *
+ *
* Rounding mode CEILING Examples
+ *
*Input Number |
* Input rounded to one digit with {@code CEILING} rounding
+ * |
+ *
*5.5 | 6 |
* 2.5 | 3 |
* 1.6 | 2 |
@@ -163,6 +178,7 @@
* -1.6 | -1 |
* -2.5 | -2 |
* -5.5 | -5 |
+ *
*
*/
CEILING(BigDecimal.ROUND_CEILING),
@@ -174,10 +190,13 @@
* this rounding mode never increases the calculated value.
*
*Example:
- *
+ *
* Rounding mode FLOOR Examples
+ *
*Input Number |
* Input rounded to one digit with {@code FLOOR} rounding
+ * |
+ *
*5.5 | 5 |
* 2.5 | 2 |
* 1.6 | 1 |
@@ -188,6 +207,7 @@
* -1.6 | -2 |
* -2.5 | -3 |
* -5.5 | -6 |
+ *
*
*/
FLOOR(BigDecimal.ROUND_FLOOR),
@@ -201,10 +221,13 @@
* mode commonly taught at school.
*
*Example:
- *
+ *
* Rounding mode HALF_UP Examples
+ *
*Input Number |
* Input rounded to one digit with {@code HALF_UP} rounding
+ * |
+ *
*5.5 | 6 |
* 2.5 | 3 |
* 1.6 | 2 |
@@ -215,6 +238,7 @@
* -1.6 | -2 |
* -2.5 | -3 |
* -5.5 | -6 |
+ *
*
*/
HALF_UP(BigDecimal.ROUND_HALF_UP),
@@ -227,10 +251,13 @@
* {@code RoundingMode.DOWN}.
*
*Example:
- *
+ *
* Rounding mode HALF_DOWN Examples
+ *
*Input Number |
* Input rounded to one digit with {@code HALF_DOWN} rounding
+ * |
+ *
*5.5 | 5 |
* 2.5 | 2 |
* 1.6 | 2 |
@@ -241,6 +268,7 @@
* -1.6 | -2 |
* -2.5 | -2 |
* -5.5 | -5 |
+ *
*
*/
HALF_DOWN(BigDecimal.ROUND_HALF_DOWN),
@@ -260,10 +288,13 @@
* arithmetic in Java.
*
*Example:
- *
+ *
* Rounding mode HALF_EVEN Examples
+ *
*Input Number |
* Input rounded to one digit with {@code HALF_EVEN} rounding
+ * |
+ *
*5.5 | 6 |
* 2.5 | 2 |
* 1.6 | 2 |
@@ -274,6 +305,7 @@
* -1.6 | -2 |
* -2.5 | -2 |
* -5.5 | -6 |
+ *
*
*/
HALF_EVEN(BigDecimal.ROUND_HALF_EVEN),
@@ -284,10 +316,13 @@
* specified on an operation that yields an inexact result, an
* {@code ArithmeticException} is thrown.
*Example:
- *
+ *
* Rounding mode UNNECESSARY Examples
+ *
*Input Number |
* Input rounded to one digit with {@code UNNECESSARY} rounding
+ * |
+ *
*5.5 | throw {@code ArithmeticException} |
* 2.5 | throw {@code ArithmeticException} |
* 1.6 | throw {@code ArithmeticException} |
@@ -298,6 +333,7 @@
* -1.6 | throw {@code ArithmeticException} |
* -2.5 | throw {@code ArithmeticException} |
* -5.5 | throw {@code ArithmeticException} |
+ *
*
*/
UNNECESSARY(BigDecimal.ROUND_UNNECESSARY);
--- old/src/java.base/share/classes/java/net/Inet4Address.java 2017-05-03 14:00:31.256740877 -0700
+++ new/src/java.base/share/classes/java/net/Inet4Address.java 2017-05-03 14:00:31.124735167 -0700
@@ -41,12 +41,12 @@
* Textual representation of IPv4 address used as input to methods
* takes one of the following forms:
*
- *
- * {@code d.d.d.d} |
- * {@code d.d.d} |
- * {@code d.d} |
- * {@code d} |
- *
+ *
+ * - {@code d.d.d.d}
+ * - {@code d.d.d}
+ * - {@code d.d}
+ * - {@code d}
+ *
*
* When four parts are specified, each is interpreted as a byte of
* data and assigned, from left to right, to the four bytes of an IPv4
--- old/src/java.base/share/classes/java/net/Inet6Address.java 2017-05-03 14:00:31.596755583 -0700
+++ new/src/java.base/share/classes/java/net/Inet6Address.java 2017-05-03 14:00:31.496751257 -0700
@@ -49,9 +49,9 @@
* the hexadecimal values of the eight 16-bit pieces of the
* address. This is the full form. For example,
*
- *
- * {@code 1080:0:0:0:8:800:200C:417A} | |
- *
+ *
+ * - {@code 1080:0:0:0:8:800:200C:417A}
+ *
*
* Note that it is not necessary to write the leading zeros in
* an individual field. However, there must be at least one numeral
@@ -66,9 +66,9 @@
* The "::" can also be used to compress the leading and/or trailing
* zeros in an address. For example,
*
- *
- * {@code 1080::8:800:200C:417A} | |
- *
+ *
+ * - {@code 1080::8:800:200C:417A}
+ *
*
* An alternative form that is sometimes more convenient
* when dealing with a mixed environment of IPv4 and IPv6 nodes is
@@ -77,35 +77,35 @@
* are the decimal values of the four low-order 8-bit pieces of the
* standard IPv4 representation address, for example,
*
- *
- * {@code ::FFFF:129.144.52.38} | |
- * {@code ::129.144.52.38} | |
- *
+ *
+ * - {@code ::FFFF:129.144.52.38}
+ * - {@code ::129.144.52.38}
+ *
*
* where "::FFFF:d.d.d.d" and "::d.d.d.d" are, respectively, the
* general forms of an IPv4-mapped IPv6 address and an
* IPv4-compatible IPv6 address. Note that the IPv4 portion must be
* in the "d.d.d.d" form. The following forms are invalid:
*
- *
- * {@code ::FFFF:d.d.d} | |
- * {@code ::FFFF:d.d} | |
- * {@code ::d.d.d} | |
- * {@code ::d.d} | |
- *
+ *
+ * - {@code ::FFFF:d.d.d}
+ * - {@code ::FFFF:d.d}
+ * - {@code ::d.d.d}
+ * - {@code ::d.d}
+ *
*
* The following form:
*
- *
+ *
*
* is valid, however it is an unconventional representation of
* the IPv4-compatible IPv6 address,
*
- *
- * {@code ::255.255.0.d} | |
- *
+ *
+ * - {@code ::255.255.0.d}
+ *
*
* while "::d" corresponds to the general IPv6 address
* "0:0:0:0:0:0:0:d".
@@ -119,9 +119,10 @@
* Special IPv6 address
*
*
- *
- * IPv4-mapped address |
- * Of the form::ffff:w.x.y.z, this IPv6 address is used to
+ *
+ * Description of IPv4-mapped address
+ * IPv4-mapped address |
+ * Of the form ::ffff:w.x.y.z, this IPv6 address is used to
* represent an IPv4 address. It allows the native program to
* use the same address data structure and also the same
* socket when communicating with both IPv4 and IPv6 nodes.
--- old/src/java.base/share/classes/java/net/InetAddress.java 2017-05-03 14:00:32.024774095 -0700
+++ new/src/java.base/share/classes/java/net/InetAddress.java 2017-05-03 14:00:31.884768040 -0700
@@ -72,7 +72,9 @@
*
* Address types
*
- *
+ *
+ * Description of unicast and multicast address types
+ *
* unicast |
* An identifier for a single interface. A packet sent to
* a unicast address is delivered to the interface identified by
@@ -96,6 +98,7 @@
* | 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
--- old/src/java.base/share/classes/java/net/NetPermission.java 2017-05-03 14:00:32.440792089 -0700
+++ new/src/java.base/share/classes/java/net/NetPermission.java 2017-05-03 14:00:32.340787764 -0700
@@ -47,12 +47,16 @@
* and for each provides a description of what the permission allows
* and a discussion of the risks of granting code the permission.
*
- *
+ *
+ * Permission target name, what the permission allows, and associated risks
+ *
*
* Permission Target Name |
* What the Permission Allows |
* Risks of Allowing this Permission |
*
+ *
+ *
*
* allowHttpTrace |
* The ability to use the HTTP TRACE method in HttpURLConnection. |
@@ -151,6 +155,7 @@
* creating a ProtectionDomain/CodeSource for a class even though
* that class really didn't come from that location.
*
+
*
*
* @see java.security.BasicPermission
--- old/src/java.base/share/classes/java/net/URI.java 2017-05-03 14:00:32.836809218 -0700
+++ new/src/java.base/share/classes/java/net/URI.java 2017-05-03 14:00:32.708803682 -0700
@@ -83,11 +83,11 @@
* not begin with a slash character ({@code '/'}). Opaque URIs are not
* subject to further parsing. Some examples of opaque URIs are:
*
- *
- * {@code mailto:java-net@java.sun.com} | |
- * {@code news:comp.lang.java} | |
- * {@code urn:isbn:096139210x} |
- *
+ *
+ * - {@code mailto:java-net@java.sun.com}
+ * - {@code news:comp.lang.java}
+ * - {@code urn:isbn:096139210x}
+ *
*
* A hierarchical URI is either an absolute URI whose
* scheme-specific part begins with a slash character, or a relative URI, that
@@ -132,8 +132,12 @@
*
* All told, then, a URI instance has the following nine components:
*
- *
+ *
+ * Describes the components of a URI:scheme,scheme-specific-part,authority,user-info,host,port,path,query,fragment
+ *
* Component | Type |
+ *
+ *
* scheme | {@code String} |
* scheme-specific-part | {@code String} |
* authority | {@code String} |
@@ -143,6 +147,7 @@
* path | {@code String} |
* query | {@code String} |
* fragment | {@code String} |
+ *
*
*
* In a given instance any particular component is either undefined or
@@ -248,7 +253,9 @@
* which are taken from that specification, are used below to describe these
* constraints:
*
- *
+ *
+ * Describes categories alpha,digit,alphanum,unreserved,punct,reserved,escaped,and other
+ *
* alpha |
* The US-ASCII alphabetic characters,
* {@code 'A'} through {@code 'Z'}
@@ -279,6 +286,7 @@
* java.lang.Character#isSpaceChar(char) Character.isSpaceChar}
* method) (Deviation from RFC 2396, which is
* limited to US-ASCII) |
+ *
*
*
* The set of all legal URI characters consists of
--- old/src/java.base/share/classes/java/net/URLConnection.java 2017-05-03 14:00:33.316829980 -0700
+++ new/src/java.base/share/classes/java/net/URLConnection.java 2017-05-03 14:00:33.188824443 -0700
@@ -54,13 +54,18 @@
* read from and to write to the resource referenced by the URL. In
* general, creating a connection to a URL is a multistep process:
*
- *
+ *
+ * Describes the process of creating a connection to a URL: openConnection() and connect() over time.
+ *
* {@code openConnection()} |
* {@code connect()} |
+ *
+ *
* Manipulate parameters that affect the connection to the remote
* resource. |
* Interact with the resource; query header fields and
* contents. |
+ *
*
* ---------------------------->
* time
--- old/src/java.base/share/classes/java/net/URLPermission.java 2017-05-03 14:00:33.764849358 -0700
+++ new/src/java.base/share/classes/java/net/URLPermission.java 2017-05-03 14:00:33.640843994 -0700
@@ -72,9 +72,12 @@
* 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:
- *
+ *
* URL Examples
+ *
* Example url | Description |
+ *
+ *
* http://www.oracle.com/a/b/c.html |
* A url which identifies a specific (single) resource |
*
@@ -90,6 +93,7 @@
* example).
*
*
+ *
*
*
* The '*' and '-' may only be specified in the final segment of a path and must be
@@ -246,9 +250,12 @@
* otherwise, return false
*
* Some examples of how paths are matched are shown below:
- *
+ *
* Examples of Path Matching
+ *
* 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 |
@@ -256,6 +263,7 @@
* /a/b/- | /a/b/c/d/e | yes |
* /a/b/- | /a/b/c/* | yes |
* /a/b/* | /a/b/c/- | no |
+ *
*
*/
public boolean implies(Permission p) {
--- old/src/java.base/share/classes/java/nio/channels/AsynchronousChannelGroup.java 2017-05-03 14:00:34.212868736 -0700
+++ new/src/java.base/share/classes/java/nio/channels/AsynchronousChannelGroup.java 2017-05-03 14:00:34.068862507 -0700
@@ -60,11 +60,15 @@
* default group is not configured then the pooled threads of the default group
* are {@link Thread#isDaemon daemon} threads.
*
- *
+ *
+ * System properties
+ *
*
* System property |
* Description |
*
+ *
+ *
*
* {@code java.nio.channels.DefaultThreadPool.threadFactory} |
* The value of this property is taken to be the fully-qualified name
@@ -86,6 +90,7 @@
* unspecified error to be thrown during the construction of the default
* group. |
*
+ *
*
*
* Threading
--- old/src/java.base/share/classes/java/nio/channels/AsynchronousFileChannel.java 2017-05-03 14:00:34.660888114 -0700
+++ new/src/java.base/share/classes/java/nio/channels/AsynchronousFileChannel.java 2017-05-03 14:00:34.528882404 -0700
@@ -133,8 +133,12 @@
* In addition to {@code READ} and {@code WRITE}, the following options
* may be present:
*
- *
+ *
+ * additional options
+ *
* Option | Description |
+ *
+ *
*
* {@link StandardOpenOption#TRUNCATE_EXISTING TRUNCATE_EXISTING} |
* When opening an existing file, the file is first truncated to a
@@ -186,6 +190,7 @@
* href="../file/package-summary.html#integrity"> Synchronized I/O file
* integrity). |
*
+ *
*
*
* An implementation may also support additional options.
--- old/src/java.base/share/classes/java/nio/channels/AsynchronousServerSocketChannel.java 2017-05-03 14:00:35.108907492 -0700
+++ new/src/java.base/share/classes/java/nio/channels/AsynchronousServerSocketChannel.java 2017-05-03 14:00:34.976901783 -0700
@@ -52,11 +52,15 @@
* Socket options are configured using the {@link #setOption(SocketOption,Object)
* setOption} method. Channels of this type support the following options:
*
- *
+ *
+ * Socket options
+ *
*
* Option Name |
* Description |
*
+ *
+ *
*
* {@link java.net.StandardSocketOptions#SO_RCVBUF SO_RCVBUF} |
* The size of the socket receive buffer |
@@ -65,6 +69,7 @@
* {@link java.net.StandardSocketOptions#SO_REUSEADDR SO_REUSEADDR} |
* Re-use address |
*
+ *
*
*
* Additional (implementation specific) options may also be supported.
--- old/src/java.base/share/classes/java/nio/channels/AsynchronousSocketChannel.java 2017-05-03 14:00:35.520925313 -0700
+++ new/src/java.base/share/classes/java/nio/channels/AsynchronousSocketChannel.java 2017-05-03 14:00:35.400920122 -0700
@@ -62,11 +62,15 @@
* Socket options are configured using the {@link #setOption(SocketOption,Object)
* setOption} method. Asynchronous socket channels support the following options:
*
- *
+ *
+ * Socket options
+ *
*
* Option Name |
* Description |
*
+ *
+ *
*
* {@link java.net.StandardSocketOptions#SO_SNDBUF SO_SNDBUF} |
* The size of the socket send buffer |
@@ -87,6 +91,7 @@
* {@link java.net.StandardSocketOptions#TCP_NODELAY TCP_NODELAY} |
* Disable the Nagle algorithm |
*
+ *
*
*
* Additional (implementation specific) options may also be supported.
--- old/src/java.base/share/classes/java/nio/channels/DatagramChannel.java 2017-05-03 14:00:35.940943479 -0700
+++ new/src/java.base/share/classes/java/nio/channels/DatagramChannel.java 2017-05-03 14:00:35.808937770 -0700
@@ -57,11 +57,15 @@
* setOption} method. A datagram channel to an Internet Protocol socket supports
* the following options:
*
- *
+ *
+ * Socket options
+ *
*
* Option Name |
* Description |
*
+ *
+ *
*
* {@link java.net.StandardSocketOptions#SO_SNDBUF SO_SNDBUF} |
* The size of the socket send buffer |
@@ -97,6 +101,7 @@
* IP_MULTICAST_LOOP}
* Loopback for Internet Protocol (IP) multicast datagrams |
*
+ *
*
*
* Additional (implementation specific) options may also be supported.
--- old/src/java.base/share/classes/java/nio/channels/FileChannel.java 2017-05-03 14:00:36.288958533 -0700
+++ new/src/java.base/share/classes/java/nio/channels/FileChannel.java 2017-05-03 14:00:36.192954380 -0700
@@ -174,8 +174,12 @@
* In the addition to {@code READ} and {@code WRITE}, the following
* options may be present:
*
- *
+ *
+ * additional options
+ *
* Option | Description |
+ *
+ *
*
* {@link StandardOpenOption#APPEND APPEND} |
* If this option is present then the file is opened for writing and
@@ -237,6 +241,7 @@
* href="../file/package-summary.html#integrity"> Synchronized I/O file
* integrity). |
*
+ *
*
*
* An implementation may also support additional options.
--- old/src/java.base/share/classes/java/nio/channels/ServerSocketChannel.java 2017-05-03 14:00:36.724977390 -0700
+++ new/src/java.base/share/classes/java/nio/channels/ServerSocketChannel.java 2017-05-03 14:00:36.596971855 -0700
@@ -46,11 +46,15 @@
* Socket options are configured using the {@link #setOption(SocketOption,Object)
* setOption} method. Server-socket channels support the following options:
*
- *
+ *
+ * Socket options
+ *
*
* Option Name |
* Description |
*
+ *
+ *
*
* {@link java.net.StandardSocketOptions#SO_RCVBUF SO_RCVBUF} |
* The size of the socket receive buffer |
@@ -59,6 +63,7 @@
* {@link java.net.StandardSocketOptions#SO_REUSEADDR SO_REUSEADDR} |
* Re-use address |
*
+ *
*
*
* Additional (implementation specific) options may also be supported.
--- old/src/java.base/share/classes/java/nio/channels/SocketChannel.java 2017-05-03 14:00:37.148995732 -0700
+++ new/src/java.base/share/classes/java/nio/channels/SocketChannel.java 2017-05-03 14:00:37.016990022 -0700
@@ -66,11 +66,15 @@
* Socket options are configured using the {@link #setOption(SocketOption,Object)
* setOption} method. Socket channels support the following options:
*
- *
+ *
+ * Socket options
+ *
*
* Option Name |
* Description |
*
+ *
+ *
*
* {@link java.net.StandardSocketOptions#SO_SNDBUF SO_SNDBUF} |
* The size of the socket send buffer |
@@ -96,6 +100,7 @@
* {@link java.net.StandardSocketOptions#TCP_NODELAY TCP_NODELAY} |
* Disable the Nagle algorithm |
*
+ *
*
*
* Additional (implementation specific) options may also be supported.
--- old/src/java.base/share/classes/java/nio/charset/Charset.java 2017-05-03 14:00:37.577014244 -0700
+++ new/src/java.base/share/classes/java/nio/charset/Charset.java 2017-05-03 14:00:37.445008534 -0700
@@ -147,8 +147,12 @@
* implementation to see if any other charsets are supported. The behavior
* of such optional charsets may differ between implementations.
*
- *
+ *
+ * Description of standard charsets
+ *
* Charset | Description |
+ *
+ *
* {@code US-ASCII} |
* Seven-bit ASCII, a.k.a. {@code ISO646-US},
* a.k.a. the Basic Latin block of the Unicode character set |
@@ -165,6 +169,7 @@
* {@code UTF-16} |
* Sixteen-bit UCS Transformation Format,
* byte order identified by an optional byte-order mark |
+ *
*
*
* The {@code UTF-8} charset is specified by
- *
+ *
+ * Pattern Language
+ *
*
* {@code *.java} |
* Matches a path that represents a file name ending in {@code .java} |
@@ -348,7 +350,7 @@
* platform (note that the backslash is escaped; as a string literal in the
* Java Language the pattern would be "C:\\\\*" )
*
- *
+ *
*
*
*
--- old/src/java.base/share/classes/java/nio/file/Files.java 2017-05-03 14:00:38.433051270 -0700
+++ new/src/java.base/share/classes/java/nio/file/Files.java 2017-05-03 14:00:38.301045560 -0700
@@ -233,8 +233,12 @@
* In the addition to {@code READ} and {@code WRITE}, the following
* options may be present:
*
- *
+ *
+ * Options
+ *
* Option | Description |
+ *
+ *
*
* {@link StandardOpenOption#APPEND APPEND} |
* If this option is present then the file is opened for writing and
@@ -294,6 +298,7 @@
* href="package-summary.html#integrity"> Synchronized I/O file
* integrity). |
*
+ *
*
*
* An implementation may also support additional implementation specific
@@ -1188,8 +1193,12 @@
*
* The {@code options} parameter may include any of the following:
*
- *
+ *
+ * Options
+ *
* Option | Description |
+ *
+ *
*
* {@link StandardCopyOption#REPLACE_EXISTING REPLACE_EXISTING} |
* If the target file exists, then the target file is replaced if it
@@ -1215,6 +1224,7 @@
* new link. In other words, the {@code COPY_ATTRIBUTES} option may be
* ignored when copying a symbolic link. |
*
+ *
*
*
* An implementation of this interface may support additional
@@ -1306,8 +1316,12 @@
*
* The {@code options} parameter may include any of the following:
*
- *
+ *
+ * Options
+ *
* Option | Description |
+ *
+ *
*
* {@link StandardCopyOption#REPLACE_EXISTING REPLACE_EXISTING} |
* If the target file exists, then the target file is replaced if it
@@ -1326,6 +1340,7 @@
* example, when the target location is on a different {@code FileStore}
* and would require that the file be copied, or target location is
* associated with a different provider to this object. |
+ *
*
*
* An implementation of this interface may support additional
@@ -1909,7 +1924,9 @@
* attributes} parameter:
*
*
- *
+ *
+ * Possible values
+ *
*
* {@code "*"} |
* Read all {@link BasicFileAttributes basic-file-attributes}. |
@@ -1927,6 +1944,7 @@
* {@code "posix:permissions,owner,size"} |
* Reads the POSIX file permissions, owner, and file size. |
*
+ *
*
*
*
--- old/src/java.base/share/classes/java/nio/file/LinkPermission.java 2017-05-03 14:00:38.893071167 -0700
+++ new/src/java.base/share/classes/java/nio/file/LinkPermission.java 2017-05-03 14:00:38.789066669 -0700
@@ -33,13 +33,16 @@
* The following table provides a summary description of what the permission
* allows, and discusses the risks of granting code the permission.
*
- *
+ *
+ * Table shows permission target name, what the permission allows, and associated risks
+ *
*
* Permission Target Name |
* What the Permission Allows |
* Risks of Allowing this Permission |
*
+ *
+ *
*
* hard |
* Ability to add an existing file to a directory. This is sometimes
@@ -55,6 +58,7 @@
* linking to any file or directory in the file system thus allowing the
* attacker to access to all files. |
*
+ *
*
*
* @since 1.7
--- old/src/java.base/share/classes/java/nio/file/attribute/AclFileAttributeView.java 2017-05-03 14:00:39.317089507 -0700
+++ new/src/java.base/share/classes/java/nio/file/attribute/AclFileAttributeView.java 2017-05-03 14:00:39.185083797 -0700
@@ -94,11 +94,15 @@
* Where dynamic access to file attributes is required, the attributes
* supported by this attribute view are as follows:
*
- *
+ *
+ * Supported attributes
+ *
*
* Name |
* Type |
*
+ *
+ *
*
* "acl" |
* {@link List}<{@link AclEntry}> |
@@ -107,6 +111,7 @@
* "owner" |
* {@link UserPrincipal} |
*
+ *
*
*
*
--- old/src/java.base/share/classes/java/nio/file/attribute/BasicFileAttributeView.java 2017-05-03 14:00:39.741107847 -0700
+++ new/src/java.base/share/classes/java/nio/file/attribute/BasicFileAttributeView.java 2017-05-03 14:00:39.617102484 -0700
@@ -41,11 +41,15 @@
* Where dynamic access to file attributes is required, the attributes
* supported by this attribute view have the following names and types:
*
- *
+ *
+ * Supported attributes
+ *
*
* Name |
* Type |
*
+ *
+ *
*
* "lastModifiedTime" |
* {@link FileTime} |
@@ -82,6 +86,7 @@
* "fileKey" |
* {@link Object} |
*
+ *
*
*
*
--- old/src/java.base/share/classes/java/nio/file/attribute/DosFileAttributeView.java 2017-05-03 14:00:40.181126879 -0700
+++ new/src/java.base/share/classes/java/nio/file/attribute/DosFileAttributeView.java 2017-05-03 14:00:40.045120997 -0700
@@ -41,11 +41,15 @@
* BasicFileAttributeView}, and in addition, the following attributes are
* supported:
*
- *
+ *
+ * Supported attributes
+ *
*
* Name |
* Type |
*
+ *
+ *
*
* readonly |
* {@link Boolean} |
@@ -62,6 +66,7 @@
* archive |
* {@link Boolean} |
*
+ *
*
*
*
--- old/src/java.base/share/classes/java/nio/file/attribute/PosixFileAttributeView.java 2017-05-03 14:00:40.617145739 -0700
+++ new/src/java.base/share/classes/java/nio/file/attribute/PosixFileAttributeView.java 2017-05-03 14:00:40.485140029 -0700
@@ -74,11 +74,15 @@
* BasicFileAttributeView} and {@link FileOwnerAttributeView}, and in addition,
* the following attributes are supported:
*
- *
+ *
+ * Supported attributes
+ *
*
* Name |
* Type |
*
+ *
+ *
*
* "permissions" |
* {@link Set}<{@link PosixFilePermission}> |
@@ -87,6 +91,7 @@
* "group" |
* {@link GroupPrincipal} |
*
+ *
*
*
*
--- old/src/java.base/share/classes/java/nio/file/spi/FileSystemProvider.java 2017-05-03 14:00:40.965160791 -0700
+++ new/src/java.base/share/classes/java/nio/file/spi/FileSystemProvider.java 2017-05-03 14:00:40.865156466 -0700
@@ -919,8 +919,12 @@
* according to all of access modes specified in the {@code modes} parameter
* as follows:
*
- *
+ *
+ * Access Modes
+ *
* Value | Description |
+ *
+ *
*
* {@link AccessMode#READ READ} |
* Checks that the file exists and that the Java virtual machine has
@@ -940,6 +944,7 @@
* virtual machine has permission to search the directory in order to
* access file or subdirectories. |
*
+ *
*
*
* If the {@code modes} parameter is of length zero, then the existence
--- old/src/java.base/share/classes/java/security/DrbgParameters.java 2017-05-03 14:00:41.397179477 -0700
+++ new/src/java.base/share/classes/java/security/DrbgParameters.java 2017-05-03 14:00:41.269173941 -0700
@@ -263,14 +263,19 @@
* Capability effective = ((DrbgParametes.Initiate) s.getParameters())
* .getCapability();
*
- *
+ *
+ * requested and effective capabilities
+ *
*
* Requested Value |
* Possible Effective Values |
*
+ *
+ *
* NONE | NONE, RESEED_ONLY, PR_AND_RESEED |
* RESEED_ONLY | RESEED_ONLY, PR_AND_RESEED |
* PR_AND_RESEED | PR_AND_RESEED |
+ *
*
*
* A DRBG implementation supporting prediction resistance must also
--- old/src/java.base/share/classes/java/security/Provider.java 2017-05-03 14:00:41.845198855 -0700
+++ new/src/java.base/share/classes/java/security/Provider.java 2017-05-03 14:00:41.717193319 -0700
@@ -61,17 +61,21 @@
* security framework. Services of this type cannot be added, removed,
* or modified by applications.
* The following attributes are automatically placed in each Provider object:
- *
+ *
* Attributes Automatically Placed in a Provider Object
+ *
* Name | Value |
+ *
+ *
* {@code Provider.id name} |
- * {@code String.valueOf(provider.getName())} |
+ * {@code String.valueOf(provider.getName())} |
* {@code Provider.id version} |
* {@code String.valueOf(provider.getVersionStr())} |
* {@code Provider.id info} |
- {@code String.valueOf(provider.getInfo())} |
+ * {@code String.valueOf(provider.getInfo())} |
* {@code Provider.id className} |
* {@code provider.getClass().getName()} |
+ *
*
*
* Each provider has a name and a version string. A provider normally
--- old/src/java.base/share/classes/java/security/SecurityPermission.java 2017-05-03 14:00:42.305218753 -0700
+++ new/src/java.base/share/classes/java/security/SecurityPermission.java 2017-05-03 14:00:42.177213216 -0700
@@ -45,12 +45,16 @@
* target names, and for each provides a description of what the permission
* allows and a discussion of the risks of granting code the permission.
*
- *
+ *
+ * target name, what the permission allows, and associated risks
+ *
*
* Permission Target Name |
* What the Permission Allows |
* Risks of Allowing this Permission |
*
+ *
+ *
*
*
* authProvider.{provider name} |
@@ -196,6 +200,7 @@
* described under the "removeProvider.{provider name}" permission.
*
*
+ *
*
*
*
@@ -204,13 +209,17 @@
* {@link IdentityScope}, {@link Signer}. Use of them is discouraged. See the
* applicable classes for more information.
*
- *
+ *
+ * target name, what the permission allows, and associated risks
+ *
*
* Permission Target Name |
* What the Permission Allows |
* Risks of Allowing this Permission |
*
+ *
*
+ *
*
* insertProvider.{provider name} |
* Addition of a new provider, with the specified name |
@@ -308,6 +317,7 @@
* data encrypted under that session key.
*
*
+ *
*
*
* @implNote
--- old/src/java.base/share/classes/java/security/cert/X509Extension.java 2017-05-03 14:00:42.669234498 -0700
+++ new/src/java.base/share/classes/java/security/cert/X509Extension.java 2017-05-03 14:00:42.565229999 -0700
@@ -152,10 +152,14 @@
* by periods.
*
* For example:
- *
+ *
+ * Examples of OIDs and extension names
+ *
*
* OID (Object Identifier) |
* Extension Name |
+ *
+ *
* 2.5.29.14 |
* SubjectKeyIdentifier |
* 2.5.29.15 |
@@ -176,6 +180,7 @@
* AuthorityKeyIdentifier |
* 2.5.29.36 |
* PolicyConstraints |
+ *
*
*
* @param oid the Object Identifier value for the extension.
--- old/src/java.base/share/classes/java/text/DecimalFormat.java 2017-05-03 14:00:43.005249031 -0700
+++ new/src/java.base/share/classes/java/text/DecimalFormat.java 2017-05-03 14:00:42.905244706 -0700
@@ -172,19 +172,22 @@
* are not localized.
*
*
- *
- *
+ *
+ * Chart showing symbol, location, localized, and meaning.
+ *
+ *
* Symbol
* | Location
* | Localized?
* | Meaning
+ * |
+ *
*
* 0
* | Number
* | Yes
* | Digit
- * |
+ *
* #
* | Number
* | Yes
@@ -194,7 +197,7 @@
* | Number
* | Yes
* | Decimal separator or monetary decimal separator
- * |
+ *
* -
* | Number
* | Yes
@@ -204,7 +207,7 @@
* | Number
* | Yes
* | Grouping separator
- * |
+ *
* E
* | Number
* | Yes
@@ -215,7 +218,7 @@
* | Subpattern boundary
* | Yes
* | Separates positive and negative subpatterns
- * |
+ *
* %
* | Prefix or suffix
* | Yes
@@ -225,7 +228,7 @@
* | Prefix or suffix
* | Yes
* | Multiply by 1000 and show as per mille value
- * |
+ *
* ¤ (\u00A4 )
* | Prefix or suffix
* | No
@@ -241,6 +244,7 @@
* for example, "'#'#" formats 123 to
* "#123" . To create a single quote
* itself, use two in a row: "# o''clock" .
+ * |
*
*
*
--- old/src/java.base/share/classes/java/text/MessageFormat.java 2017-05-03 14:00:43.477269448 -0700
+++ new/src/java.base/share/classes/java/text/MessageFormat.java 2017-05-03 14:00:43.349263911 -0700
@@ -146,11 +146,15 @@
* shown in the table are illegal. A SubformatPattern must
* be a valid pattern string for the {@code Format} subclass used.
*
- *
+ *
+ * Shows how FormatType and FormatStyle values map to Format instances
+ *
*
* FormatType
* | FormatStyle
* | Subformat Created
+ * |
+ *
*
* (none)
* | (none)
@@ -213,6 +217,7 @@
* | choice
* | SubformatPattern
* | {@code new} {@link ChoiceFormat#ChoiceFormat(String) ChoiceFormat}{@code (subformatPattern)}
+ * |
*
*
* Usage Information
@@ -766,11 +771,15 @@
* argument is unavailable if arguments is
* null or has fewer than argumentIndex+1 elements.
*
- *
+ *
+ * Examples of subformat,argument,and formatted text
+ *
*
* Subformat
* | Argument
* | Formatted Text
+ * |
+ *
*
* any
* | unavailable
@@ -805,6 +814,7 @@
* | null
* | any
* | argument.toString()
+ * |
*
*
* If pos is non-null, and refers to
--- old/src/java.base/share/classes/java/text/SimpleDateFormat.java 2017-05-03 14:00:43.957290210 -0700
+++ new/src/java.base/share/classes/java/text/SimpleDateFormat.java 2017-05-03 14:00:43.821284327 -0700
@@ -92,18 +92,22 @@
* 'A' to 'Z' and from 'a' to
* 'z' are reserved):
*
- *
- *
+ *
+ * Chart shows pattern letters, date/time component, presentation, and examples.
+ *
+ *
* Letter
* | Date or Time Component
* | Presentation
* | Examples
+ * |
+ *
*
* G
* | Era designator
* | Text
* | AD
- * |
+ *
* y
* | Year
* | Year
@@ -113,7 +117,7 @@
* | Week year
* | Year
* | 2009 ; 09
- * |
+ *
* M
* | Month in year (context sensitive)
* | Month
@@ -123,7 +127,7 @@
* | Month in year (standalone form)
* | Month
* | July ; Jul ; 07
- * |
+ *
* w
* | Week in year
* | Number
@@ -133,7 +137,7 @@
* | Week in month
* | Number
* | 2
- * |
+ *
* D
* | Day in year
* | Number
@@ -143,7 +147,7 @@
* | Day in month
* | Number
* | 10
- * |
+ *
* F
* | Day of week in month
* | Number
@@ -153,7 +157,7 @@
* | Day name in week
* | Text
* | Tuesday ; Tue
- * |
+ *
* u
* | Day number of week (1 = Monday, ..., 7 = Sunday)
* | Number
@@ -163,7 +167,7 @@
* | Am/pm marker
* | Text
* | PM
- * |
+ *
* H
* | Hour in day (0-23)
* | Number
@@ -173,7 +177,7 @@
* | Hour in day (1-24)
* | Number
* | 24
- * |
+ *
* K
* | Hour in am/pm (0-11)
* | Number
@@ -183,7 +187,7 @@
* | Hour in am/pm (1-12)
* | Number
* | 12
- * |
+ *
* m
* | Minute in hour
* | Number
@@ -193,7 +197,7 @@
* | Second in minute
* | Number
* | 55
- * |
+ *
* S
* | Millisecond
* | Number
@@ -203,7 +207,7 @@
* | Time zone
* | General time zone
* | Pacific Standard Time ; PST ; GMT-08:00
- * |
+ *
* Z
* | Time zone
* | RFC 822 time zone
@@ -213,6 +217,7 @@
* | Time zone
* | ISO 8601 time zone
* | -08 ; -0800 ; -08:00
+ * |
*
*
* Pattern letters are usually repeated, as their number determines the
@@ -370,43 +375,48 @@
* the U.S. locale. The given date and time are 2001-07-04 12:08:56 local time
* in the U.S. Pacific Time time zone.
*
- *
- *
+ *
+ * Examples of date and time patterns interpreted in the U.S. locale
+ *
+ *
* Date and Time Pattern
* | Result
+ * |
+ *
*
* "yyyy.MM.dd G 'at' HH:mm:ss z"
* | 2001.07.04 AD at 12:08:56 PDT
- * |
+ *
* "EEE, MMM d, ''yy"
* | Wed, Jul 4, '01
* |
* "h:mm a"
* | 12:08 PM
- * |
+ *
* "hh 'o''clock' a, zzzz"
* | 12 o'clock PM, Pacific Daylight Time
* |
* "K:mm a, z"
* | 0:08 PM, PDT
- * |
+ *
* "yyyyy.MMMMM.dd GGG hh:mm aaa"
* | 02001.July.04 AD 12:08 PM
* |
* "EEE, d MMM yyyy HH:mm:ss Z"
* | Wed, 4 Jul 2001 12:08:56 -0700
- * |
+ *
* "yyMMddHHmmssZ"
* | 010704120856-0700
* |
* "yyyy-MM-dd'T'HH:mm:ss.SSSZ"
* | 2001-07-04T12:08:56.235-0700
- * |
+ *
* "yyyy-MM-dd'T'HH:mm:ss.SSSXXX"
* | 2001-07-04T12:08:56.235-07:00
* |
* "YYYY-'W'ww-u"
* | 2001-W27-3
+ * |
*
*
*
--- old/src/java.base/share/classes/java/time/chrono/HijrahChronology.java 2017-05-03 14:00:44.429310627 -0700
+++ new/src/java.base/share/classes/java/time/chrono/HijrahChronology.java 2017-05-03 14:00:44.297304917 -0700
@@ -103,17 +103,18 @@
*
*
* CLDR and LDML identify variants:
- *
+ *
+ * Variants of Hijrah Calendars
*
- *
- * Chronology ID |
- * Calendar Type |
- * Locale extension, see {@link java.util.Locale} |
- * Description |
+ *
+ * Chronology ID |
+ * Calendar Type |
+ * Locale extension, see {@link java.util.Locale} |
+ * Description |
*
*
*
- *
+ *
* Hijrah-umalqura |
* islamic-umalqura |
* ca-islamic-umalqura |
@@ -147,36 +148,37 @@
*
* The Hijrah property resource is a set of properties that describe the calendar.
* The syntax is defined by {@code java.util.Properties#load(Reader)}.
- *
+ *
+ * Configuration of Hijrah Calendar
*
- *
- * Property Name |
- * Property value |
- * Description |
+ *
+ * Property Name |
+ * Property value |
+ * Description |
*
*
*
- *
+ *
* id |
* Chronology Id, for example, "Hijrah-umalqura" |
* The Id of the calendar in common usage |
*
- *
+ *
* type |
* Calendar type, for example, "islamic-umalqura" |
* LDML defines the calendar types |
*
- *
+ *
* version |
* Version, for example: "1.8.0_1" |
* The version of the Hijrah variant data |
*
- *
+ *
* iso-start |
* ISO start date, formatted as {@code yyyy-MM-dd}, for example: "1900-04-30" |
* The ISO date of the first day of the minimum Hijrah year. |
*
- *
+ *
* yyyy - a numeric 4 digit year, for example "1434" |
* The value is a sequence of 12 month lengths,
* for example: "29 30 29 30 29 30 30 30 29 30 29 29" |
--- old/src/java.base/share/classes/java/time/chrono/IsoEra.java 2017-05-03 14:00:44.861329313 -0700
+++ new/src/java.base/share/classes/java/time/chrono/IsoEra.java 2017-05-03 14:00:44.729323603 -0700
@@ -70,25 +70,26 @@
* A definition has therefore been created with two eras - 'Current era' (CE) for
* years on or after 0001-01-01 (ISO), and 'Before current era' (BCE) for years before that.
*
- *
+ *
+ * ISO years and eras
*
- *
- * year-of-era |
- * era |
- * proleptic-year |
+ *
+ * year-of-era |
+ * era |
+ * proleptic-year |
*
*
*
- *
+ *
* 2 | CE | 2 |
*
- *
+ *
* 1 | CE | 1 |
*
- *
+ *
* 1 | BCE | 0 |
*
- *
+ *
* 2 | BCE | -1 |
*
*
--- old/src/java.base/share/classes/java/time/chrono/MinguoEra.java 2017-05-03 14:00:45.209344366 -0700
+++ new/src/java.base/share/classes/java/time/chrono/MinguoEra.java 2017-05-03 14:00:45.109340041 -0700
@@ -71,26 +71,27 @@
* All previous years, zero or earlier in the proleptic count or one and greater
* in the year-of-era count, are part of the 'Before Republic of China' era.
*
- *
+ *
+ * Minguo years and eras
*
- *
- * year-of-era |
- * era |
- * proleptic-year |
- * ISO proleptic-year |
+ *
+ * year-of-era |
+ * era |
+ * proleptic-year |
+ * ISO proleptic-year |
*
*
*
- *
+ *
* 2 | ROC | 2 | 1913 |
*
- *
+ *
* 1 | ROC | 1 | 1912 |
*
- *
+ *
* 1 | BEFORE_ROC | 0 | 1911 |
*
- *
+ *
* 2 | BEFORE_ROC | -1 | 1910 |
*
*
--- old/src/java.base/share/classes/java/time/chrono/ThaiBuddhistEra.java 2017-05-03 14:00:45.585360630 -0700
+++ new/src/java.base/share/classes/java/time/chrono/ThaiBuddhistEra.java 2017-05-03 14:00:45.485356304 -0700
@@ -71,26 +71,27 @@
* All previous years, zero or earlier in the proleptic count or one and greater
* in the year-of-era count, are part of the 'Before Buddhist' era.
*
- *
+ *
+ * Buddhist years and eras
*
- *
- * year-of-era |
- * era |
- * proleptic-year |
- * ISO proleptic-year |
+ *
+ * year-of-era |
+ * era |
+ * proleptic-year |
+ * ISO proleptic-year |
*
*
*
- *
+ *
* 2 | BE | 2 | -542 |
*
- *
+ *
* 1 | BE | 1 | -543 |
*
- *
+ *
* 1 | BEFORE_BE | 0 | -544 |
*
- *
+ *
* 2 | BEFORE_BE | -1 | -545 |
*
*
--- old/src/java.base/share/classes/java/time/format/DateTimeFormatter.java 2017-05-03 14:00:45.941376029 -0700
+++ new/src/java.base/share/classes/java/time/format/DateTimeFormatter.java 2017-05-03 14:00:45.833371357 -0700
@@ -150,105 +150,106 @@
* implementation of {@code java.text.Format}.
*
* Predefined Formatters
- *
+ *
+ * Predefined Formatters
*
- *
- * Formatter |
- * Description |
- * Example |
+ *
+ * Formatter |
+ * Description |
+ * Example |
*
*
*
- *
+ *
* {@link #ofLocalizedDate ofLocalizedDate(dateStyle)} |
* Formatter with date style from the locale |
* '2011-12-03' |
*
- *
+ *
* {@link #ofLocalizedTime ofLocalizedTime(timeStyle)} |
* Formatter with time style from the locale |
* '10:15:30' |
*
- *
+ *
* {@link #ofLocalizedDateTime ofLocalizedDateTime(dateTimeStyle)} |
* Formatter with a style for date and time from the locale |
* '3 Jun 2008 11:05:30' |
*
- *
+ *
* {@link #ofLocalizedDateTime ofLocalizedDateTime(dateStyle,timeStyle)}
* |
* Formatter with date and time styles from the locale |
* '3 Jun 2008 11:05' |
*
- *
+ *
* {@link #BASIC_ISO_DATE} |
* Basic ISO date | '20111203' |
*
- *
+ *
* {@link #ISO_LOCAL_DATE} |
* ISO Local Date |
* '2011-12-03' |
*
- *
+ *
* {@link #ISO_OFFSET_DATE} |
* ISO Date with offset |
* '2011-12-03+01:00' |
*
- *
+ *
* {@link #ISO_DATE} |
* ISO Date with or without offset |
* '2011-12-03+01:00'; '2011-12-03' |
*
- *
+ *
* {@link #ISO_LOCAL_TIME} |
* Time without offset |
* '10:15:30' |
*
- *
+ *
* {@link #ISO_OFFSET_TIME} |
* Time with offset |
* '10:15:30+01:00' |
*
- *
+ *
* {@link #ISO_TIME} |
* Time with or without offset |
* '10:15:30+01:00'; '10:15:30' |
*
- *
+ *
* {@link #ISO_LOCAL_DATE_TIME} |
* ISO Local Date and Time |
* '2011-12-03T10:15:30' |
*
- *
+ *
* {@link #ISO_OFFSET_DATE_TIME} |
* Date Time with Offset
* | 2011-12-03T10:15:30+01:00' |
*
- *
+ *
* {@link #ISO_ZONED_DATE_TIME} |
* Zoned Date Time |
* '2011-12-03T10:15:30+01:00[Europe/Paris]' |
*
- *
+ *
* {@link #ISO_DATE_TIME} |
* Date and time with ZoneId |
* '2011-12-03T10:15:30+01:00[Europe/Paris]' |
*
- *
+ *
* {@link #ISO_ORDINAL_DATE} |
* Year and day of year |
* '2012-337' |
*
- *
+ *
* {@link #ISO_WEEK_DATE} |
* Year and Week |
* 2012-W48-6' |
- *
+ *
* {@link #ISO_INSTANT} |
* Date and Time of an Instant |
* '2011-12-03T10:15:30Z' |
*
- *
+ *
* {@link #RFC_1123_DATE_TIME} |
* RFC 1123 / RFC 822 |
* 'Tue, 3 Jun 2008 11:05:30 GMT' |
--- old/src/java.base/share/classes/java/time/temporal/IsoFields.java 2017-05-03 14:00:46.413396445 -0700
+++ new/src/java.base/share/classes/java/time/temporal/IsoFields.java 2017-05-03 14:00:46.281390736 -0700
@@ -136,15 +136,19 @@
*
* For example:
*
- *
+ *
* Examples of Week based Years
+ *
* Date | Day-of-week | Field values |
+ *
+ *
* 2008-12-28 | Sunday | Week 52 of week-based-year 2008 |
* 2008-12-29 | Monday | Week 1 of week-based-year 2009 |
* 2008-12-31 | Wednesday | Week 1 of week-based-year 2009 |
* 2009-01-01 | Thursday | Week 1 of week-based-year 2009 |
* 2009-01-04 | Sunday | Week 1 of week-based-year 2009 |
* 2009-01-05 | Monday | Week 2 of week-based-year 2009 |
+ *
*
*
* @implSpec
--- old/src/java.base/share/classes/java/time/temporal/WeekFields.java 2017-05-03 14:00:46.865415996 -0700
+++ new/src/java.base/share/classes/java/time/temporal/WeekFields.java 2017-05-03 14:00:46.729410114 -0700
@@ -127,10 +127,13 @@
* The earliest period is referred to as week 0 if it has less than the minimal number of days
* and week 1 if it has at least the minimal number of days.
*
- *
+ *
* Examples of WeekFields
+ *
* Date | Day-of-week |
* First day: Monday Minimal days: 4 | First day: Monday Minimal days: 5 |
+ *
+ *
* 2008-12-31 | Wednesday |
* Week 5 of December 2008 | Week 5 of December 2008 |
* 2009-01-01 | Thursday |
@@ -139,6 +142,7 @@
* Week 1 of January 2009 | Week 0 of January 2009 |
* 2009-01-05 | Monday |
* Week 2 of January 2009 | Week 1 of January 2009 |
+ *
*
*
* Week of Year
@@ -157,10 +161,13 @@
* The first and last weeks of a year may contain days from the
* previous calendar year or next calendar year respectively.
*
- *
+ *
* Examples of WeekFields for week-based-year
+ *
* Date | Day-of-week |
* First day: Monday Minimal days: 4 | First day: Monday Minimal days: 5 |
+ *
+ *
* 2008-12-31 | Wednesday |
* Week 1 of 2009 | Week 53 of 2008 |
* 2009-01-01 | Thursday |
@@ -169,6 +176,7 @@
* Week 1 of 2009 | Week 53 of 2008 |
* 2009-01-05 | Monday |
* Week 2 of 2009 | Week 1 of 2009 |
+ *
*
*
* @implSpec
--- old/src/java.base/share/classes/java/util/Deque.java 2017-05-03 14:00:47.289434337 -0700
+++ new/src/java.base/share/classes/java/util/Deque.java 2017-05-03 14:00:47.161428800 -0700
@@ -56,7 +56,7 @@
* The twelve methods described above are summarized in the
* following table:
*
- *
+ *
* Summary of Deque methods
*
* |
@@ -99,7 +99,7 @@
* inherited from the {@code Queue} interface are precisely equivalent to
* {@code Deque} methods as indicated in the following table:
*
- *
+ *
* Comparison of Queue and Deque methods
*
* {@code Queue} Method |
@@ -137,7 +137,7 @@
* beginning of the deque. Stack methods are precisely equivalent to
* {@code Deque} methods as indicated in the table below:
*
- *
+ *
* Comparison of Stack and Deque methods
*
* Stack Method |
--- old/src/java.base/share/classes/java/util/Formatter.java 2017-05-03 14:00:47.729453369 -0700
+++ new/src/java.base/share/classes/java/util/Formatter.java 2017-05-03 14:00:47.597447660 -0700
@@ -290,12 +290,14 @@
*
* out.toUpperCase(Locale.getDefault(Locale.Category.FORMAT))
*
- *
- *
+ *
+ * genConv
+ *
* Conversion
* | Argument Category
* | Description
- *
+ * |
+ *
* {@code 'b'}, {@code 'B'}
* | general
* | If the argument arg is {@code null}, then the result is
@@ -365,6 +367,7 @@
* | line separator
* | The result is the platform-specific line separator
*
+ * |
*
*
* Any characters not explicitly defined as conversions are illegal and are
@@ -381,8 +384,9 @@
*
* The following conversion characters are used for formatting times:
*
- *
- *
+ *
+ * time
+ *
* {@code 'H'}
* | Hour of the day for the 24-hour clock, formatted as two digits with
* a leading zero as necessary i.e. {@code 00 - 23}.
@@ -446,11 +450,14 @@
* 1970 {@code 00:00:00} UTC, i.e. {@code Long.MIN_VALUE} to
* {@code Long.MAX_VALUE}.
*
+ * |
*
*
* The following conversion characters are used for formatting dates:
*
- *
+ *
+ * date
+ *
*
* {@code 'B'}
* | Locale-specific {@linkplain java.text.DateFormatSymbols#getMonths
@@ -502,12 +509,15 @@
* | {@code 'e'}
* | Day of month, formatted as two digits, i.e. {@code 1 - 31}.
*
+ * |
*
*
* The following conversion characters are used for formatting common
* date/time compositions.
*
- *
+ *
+ * composites
+ *
*
* {@code 'R'}
* | Time formatted for the 24-hour clock as {@code "%tH:%tM"}
@@ -530,7 +540,8 @@
* | {@code 'c'}
* | Date and time formatted as {@code "%ta %tb %td %tT %tZ %tY"},
* e.g. {@code "Sun Jul 20 16:17:00 EDT 1969"}.
- *
+ *
+ * |
*
*
* Any characters not explicitly defined as date/time conversion suffixes
@@ -541,14 +552,16 @@
* The following table summarizes the supported flags. y means the
* flag is supported for the indicated argument types.
*
- *
- *
+ *
+ * genConv
+ *
* Flag | General
* | Character | Integral
* | Floating Point
* | Date/Time
* | Description
- *
+ * |
+ *
* '-' | y
* | y
* | y
@@ -599,6 +612,7 @@
* | -
* | The result will enclose negative numbers in parentheses
*
+ * |
*
*
* 1 Depends on the definition of {@link Formattable}.
@@ -705,7 +719,9 @@
*
* The following general conversions may be applied to any argument type:
*
- *
+ *
+ * dgConv
+ *
*
* {@code 'b'}
* | '\u0062'
@@ -756,11 +772,14 @@
* | '\u0053'
* | The upper-case variant of {@code 's'}.
*
+ * |
*
*
* The following flags apply to general conversions:
*
- *
+ *
+ * dFlags
+ *
*
* {@code '-'}
* | '\u002d'
@@ -775,6 +794,7 @@
* | Requires the output use an alternate form. The definition of the
* form is specified by the conversion.
*
+ * |
*
*
* The width is the minimum number of characters to
@@ -801,7 +821,9 @@
* {@code false} then an {@link IllegalFormatCodePointException} will be
* thrown.
*
- *
+ *
+ * charConv
+ *
*
* {@code 'c'}
* | '\u0063'
@@ -817,6 +839,7 @@
* | '\u0043'
* | The upper-case variant of {@code 'c'}.
*
+ * |
*
*
* The {@code '-'} flag defined for General
@@ -902,7 +925,9 @@
* {@code short}, {@link Short}, {@code int} and {@link Integer},
* {@code long}, and {@link Long}.
*
- *
+ *
+ * IntConv
+ *
*
* {@code 'd'}
* | '\u0064'
@@ -968,6 +993,7 @@
* all hexadecimal digits {@code 'a'} - {@code 'f'}
* ('\u0061' - '\u0066' ).
*
+ * |
*
*
* If the conversion is {@code 'o'}, {@code 'x'}, or {@code 'X'} and
@@ -982,7 +1008,9 @@
* The following flags apply to numeric integral
* conversions:
*
- *
+ *
+ * intFlags
+ *
*
* {@code '+'}
* | '\u002b'
@@ -1025,6 +1053,7 @@
* ('\u0028' ) and append a {@code ')'}
* ('\u0029' ) to negative values.
*
+ * |
*
*
* If no flags are given the default formatting is
@@ -1060,7 +1089,9 @@
* The following conversions may be applied to {@link
* java.math.BigInteger}.
*
- *
+ *
+ * bIntConv
+ *
*
* {@code 'd'}
* | '\u0064'
@@ -1125,6 +1156,7 @@
* all hexadecimal digits {@code 'a'} - {@code 'f'}
* ('\u0061' - '\u0066' ).
*
+ * |
*
*
* If the conversion is {@code 'o'}, {@code 'x'}, or {@code 'X'} and
@@ -1154,7 +1186,9 @@
* The following conversions may be applied to {@code float}, {@link
* Float}, {@code double} and {@link Double}.
*
- *
+ *
+ * floatConv
+ *
*
* {@code 'e'}
* | '\u0065'
@@ -1331,6 +1365,7 @@
* ('\u0070' and all hexadecimal digits {@code 'a'} -
* {@code 'f'} ('\u0061' - '\u0066' ).
*
+ * |
*
*
* All flags defined for Byte, Short, Integer, and
@@ -1388,7 +1423,9 @@
* The following conversions may be applied {@link java.math.BigDecimal
* BigDecimal}.
*
- *
+ *
+ * floatConv
+ *
*
* {@code 'e'}
* | '\u0065'
@@ -1492,6 +1529,7 @@
* For a canonical representation of the value, use {@link
* BigDecimal#toString()}.
*
+ * |
*
*
* All flags defined for Byte, Short, Integer, and
@@ -1512,7 +1550,9 @@
* This conversion may be applied to {@code long}, {@link Long}, {@link
* Calendar}, {@link Date} and {@link TemporalAccessor TemporalAccessor}
*
- *
+ *
+ * DTConv
+ *
*
* {@code 't'}
* | '\u0074'
@@ -1521,6 +1561,7 @@
* | '\u0054'
* | The upper-case variant of {@code 't'}.
*
+ * |
*
*
* The following date and time conversion character suffixes are defined
@@ -1532,7 +1573,9 @@
*
* The following conversion characters are used for formatting times:
*
- *
+ *
+ * time
+ *
*
* {@code 'H'}
* | '\u0048'
@@ -1620,11 +1663,14 @@
* {@code Long.MAX_VALUE}. The precision of this value is limited by
* the resolution of the underlying operating system or hardware.
*
+ * |
*
*
* The following conversion characters are used for formatting dates:
*
- *
+ *
+ * date
+ *
*
* {@code 'B'}
* | '\u0042'
@@ -1692,12 +1738,15 @@
* | Day of month, formatted as two digits, i.e. {@code 1 - 31} where
* "{@code 1}" is the first day of the month.
*
+ * |
*
*
* The following conversion characters are used for formatting common
* date/time compositions.
*
- *
+ *
+ * composites
+ *
*
* {@code 'R'}
* | '\u0052'
@@ -1727,6 +1776,7 @@
* | Date and time formatted as {@code "%ta %tb %td %tT %tZ %tY"},
* e.g. {@code "Sun Jul 20 16:17:00 EDT 1969"}.
*
+ * |
*
*
* The {@code '-'} flag defined for General
@@ -1748,7 +1798,9 @@
*
* The conversion does not correspond to any argument.
*
- *
+ *
+ * DTConv
+ *
*
* {@code '%'}
* | The result is a literal {@code '%'} ('\u0025' )
@@ -1767,18 +1819,22 @@
* The precision is not applicable. If the precision is specified an
* {@link IllegalFormatPrecisionException} will be thrown.
*
+ * |
*
*
*
*
* The conversion does not correspond to any argument.
*
- *
+ *
+ * DTConv
+ *
*
* {@code 'n'}
* | the platform-specific line separator as returned by {@link
* System#lineSeparator()}.
*
+ * |
*
*
* Flags, width, and precision are not applicable. If any are provided an
--- old/src/java.base/share/classes/java/util/GregorianCalendar.java 2017-05-03 14:00:48.253476035 -0700
+++ new/src/java.base/share/classes/java/util/GregorianCalendar.java 2017-05-03 14:00:48.125470498 -0700
@@ -159,88 +159,89 @@
* undefined. GregorianCalendar uses the following
* default value for each calendar field if its value is undefined.
*
- *
- *
+ *
+ * GregorianCalendar default field values
+ *
*
- * Field
+ * |
+ * Field
* |
- * Default Value
+ * |
+ Default Value
* |
*
+ *
+ *
*
- *
- * ERA
+ * |
+ * ERA
* |
- *
- * AD
+ * |
+ * AD
* |
*
*
- *
- * YEAR
+ * |
+ * YEAR
* |
- *
- * 1970
+ * |
+ * 1970
* |
*
*
- *
- * MONTH
+ * |
+ * MONTH
* |
- *
- * JANUARY
+ * |
+ * JANUARY
* |
*
*
- *
- * DAY_OF_MONTH
+ * |
+ * DAY_OF_MONTH
* |
- *
- * 1
+ * |
+ * 1
* |
*
*
- *
- * DAY_OF_WEEK
+ * |
+ * DAY_OF_WEEK
* |
- *
- * the first day of week
+ * |
+ * the first day of week
* |
*
*
- *
- * WEEK_OF_MONTH
+ * |
+ * WEEK_OF_MONTH
* |
- *
- * 0
+ * |
+ * 0
* |
*
*
- *
- * DAY_OF_WEEK_IN_MONTH
+ * |
+ * DAY_OF_WEEK_IN_MONTH
* |
- *
- * 1
+ * |
+ * 1
* |
*
*
- *
- * AM_PM
+ * |
+ * AM_PM
* |
- *
- * AM
+ * |
+ * AM
* |
*
*
- *
- * HOUR, HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND
+ * |
+ * HOUR, HOUR_OF_DAY, MINUTE, SECOND, MILLISECOND
* |
- *
- * 0
+ * |
+ * 0
* |
*
*
--- old/src/java.base/share/classes/java/util/Locale.java 2017-05-03 14:00:48.757497835 -0700
+++ new/src/java.base/share/classes/java/util/Locale.java 2017-05-03 14:00:48.629492299 -0700
@@ -1587,44 +1587,50 @@
*
* Grandfathered tags with canonical replacements are as follows:
*
- *
+ *
+ * Grandfathered tags with canonical replacements
+ *
+ * grandfathered tag | modern replacement |
+ *
*
- * grandfathered tag | | modern replacement |
- * art-lojban | | jbo |
- * i-ami | | ami |
- * i-bnn | | bnn |
- * i-hak | | hak |
- * i-klingon | | tlh |
- * i-lux | | lb |
- * i-navajo | | nv |
- * i-pwn | | pwn |
- * i-tao | | tao |
- * i-tay | | tay |
- * i-tsu | | tsu |
- * no-bok | | nb |
- * no-nyn | | nn |
- * sgn-BE-FR | | sfb |
- * sgn-BE-NL | | vgt |
- * sgn-CH-DE | | sgg |
- * zh-guoyu | | cmn |
- * zh-hakka | | hak |
- * zh-min-nan | | nan |
- * zh-xiang | | hsn |
+ * art-lojban | jbo |
+ * i-ami | ami |
+ * i-bnn | bnn |
+ * i-hak | hak |
+ * i-klingon | tlh |
+ * i-lux | lb |
+ * i-navajo | nv |
+ * i-pwn | pwn |
+ * i-tao | tao |
+ * i-tay | tay |
+ * i-tsu | tsu |
+ * no-bok | nb |
+ * no-nyn | nn |
+ * sgn-BE-FR | sfb |
+ * sgn-BE-NL | vgt |
+ * sgn-CH-DE | sgg |
+ * zh-guoyu | cmn |
+ * zh-hakka | hak |
+ * zh-min-nan | nan |
+ * zh-xiang | hsn |
*
*
*
* Grandfathered tags with no modern replacement will be
* converted as follows:
*
- *
+ *
+ * Grandfathered tags with no modern replacement
+ *
+ * grandfathered tag | converts to |
+ *
*
- * grandfathered tag | | converts to |
- * cel-gaulish | | xtg-x-cel-gaulish |
- * en-GB-oed | | en-GB-x-oed |
- * i-default | | en-x-i-default |
- * i-enochian | | und-x-i-enochian |
- * i-mingo | | see-x-i-mingo |
- * zh-min | | nan-x-zh-min |
+ * cel-gaulish | xtg-x-cel-gaulish |
+ * en-GB-oed | en-GB-x-oed |
+ * i-default | en-x-i-default |
+ * i-enochian | und-x-i-enochian |
+ * i-mingo | see-x-i-mingo |
+ * zh-min | nan-x-zh-min |
*
*
*
@@ -2767,12 +2773,16 @@
*
* The filtering method will behave as follows:
*
- *
+ *
+ * Filtering method behavior
+ *
*
* Filtering Mode |
* Language Priority List: {@code "de-DE"} |
* Language Priority List: {@code "de-*-DE"} |
*
+ *
+ *
*
*
* {@link FilteringMode#AUTOSELECT_FILTERING AUTOSELECT_FILTERING}
@@ -2832,6 +2842,7 @@
* not a valid basic language range.
* |
*
+ *
*
*
* @see #filter(List, Collection, FilteringMode)
--- old/src/java.base/share/classes/java/util/Queue.java 2017-05-03 14:00:49.265519810 -0700
+++ new/src/java.base/share/classes/java/util/Queue.java 2017-05-03 14:00:49.133514100 -0700
@@ -47,7 +47,7 @@
* implementations; in most implementations, insert operations cannot
* fail.
*
- *
+ *
* Summary of Queue methods
*
* |
--- old/src/java.base/share/classes/java/util/ResourceBundle.java 2017-05-03 14:00:49.673537458 -0700
+++ new/src/java.base/share/classes/java/util/ResourceBundle.java 2017-05-03 14:00:49.541531749 -0700
@@ -1222,12 +1222,15 @@
* Calling getBundle with the locale arguments below will
* instantiate resource bundles as follows:
*
- *
+ *
+ * getBundle() locale to resource bundle mapping
+ *
* Locale("fr", "CH") | MyResources_fr_CH.class, parent MyResources_fr.properties, parent MyResources.class |
* Locale("fr", "FR") | MyResources_fr.properties, parent MyResources.class |
* Locale("de", "DE") | MyResources_en.properties, parent MyResources.class |
* Locale("en", "US") | MyResources_en.properties, parent MyResources.class |
* Locale("es", "ES") | MyResources_es_ES.class, parent MyResources.class |
+ *
*
*
* The file MyResources_fr_CH.properties is never used because it is
@@ -1311,9 +1314,9 @@
* sequence of locale-format combinations to be used to call
* control.newBundle .
*
- *
- *
+ *
+ * locale-format combinations for newBundle
+ *
*
* Locale
@@ -1322,6 +1325,8 @@
* style="vertical-align: top; text-align: left; font-weight: bold; width: 50%;">format
* |
*
+ *
+ *
*
* Locale("de", "DE")
* |
--- old/src/java.base/share/classes/java/util/concurrent/BlockingDeque.java 2017-05-03 14:00:50.169558913 -0700
+++ new/src/java.base/share/classes/java/util/concurrent/BlockingDeque.java 2017-05-03 14:00:50.037553203 -0700
@@ -53,7 +53,7 @@
* and the fourth blocks for only a given maximum time limit before giving
* up. These methods are summarized in the following table:
*
- *
+ *
* Summary of BlockingDeque methods
*
* First Element (Head) |
@@ -128,7 +128,7 @@
* {@code BlockingQueue} interface are precisely equivalent to
* {@code BlockingDeque} methods as indicated in the following table:
*
- *
+ *
* Comparison of BlockingQueue and BlockingDeque methods
*
* {@code BlockingQueue} Method |
--- old/src/java.base/share/classes/java/util/concurrent/BlockingQueue.java 2017-05-03 14:00:50.561575869 -0700
+++ new/src/java.base/share/classes/java/util/concurrent/BlockingQueue.java 2017-05-03 14:00:50.457571371 -0700
@@ -53,7 +53,7 @@
* and the fourth blocks for only a given maximum time limit before giving
* up. These methods are summarized in the following table:
*
- *
+ *
* Summary of BlockingQueue methods
*
* |
--- old/src/java.base/share/classes/java/util/concurrent/ForkJoinPool.java 2017-05-03 14:00:51.017595594 -0700
+++ new/src/java.base/share/classes/java/util/concurrent/ForkJoinPool.java 2017-05-03 14:00:50.881589711 -0700
@@ -109,7 +109,7 @@
* async event-style tasks that are not usually joined, in which case
* there is little difference among choice of methods.
*
- *
+ *
* Summary of task execution methods
*
* |
--- old/src/java.base/share/classes/java/util/regex/Pattern.java 2017-05-03 14:00:51.489616011 -0700
+++ new/src/java.base/share/classes/java/util/regex/Pattern.java 2017-05-03 14:00:51.357610301 -0700
@@ -79,13 +79,15 @@
*
*
*
- *
- *
+ *
+ * Regular expression constructs, and what they match
+ *
*
* Construct |
* Matches |
*
+ *
+ *
*
* |
* Characters |
@@ -383,6 +385,7 @@
* {@code (?>}X{@code )} |
* X, as an independent, non-capturing group |
*
+ *
*
*
*
@@ -429,8 +432,9 @@
* The precedence of character-class operators is as follows, from
* highest to lowest:
*
- *
+ *
+ * Precedence of character class operators.
+ *
* 1 |
* Literal escape |
* {@code \x} |
@@ -446,6 +450,7 @@
* 5 |
* Intersection |
* {@code [a-z&&[aeiou]]} |
+ *
*
*
* Note that a different set of metacharacters are in effect inside
@@ -496,7 +501,9 @@
* left to right. In the expression {@code ((A)(B(C)))}, for example, there
* are four such groups:
*
- *
+ *
+ * Capturing group numberings
+ *
* 1 |
* {@code ((A)(B(C)))} |
* 2 |
@@ -505,6 +512,7 @@
* {@code (B(C))} |
* 4 |
* {@code (C)} |
+ *
*
*
* Group zero always stands for the entire expression.
@@ -641,12 +649,15 @@
* of Unicode Regular Expression
* , when {@link #UNICODE_CHARACTER_CLASS} flag is specified.
*
- *
+ *
+ * predefined and posix character classes in Unicode mode
+ *
*
* Classes |
* Matches |
- *
+ *
+ *
+ *
* {@code \p{Lower}} |
* A lowercase character:{@code \p{IsLowercase}} |
* {@code \p{Upper}} |
@@ -685,6 +696,7 @@
* A word character: {@code [\p{Alpha}\p{gc=Mn}\p{gc=Me}\p{gc=Mc}\p{Digit}\p{gc=Pc}\p{IsJoin_Control}]} |
* {@code \W} |
* A non-word character: {@code [^\w]} |
+ *
*
*
*
@@ -1207,11 +1219,14 @@
* The input {@code "boo:and:foo"}, for example, yields the following
* results with these parameters:
*
- *
+ *
+ * Split examples showing regex, limit, and result
+ *
* Regex |
* Limit |
* Result |
+ *
+ *
* : |
* 2 |
* {@code { "boo", "and:foo" }} |
@@ -1230,6 +1245,7 @@
* o |
* 0 |
* {@code { "b", "", ":and:f" }} |
+ *
*
*
* @param input
@@ -1294,14 +1310,18 @@
* The input {@code "boo:and:foo"}, for example, yields the following
* results with these expressions:
*
- *
+ *
+ * Split examples showing regex and result
+ *
* Regex |
* Result |
+ *
+ *
* : |
* {@code { "boo", "and", "foo" }} |
* o |
* {@code { "b", "", ":and:f" }} |
+ *
*
*
*
--- old/src/java.base/share/classes/java/util/spi/CalendarNameProvider.java 2017-05-03 14:00:52.001638158 -0700
+++ new/src/java.base/share/classes/java/util/spi/CalendarNameProvider.java 2017-05-03 14:00:51.865632275 -0700
@@ -46,12 +46,16 @@
* Calendar}. The following are calendar-common fields and their values to be
* supported for each calendar system.
*
- *
+ *
+ * Field values
+ *
*
* Field |
* Value |
* Description |
*
+ *
+ *
*
* {@link Calendar#MONTH} |
* {@link Calendar#JANUARY} to {@link Calendar#UNDECIMBER} |
@@ -73,17 +77,22 @@
* {@link Calendar#AM} to {@link Calendar#PM} |
* 0 - AM, 1 - PM |
*
+ *
*
*
* The following are calendar-specific fields and their values to be supported.
*
- *
+ *
+ * Calendar type and field values
+ *
*
* Calendar Type |
* Field |
* Value |
* Description |
*
+ *
+ *
*
* {@code "gregory"} |
* {@link Calendar#ERA} |
@@ -154,6 +163,7 @@
* 1 |
* Anno Hijrah (AH) |
*
+ *
*
*
* Calendar field value names for {@code "gregory"} must be consistent with
--- old/src/java.base/share/classes/javax/net/ssl/SSLPermission.java 2017-05-03 14:00:52.365653903 -0700
+++ new/src/java.base/share/classes/javax/net/ssl/SSLPermission.java 2017-05-03 14:00:52.265649577 -0700
@@ -44,14 +44,17 @@
* and for each provides a description of what the permission allows
* and a discussion of the risks of granting code the permission.
*
- *
+ *
+ * permission name, what it allows, and associated risks
+ *
*
* Permission Target Name |
* What the Permission Allows |
* Risks of Allowing this Permission |
*
+ *
*
+ *
*
* setHostnameVerifier |
* The ability to set a callback which can decide whether to
@@ -84,6 +87,7 @@
* |
*
*
+ *
*
*
* @see java.security.BasicPermission
|
---|
|
---|
|