--- old/src/java.base/share/classes/jdk/internal/util/xml/impl/Parser.java 2015-05-15 20:25:02.646444044 +0400
+++ new/src/java.base/share/classes/jdk/internal/util/xml/impl/Parser.java 2015-05-15 20:25:02.498444044 +0400
@@ -1841,10 +1841,12 @@
/**
* Reads an attribute value.
*
- * The grammar which this method can read is:
- * eqstr := S "=" qstr
- * qstr := S ("'" string "'") |
- * ('"' string '"')
This method resolves entities
+ * The grammar which this method can read is:
+ *
{@code + * eqstr := S "=" qstr + * qstr := S ("'" string "'") | ('"' string '"') + * }+ * This method resolves entities * inside a string unless the parser parses DTD. * * @param flag The '=' character forces the method to accept the '=' @@ -3290,16 +3292,20 @@ } /** - * Maps a character to it's type. + * Maps a character to its type. * - * Possible character type values are:
+ * lock until the state variable equals its desired value. * * @author Peter King */ --- old/src/java.base/share/classes/sun/misc/ExtensionDependency.java 2015-05-15 20:25:05.174444041 +0400 +++ new/src/java.base/share/classes/sun/misc/ExtensionDependency.java 2015-05-15 20:25:05.026444042 +0400 @@ -106,7 +106,7 @@ *
* Checks the dependencies of the jar file on installed extension. *
- * @param jarFile containing the attriutes declaring the dependencies + * @param jar containing the attriutes declaring the dependencies */ public static boolean checkExtensionsDependencies(JarFile jar) { --- old/src/java.base/share/classes/sun/misc/ExtensionInfo.java 2015-05-15 20:25:05.678444041 +0400 +++ new/src/java.base/share/classes/sun/misc/ExtensionInfo.java 2015-05-15 20:25:05.526444041 +0400 @@ -45,9 +45,7 @@ public class ExtensionInfo { /** - ** public static values returned by the isCompatible method - *
*/ public static final int COMPATIBLE = 0; public static final int REQUIRE_SPECIFICATION_UPGRADE = 1; @@ -56,10 +54,8 @@ public static final int INCOMPATIBLE = 4; /** - ** attributes fully describer an extension. The underlying described * extension may be installed and requested. - *
*/ public String title; public String name; @@ -76,15 +72,12 @@ /** - *
* Create a new uninitialized extension information object - *
*/ public ExtensionInfo() { } /** - ** Create and initialize an extension information object. * The initialization uses the attributes passed as being * the content of a manifest file to load the extension @@ -93,7 +86,7 @@ * extension they may depend on, the extension key parameter * is prepanded to the attribute name to make the key used * to retrieve the attribute from the manifest file - *
+ * * @param extensionKey unique extension key in the manifest * @param attr Attributes of a manifest file */ @@ -149,13 +142,11 @@ } /** - *
* @return true if the extension described by this extension information * is compatible with the extension described by the extension * information passed as a parameter - *
* - * @param the requested extension information to compare to + * @param ei the requested extension information to compare to */ public int isCompatibleWith(ExtensionInfo ei) { @@ -204,10 +195,8 @@ } /** - ** helper method to print sensible information on the undelying described * extension - *
*/ public String toString() { return "Extension : title(" + title + "), name(" + name + "), spec vendor(" + @@ -217,15 +206,15 @@ } /* - ** helper method to compare two versions. * version are in the x.y.z.t pattern. - *
+ * * @param source version to compare to * @param target version used to compare against - * @return < 0 if source < version - * > 0 if source > version - * = 0 if source = version + * @return{@code + * < 0 if source < version + * > 0 if source > version + * = 0 if source = version}*/ private int compareExtensionVersion(String source, String target) throws NumberFormatException @@ -238,15 +227,15 @@ /* - *
* helper method to compare two versions. * version are in the x.y.z.t pattern. - *
+ * * @param source version to compare to * @param target version used to compare against - * @return < 0 if source < version - * > 0 if source > version - * = 0 if source = version + * @return{@code + * < 0 if source < version + * > 0 if source > version + * = 0 if source = version}*/ private int strictCompareExtensionVersion(String source, String target) throws NumberFormatException --- old/src/java.base/share/classes/sun/misc/FDBigInteger.java 2015-05-15 20:25:06.178444041 +0400 +++ new/src/java.base/share/classes/sun/misc/FDBigInteger.java 2015-05-15 20:25:06.030444041 +0400 @@ -384,8 +384,8 @@ * Retrieves the normalization bias of the
FDBigIntger
. The
* normalization bias is a left shift such that after it the highest word
* of the value will have the 4 highest bits equal to zero:
- * (highestWord & 0xf0000000) == 0
, but the next bit should be 1
- * (highestWord & 0x08000000) != 0
.
+ * {@code (highestWord & 0xf0000000) == 0}, but the next bit should be 1
+ * {@code (highestWord & 0x08000000) != 0}.
*
* @return The normalization bias.
*/
@@ -546,9 +546,9 @@
* We assume that S has been normalized, as above, and that
* "this" has been left-shifted accordingly.
* Also assumed, of course, is that the result, q, can be expressed
- * as an integer, 0 <= q < 10.
+ * as an integer, {@code 0 <= q < 10}.
*
- * @param The divisor of this FDBigInteger
.
+ * @param S The divisor of this FDBigInteger
.
* @return q = (int)(this / S)
.
*/
/*@
@@ -685,7 +685,7 @@
*
* @param p5 The exponent of the power-of-five factor.
* @param p2 The exponent of the power-of-two factor.
- * @return
+ * @return The multiplication result.
*/
/*@
@ requires this.value() == 0 || p5 == 0 && p2 == 0;
@@ -931,11 +931,11 @@
/**
* Compares the parameter with this FDBigInteger
. Returns an
* integer accordingly as:
- * - * >0: this > other - * 0: this == other - * <0: this < other - *+ *
{@code + * > 0: this > other + * 0: this == other + * < 0: this < other + * }* * @param other The
FDBigInteger
to compare.
* @return A negative value, zero, or a positive value according to the
@@ -974,11 +974,11 @@
* Compares this FDBigInteger
with
* 5p5 * 2p2
.
* Returns an integer accordingly as:
- * - * >0: this > other - * 0: this == other - * <0: this < other - *+ *
{@code + * > 0: this > other + * 0: this == other + * < 0: this < other + * }* @param p5 The exponent of the power-of-five factor. * @param p2 The exponent of the power-of-two factor. * @return A negative value, zero, or a positive value according to the @@ -1011,11 +1011,11 @@ /** * Compares this
FDBigInteger
with x + y
. Returns a
* value according to the comparison as:
- * + ** @param x The first addend of the sum to compare. * @param y The second addend of the sum to compare. * @return -1, 0, or 1 according to the result of the comparison. --- old/src/java.base/share/classes/sun/misc/FloatingDecimal.java 2015-05-15 20:25:06.690444040 +0400 +++ new/src/java.base/share/classes/sun/misc/FloatingDecimal.java 2015-05-15 20:25:06.542444040 +0400 @@ -154,7 +154,7 @@ /** * Indicates the sign of the value. - * @return{@code * -1: this < x + y * 0: this == x + y * 1: this > x + y - *+ * }
value < 0.0
.
+ * @return {@code value < 0.0}.
*/
public boolean isNegative();
--- old/src/java.base/share/classes/sun/misc/IOUtils.java 2015-05-15 20:25:07.278444040 +0400
+++ new/src/java.base/share/classes/sun/misc/IOUtils.java 2015-05-15 20:25:07.130444040 +0400
@@ -39,7 +39,7 @@
/**
* Read up to length
of bytes from in
* until EOF is detected.
- * @param in input stream, must not be null
+ * @param is input stream, must not be null
* @param length number of bytes to read, -1 or Integer.MAX_VALUE means
* read as much as possible
* @param readAll if true, an EOFException will be thrown if not enough
--- old/src/java.base/share/classes/sun/misc/JarFilter.java 2015-05-15 20:25:07.842444039 +0400
+++ new/src/java.base/share/classes/sun/misc/JarFilter.java 2015-05-15 20:25:07.690444039 +0400
@@ -29,10 +29,8 @@
import java.io.FilenameFilter;
/**
- * * This class checks that only jar and zip files are included in the file list. * This class is used in extension installation support (ExtensionDependency). - *
*
* @deprecated this class will be removed in a future release.
* @author Michael Colburn
--- old/src/java.base/share/classes/sun/misc/JavaLangAccess.java 2015-05-15 20:25:08.338444039 +0400
+++ new/src/java.base/share/classes/sun/misc/JavaLangAccess.java 2015-05-15 20:25:08.186444039 +0400
@@ -91,14 +91,14 @@
* may be added to the delete on exit list by the application shutdown
* hooks.
*
- * @params slot the slot in the shutdown hook array, whose element
- * will be invoked in order during shutdown
- * @params registerShutdownInProgress true to allow the hook
- * to be registered even if the shutdown is in progress.
- * @params hook the hook to be registered
+ * @param slot the slot in the shutdown hook array, whose element
+ * will be invoked in order during shutdown
+ * @param registerShutdownInProgress true to allow the hook
+ * to be registered even if the shutdown is in progress.
+ * @param hook the hook to be registered
*
- * @throw IllegalStateException if shutdown is in progress and
- * the slot is not valid to register.
+ * @throws IllegalStateException if shutdown is in progress and
+ * the slot is not valid to register.
*/
void registerShutdownHook(int slot, boolean registerShutdownInProgress, Runnable hook);
--- old/src/java.base/share/classes/sun/misc/Perf.java 2015-05-15 20:25:08.834444038 +0400
+++ new/src/java.base/share/classes/sun/misc/Perf.java 2015-05-15 20:25:08.686444039 +0400
@@ -67,13 +67,13 @@
* AccessController.doPrivileged(PrivilegedAction)
.
*
Here is a suggested idiom for use of this class: * - *
*+ *+ * }{@code * class MyTrustedClass { * private static final Perf perf = * AccessController.doPrivileged(new Perf.GetPerfAction()); * ... * } - *
* In the presence of a security manager, the MyTrustedClass
* class in the above example will need to be granted the
@@ -171,8 +171,7 @@
* The attach mode specifies the access permissions requested for the
* instrumentation buffer of the target virtual machine. The permitted
* access permissions are:
- *
- *
* To automatically track startup performance in an app or applet,
* use the command-line parameter sun.perflog as follows:
* By default, times are measured using System.currentTimeMillis(). To use
--- old/src/java.base/share/classes/sun/misc/Resource.java 2015-05-15 20:25:10.338444037 +0400
+++ new/src/java.base/share/classes/sun/misc/Resource.java 2015-05-15 20:25:10.186444037 +0400
@@ -154,7 +154,8 @@
/**
* Returns the Resource data as a ByteBuffer, but only if the input stream
- * was implemented on top of a ByteBuffer. Return null otherwise.
+ * was implemented on top of a ByteBuffer. Return {@code null} otherwise.
+ * @return Resource data or null.
*/
public ByteBuffer getByteBuffer() throws IOException {
InputStream in = cachedInputStream();
--- old/src/java.base/share/classes/sun/misc/Signal.java 2015-05-15 20:25:10.914444037 +0400
+++ new/src/java.base/share/classes/sun/misc/Signal.java 2015-05-15 20:25:10.766444037 +0400
@@ -50,7 +50,7 @@
* Signal objects are created based on their names. For example:
*
* 8-byte atomicity is only guaranteed on platforms on which
* support atomic accesses to longs.
- *
*
* @param o Java heap object in which the value resides, if any, else
* null
--- old/src/java.base/share/classes/sun/misc/VM.java 2015-05-15 20:25:11.994444036 +0400
+++ new/src/java.base/share/classes/sun/misc/VM.java 2015-05-15 20:25:11.842444036 +0400
@@ -315,7 +315,7 @@
}
/*
- * Add n to the objects pending for finalization count.
+ * Add {@code n} to the objects pending for finalization count.
*
* @param n an integer value to be added to the objects pending
* for finalization count
--- old/src/java.base/share/classes/sun/misc/resources/Messages.java 2015-05-15 20:25:12.494444035 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages.java 2015-05-15 20:25:12.346444036 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this This class represents the
+ *
* @return the contents of this
*
- * Some of the API methods provide access to "runs". Such a
- * "run" is defined as a sequence of characters that are at the same
+ * Some of the API methods provide access to "runs". Such a
+ * "run" is defined as a sequence of characters that are at the same
* embedding level after performing the Bidi algorithm.
- *
*
* See Also:
+ * See Also:
+ * See Also:
+ *
+ * the same value in such a case.
*
* @param paragraph a paragraph of text with optional character and
* paragraph attribute information
@@ -2817,7 +2819,7 @@
}
/**
- * Get the index of a paragraph, given a position within the text.
+ * Get the index of a paragraph, given a position within the text.
*
* @param charIndex is the index of a character within the text, in the
* range A BidiRun represents such a run by storing its essential properties,
* but does not duplicate the characters which form the run.
--- old/src/java.base/share/classes/sun/text/normalizer/ICUBinary.java 2015-05-15 20:25:21.006444028 +0400
+++ new/src/java.base/share/classes/sun/text/normalizer/ICUBinary.java 2015-05-15 20:25:20.854444029 +0400
@@ -65,7 +65,7 @@
/**
* ICU data header reader method.
* Takes a ICU generated big-endian input stream, parse the ICU standard
- * file header and authenticates them. Header format:
*
*
+ * {@code
* -Dsun.perflog[=file:
*
* where simply using the parameter with no value will enable output
- * to the console and a value of "file:
+ *
* constructs a signal object corresponding to
* new Signal("INT");
- *
SIGINT
, which is
* typically produced when the user presses Ctrl-C
at the command line.
* The Signal
constructor throws IllegalArgumentException
@@ -64,7 +64,7 @@
* }
* };
* Signal.handle(new Signal("INT"), handler);
- *
+ *
*
* @author Sheng Liang
* @author Bill Shannon
@@ -149,7 +149,7 @@
*
* @param sig a signal
* @param handler the handler to be registered with the given signal.
- * @result the old handler
+ * @return the old handler
* @exception IllegalArgumentException the signal is in use by the VM
* @see sun.misc.Signal#raise(Signal sig)
* @see sun.misc.SignalHandler
--- old/src/java.base/share/classes/sun/misc/Unsafe.java 2015-05-15 20:25:11.478444036 +0400
+++ new/src/java.base/share/classes/sun/misc/Unsafe.java 2015-05-15 20:25:11.326444036 +0400
@@ -641,9 +641,9 @@
* ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_de.java 2015-05-15 20:25:12.994444035 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_de.java 2015-05-15 20:25:12.842444035 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_es.java 2015-05-15 20:25:13.494444035 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_es.java 2015-05-15 20:25:13.346444035 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_fr.java 2015-05-15 20:25:13.990444034 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_fr.java 2015-05-15 20:25:13.842444034 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_it.java 2015-05-15 20:25:14.490444034 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_it.java 2015-05-15 20:25:14.342444034 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_ja.java 2015-05-15 20:25:14.990444033 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_ja.java 2015-05-15 20:25:14.838444034 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_ko.java 2015-05-15 20:25:15.486444033 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_ko.java 2015-05-15 20:25:15.334444033 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_pt_BR.java 2015-05-15 20:25:15.982444033 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_pt_BR.java 2015-05-15 20:25:15.834444033 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_sv.java 2015-05-15 20:25:16.478444032 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_sv.java 2015-05-15 20:25:16.330444032 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_zh_CN.java 2015-05-15 20:25:16.978444032 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_zh_CN.java 2015-05-15 20:25:16.826444032 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/misc/resources/Messages_zh_TW.java 2015-05-15 20:25:17.474444031 +0400
+++ new/src/java.base/share/classes/sun/misc/resources/Messages_zh_TW.java 2015-05-15 20:25:17.326444031 +0400
@@ -26,7 +26,7 @@
package sun.misc.resources;
/**
- * ResourceBundle
+ * This class represents the ResourceBundle
* for sun.misc.
*
* @author Michael Colburn
@@ -36,7 +36,7 @@
/**
* Returns the contents of this ResourceBundle
.
- * ResourceBundle
.
*/
public Object[][] getContents() {
--- old/src/java.base/share/classes/sun/nio/cs/Surrogate.java 2015-05-15 20:25:17.974444031 +0400
+++ new/src/java.base/share/classes/sun/nio/cs/Surrogate.java 2015-05-15 20:25:17.822444031 +0400
@@ -175,10 +175,10 @@
* @param in The source buffer, from which one more character
* will be consumed if c is a high surrogate
*
- * @returns Either a parsed UCS-4 character, in which case the isPair()
- * and increment() methods will return meaningful values, or
- * -1, in which case error() will return a descriptive result
- * object
+ * @return Either a parsed UCS-4 character, in which case the isPair()
+ * and increment() methods will return meaningful values, or
+ * -1, in which case error() will return a descriptive result
+ * object
*/
public int parse(char c, CharBuffer in) {
if (Character.isHighSurrogate(c)) {
@@ -216,10 +216,10 @@
* @param ip The input index
* @param il The input limit
*
- * @returns Either a parsed UCS-4 character, in which case the isPair()
- * and increment() methods will return meaningful values, or
- * -1, in which case error() will return a descriptive result
- * object
+ * @return Either a parsed UCS-4 character, in which case the isPair()
+ * and increment() methods will return meaningful values, or
+ * -1, in which case error() will return a descriptive result
+ * object
*/
public int parse(char c, char[] ia, int ip, int il) {
assert (ia[ip] == c);
@@ -280,9 +280,9 @@
* @param dst The destination buffer, to which one or two UTF-16
* characters will be written
*
- * @returns Either a positive count of the number of UTF-16 characters
- * written to the destination buffer, or -1, in which case
- * error() will return a descriptive result object
+ * @return Either a positive count of the number of UTF-16 characters
+ * written to the destination buffer, or -1, in which case
+ * error() will return a descriptive result object
*/
public int generate(int uc, int len, CharBuffer dst) {
if (Character.isBmpCodePoint(uc)) {
@@ -325,9 +325,9 @@
* @param dp The destination position
* @param dl The destination limit
*
- * @returns Either a positive count of the number of UTF-16 characters
- * written to the destination buffer, or -1, in which case
- * error() will return a descriptive result object
+ * @return Either a positive count of the number of UTF-16 characters
+ * written to the destination buffer, or -1, in which case
+ * error() will return a descriptive result object
*/
public int generate(int uc, int len, char[] da, int dp, int dl) {
if (Character.isBmpCodePoint(uc)) {
--- old/src/java.base/share/classes/sun/text/CompactByteArray.java 2015-05-15 20:25:18.474444031 +0400
+++ new/src/java.base/share/classes/sun/text/CompactByteArray.java 2015-05-15 20:25:18.326444031 +0400
@@ -49,7 +49,7 @@
* Han ideographs have the same value. However, lookup is much faster than a
* hash table.
* A compact array of any primitive data type serves two purposes:
- *
+ *
*
--- old/src/java.base/share/classes/sun/text/ComposedCharIter.java 2015-05-15 20:25:18.974444030 +0400
+++ new/src/java.base/share/classes/sun/text/ComposedCharIter.java 2015-05-15 20:25:18.826444030 +0400
@@ -50,7 +50,7 @@
}
/**
- * Construct a new ComposedCharIter. The iterator will return
+ * Construct a new {@code ComposedCharIter}. The iterator will return
* all Unicode characters with canonical decompositions, excluding Korean
* Hangul characters.
*/
@@ -58,10 +58,10 @@
/**
* Returns the next precomposed Unicode character.
- * Repeated calls to next return all of the precomposed characters defined
+ * Repeated calls to {@code next} return all of the precomposed characters defined
* by Unicode, in ascending order. After all precomposed characters have
- * been returned, {@link #hasNext} will return false and further calls
- * to next will return {@link #DONE}.
+ * been returned, {@link #hasNext} will return {@code false} and further calls
+ * to {@code next} will return {@link #DONE}.
*/
public int next() {
if (curChar == decompNum - 1) {
--- old/src/java.base/share/classes/sun/text/Normalizer.java 2015-05-15 20:25:19.474444030 +0400
+++ new/src/java.base/share/classes/sun/text/Normalizer.java 2015-05-15 20:25:19.322444030 +0400
@@ -32,7 +32,7 @@
* This Normalizer is for Unicode 3.2 support for IDNA only.
* Developers should not use this class.
*
- * @ since 1.6
+ * @since 1.6
*/
public final class Normalizer {
--- old/src/java.base/share/classes/sun/text/bidi/BidiBase.java 2015-05-15 20:25:19.970444029 +0400
+++ new/src/java.base/share/classes/sun/text/bidi/BidiBase.java 2015-05-15 20:25:19.818444029 +0400
@@ -81,14 +81,13 @@
*
* General remarks about the API:
*
- * The "limit" of a sequence of characters is the position just after
+ * The "limit" of a sequence of characters is the position just after
* their last character, i.e., one more than that position.
* Basic concept: paragraph
* A piece of text can be divided into several paragraphs by characters
@@ -141,7 +140,8 @@
* these special values are designed that way. Also, the implementation
* assumes that MAX_EXPLICIT_LEVEL is odd.
*
- * See Also:
+ *
*
See Also:
+ *
*
Basic concept: Reordering Options
* Reordering options can be applied during Bidi text transformations.
- * See Also:
+ *
*
*
- *
+ *
*/
public class BidiBase {
@@ -2419,9 +2421,9 @@
* (same index) character if the level has the
* {@code
*
* package com.ibm.icu.dev.test.bidi;
*
@@ -451,7 +453,7 @@
* }
* }
*
- *
+ * }LEVEL_OVERRIDE
bit set.
* Except for that bit, it must be
- * paraLevel<=embeddingLevels[]<=MAX_EXPLICIT_LEVEL
,
+ * {@code paraLevel<=embeddingLevels[]<=MAX_EXPLICIT_LEVEL},
* with one exception: a level of zero may be specified for a
- * paragraph separator even if paraLevel>0
when multiple
+ * paragraph separator even if {@code paraLevel > 0} when multiple
* paragraphs are submitted in the same call to setPara()
.
* Caution: A reference to this array, not a copy
* of the levels, will be stored in the Bidi
object;
@@ -2680,7 +2682,7 @@
* For example, in pure LTR text with numbers the numbers would get
* a resolved level of 2 higher than the surrounding text according to
* the algorithm. This implementation may set all resolved levels to
- * the same value in such a case.[0..getProcessedLength()-1]
.
--- old/src/java.base/share/classes/sun/text/bidi/BidiRun.java 2015-05-15 20:25:20.510444029 +0400
+++ new/src/java.base/share/classes/sun/text/bidi/BidiRun.java 2015-05-15 20:25:20.358444029 +0400
@@ -42,7 +42,7 @@
/**
* A BidiRun represents a sequence of characters at the same embedding level.
* The Bidi algorithm decomposes a piece of text into sequences of characters
- * at the same embedding level, each such sequence is called a run
.
+ * at the same embedding level, each such sequence is called a "run".
*
*
*
- *
* Example of use:
*
@@ -98,7 +98,7 @@ * System.out.println("This is not a ICU data file"); * } *- * + * * @param inputStream input stream that contains the ICU data header * @param dataFormatIDExpected Data format expected. An array of 4 bytes * information about the data format. --- old/src/java.base/share/classes/sun/text/normalizer/IntTrie.java 2015-05-15 20:25:21.574444028 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/IntTrie.java 2015-05-15 20:25:21.422444028 +0400 @@ -58,7 +58,7 @@ * trie. * @param inputStream file input stream to a ICU data file, containing * the trie - * @param dataManipulate object which provides methods to parse the char + * @param datamanipulate object which provides methods to parse the char * data * @throws IOException thrown when data reading fails * @draft 2.1 --- old/src/java.base/share/classes/sun/text/normalizer/NormalizerBase.java 2015-05-15 20:25:22.138444028 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/NormalizerBase.java 2015-05-15 20:25:21.986444028 +0400 @@ -55,16 +55,16 @@ * In Unicode, this can be encoded as a single character (the * "composed" form): * - *
+ *
* 00C1 LATIN CAPITAL LETTER A WITH ACUTE - * + ** * or as two separate characters (the "decomposed" form): * - *
+ *
* 0041 LATIN CAPITAL LETTER A * 0301 COMBINING ACUTE ACCENT - * + ** * To a user of your program, however, both of these sequences should be * treated as the same "user-level" character "A with acute accent". When you @@ -76,17 +76,17 @@ * * Similarly, the string "ffi" can be encoded as three separate letters: * - *
+ *
* 0066 LATIN SMALL LETTER F * 0066 LATIN SMALL LETTER F * 0069 LATIN SMALL LETTER I - * + ** * or as the single character * - *
+ *
* FB03 LATIN SMALL LIGATURE FFI - * + ** * The ffi ligature is not a distinct semantic character, and strictly speaking * it shouldn't be in Unicode at all, but it was included for compatibility @@ -555,12 +555,12 @@ //------------------------------------------------------------------------- /** - * Creates a new Normalizer object for iterating over the + * Creates a new {@code Normalizer} object for iterating over the * normalized form of a given string. *
- * The options parameter specifies which optional - * Normalizer features are to be enabled for this object. - *
+ * The {@code options} parameter specifies which optional + * {@code Normalizer} features are to be enabled for this object. + * * @param str The string to be normalized. The normalization * will start at the beginning of the string. * @@ -579,9 +579,9 @@ } /** - * Creates a new Normalizer object for iterating over the + * Creates a new {@code Normalizer} object for iterating over the * normalized form of the given text. - *
+ * * @param iter The input text to be normalized. The normalization * will start at the beginning of the string. * @@ -592,9 +592,9 @@ } /** - * Creates a new Normalizer object for iterating over the + * Creates a new {@code Normalizer} object for iterating over the * normalized form of the given text. - *
+ * * @param iter The input text to be normalized. The normalization * will start at the beginning of the string. * @@ -615,13 +615,13 @@ } /** - * Clones this Normalizer object. All properties of this + * Clones this {@code Normalizer} object. All properties of this * object are duplicated in the new object, including the cloning of any * {@link CharacterIterator} that was passed in to the constructor * or to {@link #setText(CharacterIterator) setText}. * However, the text storage underlying - * the CharacterIterator is not duplicated unless the - * iterator's clone method does so. + * the {@code CharacterIterator} is not duplicated unless the + * iterator's {@code clone} method does so. * @stable ICU 2.8 */ public Object clone() { @@ -791,7 +791,7 @@ //------------------------------------------------------------------------- /** - * Return the current character in the normalized text-> + * Return the current character in the normalized text. * @return The codepoint as an int * @stable ICU 2.8 */ @@ -872,10 +872,10 @@ * while {@link #next} and {@link #previous} iterate through characters * in the normalized output. This means that there is not * necessarily a one-to-one correspondence between characters returned - * by next and previous and the indices passed to and - * returned from setIndex and {@link #getIndex}. - *
- * @param index the desired index in the input text-> + * by {@code next} and {@code previous} and the indices passed to and + * returned from {@code setIndex} and {@link #getIndex}. + * + * @param index the desired index in the input text. * * @return the first normalized character that is the result of iterating * forward starting at the given index. @@ -894,8 +894,8 @@ /** * Retrieve the index of the start of the input text. This is the begin - * index of the CharacterIterator or the start (i.e. 0) of the - * String over which this Normalizer is iterating + * index of the {@code CharacterIterator} or the start (i.e. 0) of the + * {@code String} over which this {@code Normalizer} is iterating * @deprecated ICU 2.2. Use startIndex() instead. * @return The codepoint as an int * @see #startIndex @@ -907,8 +907,8 @@ /** * Retrieve the index of the end of the input text. This is the end index - * of the CharacterIterator or the length of the String - * over which this Normalizer is iterating + * of the {@code CharacterIterator} or the length of the {@code String} + * over which this {@code Normalizer} is iterating * @deprecated ICU 2.2. Use endIndex() instead. * @return The codepoint as an int * @see #endIndex @@ -927,9 +927,9 @@ * Note: This method sets the position in the input, while * {@link #next} and {@link #previous} iterate through characters in the * output. This means that there is not necessarily a one-to-one - * correspondence between characters returned by next and - * previous and the indices passed to and returned from - * setIndex and {@link #getIndex}. + * correspondence between characters returned by {@code next} and + * {@code previous} and the indices passed to and returned from + * {@code setIndex} and {@link #getIndex}. * @return The current iteration position * @stable ICU 2.8 */ @@ -942,9 +942,9 @@ } /** - * Retrieve the index of the end of the input text-> This is the end index - * of the CharacterIterator or the length of the String - * over which this Normalizer is iterating + * Retrieve the index of the end of the input text. This is the end index + * of the {@code CharacterIterator} or the length of the {@code String} + * over which this {@code Normalizer} is iterating * @return The current iteration position * @stable ICU 2.8 */ @@ -963,9 +963,9 @@ * return previously buffers characters in the old normalization mode * until the iteration is able to re-sync at the next base character. * It is safest to call {@link #setText setText()}, {@link #first}, - * {@link #last}, etc. after calling setMode. - *
- * @param newMode the new mode for this Normalizer. + * {@link #last}, etc. after calling {@code setMode}. + * + * @param newMode the new mode for this {@code Normalizer}. * The supported modes are: *
Interface for enabling iteration over sets of Interface for enabling iteration over sets of
+ * {@code The result for each iteration is the consecutive range of
- *
*
Most implementations will be created by factory methods, such as the * character type iterator in UCharacter.getTypeIterator. See example below. - *
+ * * Example of use:* RangeValueIterator iterator = UCharacter.getTypeIterator(); --- old/src/java.base/share/classes/sun/text/normalizer/Replaceable.java 2015-05-15 20:25:23.158444027 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/Replaceable.java 2015-05-15 20:25:23.006444027 +0400 @@ -71,10 +71,9 @@ *
dstStart
and ending at index
* dstStart + (srcLimit-srcStart) - 1
.
*
- * @param srcStart the beginning index to copy, inclusive; 0
- * <= start <= limit
.
+ * @param srcStart the beginning index to copy, inclusive;
+ * {@code 0 <= start <= limit}.
* @param srcLimit the ending index to copy, exclusive;
- * start <= limit <= length()
.
+ * {@code start <= limit <= length()}.
* @param dst the destination array.
* @param dstStart the start offset in the destination array.
* @stable ICU 2.0
--- old/src/java.base/share/classes/sun/text/normalizer/ReplaceableString.java 2015-05-15 20:25:23.658444026 +0400
+++ new/src/java.base/share/classes/sun/text/normalizer/ReplaceableString.java 2015-05-15 20:25:23.506444026 +0400
@@ -109,10 +109,10 @@
* starting at index dstStart
and ending at index
* dstStart + (srcLimit-srcStart) - 1
.
*
- * @param srcStart the beginning index to copy, inclusive; 0
- * <= start <= limit
.
+ * @param srcStart the beginning index to copy, inclusive;
+ * {@code 0 <= start <= limit}.
* @param srcLimit the ending index to copy, exclusive;
- * start <= limit <= length()
.
+ * {@code start <= limit <= length()}.
* @param dst the destination array.
* @param dstStart the start offset in the destination array.
* @stable ICU 2.0
--- old/src/java.base/share/classes/sun/text/normalizer/ReplaceableUCharacterIterator.java 2015-05-15 20:25:24.154444026 +0400
+++ new/src/java.base/share/classes/sun/text/normalizer/ReplaceableUCharacterIterator.java 2015-05-15 20:25:24.006444026 +0400
@@ -150,14 +150,12 @@
}
/**
- * Sets the currentIndex to the specified currentIndex in the text and returns that + * Sets the currentIndex to the specified currentIndex in the text and returns that * single UTF16 character at currentIndex. - * This assumes the text is stored as 16-bit code units.
+ * This assumes the text is stored as 16-bit code units. * @param currentIndex the currentIndex within the text. * @exception IllegalArgumentException is thrown if an invalid currentIndex is * supplied. i.e. currentIndex is out of bounds. - * @return the character at the specified currentIndex or DONE if the specified - * currentIndex is equal to the end of the text. */ public void setIndex(int currentIndex) { if (currentIndex < 0 || currentIndex > replaceable.length()) { --- old/src/java.base/share/classes/sun/text/normalizer/RuleCharacterIterator.java 2015-05-15 20:25:24.654444025 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/RuleCharacterIterator.java 2015-05-15 20:25:24.506444026 +0400 @@ -101,22 +101,25 @@ public static final int DONE = -1; /** - * Bitmask option to enable parsing of variable names. If (options & - * PARSE_VARIABLES) != 0, then an embedded variable will be expanded to + * Bitmask option to enable parsing of variable names. + * If {@code (options & PARSE_VARIABLES) != 0}, + * then an embedded variable will be expanded to * its value. Variables are parsed using the SymbolTable API. */ public static final int PARSE_VARIABLES = 1; /** - * Bitmask option to enable parsing of escape sequences. If (options & - * PARSE_ESCAPES) != 0, then an embedded escape sequence will be expanded + * Bitmask option to enable parsing of escape sequences. + * If {@code (options & PARSE_ESCAPES) != 0}, + * then an embedded escape sequence will be expanded * to its value. Escapes are parsed using Utility.unescapeAt(). */ public static final int PARSE_ESCAPES = 2; /** - * Bitmask option to enable skipping of whitespace. If (options & - * SKIP_WHITESPACE) != 0, then whitespace characters will be silently + * Bitmask option to enable skipping of whitespace. + * If {@code (options & SKIP_WHITESPACE) != 0}, + * then whitespace characters will be silently * skipped, as if they were not present in the input. Whitespace * characters are defined by UCharacterProperty.isRuleWhiteSpace(). */ --- old/src/java.base/share/classes/sun/text/normalizer/SymbolTable.java 2015-05-15 20:25:25.154444025 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/SymbolTable.java 2015-05-15 20:25:25.002444025 +0400 @@ -78,7 +78,7 @@ /** * Lookup the characters associated with this string and return it. - * Return null if no such name exists. The resultant + * Return {@code null} if no such name exists. The resultant * array may have length zero. * @param s the symbolic name to lookup * @return a char array containing the name's value, or null if @@ -91,7 +91,7 @@ /** * Lookup the UnicodeMatcher associated with the given character, and - * return it. Return null if not found. + * return it. Return {@code null} if not found. * @param ch a 32-bit code point from 0 to 0x10FFFF inclusive. * @return the UnicodeMatcher object represented by the given * character, or null if there is no mapping for ch. --- old/src/java.base/share/classes/sun/text/normalizer/Trie.java 2015-05-15 20:25:25.654444025 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/Trie.java 2015-05-15 20:25:25.502444025 +0400 @@ -160,8 +160,10 @@ /** * Lead surrogate code points' index displacement in the index array. + *{@code * 0x10000-0xd800=0x2800 * 0x2800 >> INDEX_STAGE_1_SHIFT_ + * }*/ protected static final int LEAD_INDEX_OFFSET_ = 0x2800 >> 5; /** @@ -191,7 +193,7 @@ /** * Number of index (stage 1) entries per lead surrogate. * Same as number of index entries for 1024 trail surrogates, - * ==0x400>>INDEX_STAGE_1_SHIFT_ + * {@code ==0x400>>INDEX_STAGE_1_SHIFT_} */ protected static final int SURROGATE_BLOCK_COUNT=(1<
Result of each iteration contains the interval of codepoints that have - * the same value type and the value type itself.
+ * the same value type and the value type itself. *The comparison of each codepoint value is done via extract(), which the - * default implementation is to return the value as it is.
+ * default implementation is to return the value as it is. *Method extract() can be overwritten to perform manipulations on - * codepoint values in order to perform specialized comparison.
+ * codepoint values in order to perform specialized comparison. *TrieIterator is designed to be a generic iterator for the CharTrie * and the IntTrie, hence to accommodate both types of data, the return - * result will be in terms of int (32 bit) values.
- *See com.ibm.icu.text.UCharacterTypeIterator for examples of use.
+ * result will be in terms of int (32 bit) values. + *See com.ibm.icu.text.UCharacterTypeIterator for examples of use. *
Notes for porting utrie_enum from icu4c to icu4j:
* Internally, icu4c's utrie_enum performs all iterations in its body. In Java
* sense, the caller will have to pass a object with a callback function
@@ -63,18 +63,17 @@
* the method extract(int) (equivalent to UTrieEnumValue). Independent of icu4j,
* the caller will have to code his own iteration and flesh out the task
* (equivalent to UTrieEnumRange) to be performed in the iteration loop.
- *
There are basically 3 usage scenarios for porting:
+ * + *There are basically 3 usage scenarios for porting: *
1) UTrieEnumValue is the only implemented callback then just implement a * subclass of TrieIterator and override the extract(int) method. The * extract(int) method is analogus to UTrieEnumValue callback. - *
+ * *2) UTrieEnumValue and UTrieEnumRange both are implemented then implement - * a subclass of TrieIterator, override the extract method and iterate, e.g - *
- *utrie_enum(&normTrie, _enumPropertyStartsValue, _enumPropertyStartsRange,
- * set);
- * In Java :
+ * a subclass of TrieIterator, override the extract method and iterate, e.g.
+ * {@code utrie_enum(&normTrie, _enumPropertyStartsValue, _enumPropertyStartsRange,
+ * set);}
+ * In Java:
*
* class TrieIteratorImpl extends TrieIterator{ * public TrieIteratorImpl(Trie data){ @@ -90,17 +89,17 @@ * // port the implementation of _enumPropertyStartsRange * } *- * + * *
3) UTrieEnumRange is the only implemented callback then just implement * the while loop, when utrie_enum is called - *
+ *+ * * @author synwee * @see com.ibm.icu.impl.Trie * @see com.ibm.icu.lang.UCharacterTypeIterator --- old/src/java.base/share/classes/sun/text/normalizer/UCharacter.java 2015-05-15 20:25:26.658444024 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/UCharacter.java 2015-05-15 20:25:26.506444024 +0400 @@ -128,7 +128,7 @@ * Annex C: Compatibility Properties of UTS #18 Unicode Regular Expressions * (http://www.unicode.org/reports/tr18/#Compatibility_Properties). * - *{@code * // utrie_enum(&fcdTrie, NULL, _enumPropertyStartsRange, set); * TrieIterator fcdIter = new TrieIterator(fcdTrieImpl.fcdTrie); * while(fcdIter.next(result)){ * set.add(result.start); * } - *- * + * }
+ *
{@code * API access for C/POSIX character classes is as follows: * - alpha: isUAlphabetic(c) or hasBinaryProperty(c, UProperty.ALPHABETIC) * - lower: isULowercase(c) or hasBinaryProperty(c, UProperty.LOWERCASE) @@ -142,7 +142,7 @@ * - cntrl: getType(c)==CONTROL * - graph: hasBinaryProperty(c, UProperty.POSIX_GRAPH) * - print: hasBinaryProperty(c, UProperty.POSIX_PRINT) - * + * }*
* The C/POSIX character classes are also available in UnicodeSet patterns,
* using patterns like [:graph:] or \p{graph}.
--- old/src/java.base/share/classes/sun/text/normalizer/UCharacterIterator.java 2015-05-15 20:25:27.162444023 +0400
+++ new/src/java.base/share/classes/sun/text/normalizer/UCharacterIterator.java 2015-05-15 20:25:27.010444024 +0400
@@ -200,8 +200,7 @@
* iterator obtained by calling getLength()
.
* Usage:
*
- *
- *
+ * }
*
* @param fillIn an array of chars to fill with the underlying UTF-16 code
* units.
* @param offset the position within the array to start putting the data.
* @return the number of code units added to fillIn, as a convenience
* @exception IndexOutOfBounds exception if there is not enough
- * room after offset in the array, or if offset < 0.
+ * room after offset in the array, or if offset {@literal <} 0.
* @stable ICU 2.4
*/
public abstract int getText(char[] fillIn, int offset);
--- old/src/java.base/share/classes/sun/text/normalizer/UTF16.java 2015-05-15 20:25:27.662444023 +0400
+++ new/src/java.base/share/classes/sun/text/normalizer/UTF16.java 2015-05-15 20:25:27.510444023 +0400
@@ -38,26 +38,26 @@
/**
*
+ *
{@code
* UChacterIterator iter = new UCharacterIterator.getInstance(text);
* char[] buf = new char[iter.getLength()];
* iter.getText(buf);
@@ -217,15 +216,14 @@
* buf = new char[iter.getLength()];
* }
* }
- *
- *
Standalone utility class providing UTF16 character conversions and - * indexing conversions.
+ * indexing conversions. *Code that uses strings alone rarely need modification.
* By design, UTF-16 does not allow overlap, so searching for strings is a safe
* operation. Similarly, concatenation is always safe. Substringing is safe if
* the start and end are both on UTF-32 boundaries. In normal code, the values
* for start and end are on those boundaries, since they arose from operations
* like searching. If not, the nearest UTF-32 boundaries can be determined
- * using bounds()
.
bounds()
.
* Examples:
* The following examples illustrate use of some of these methods. - *
+ ** Notes: *{@code * // iteration forwards: Original - * for (int i = 0; i < s.length(); ++i) { + * for (int i = 0; i < s.length(); ++i) { * char ch = s.charAt(i); * doSomethingWith(ch); * } * * // iteration forwards: Changes for UTF-32 * int ch; - * for (int i = 0; i < s.length(); i+=UTF16.getCharCount(ch)) { + * for (int i = 0; i < s.length(); i+=UTF16.getCharCount(ch)) { * ch = UTF16.charAt(s,i); * doSomethingWith(ch); * } @@ -74,7 +74,7 @@ * ch = UTF16.charAt(s,i); * doSomethingWith(ch); * } - *+ * }
Converts argument code point and returns a String object representing - * the code point's value in UTF16 format.
+ * the code point's value in UTF16 format. *This method does not check for the validity of the codepoint, the * results are not guaranteed if a invalid codepoint is passed as - * argument.
+ * argument. *The result is a string whose length is 1 for non-supplementary code - * points, 2 otherwise.
+ * points, 2 otherwise. * @param ch code point * @return string representation of the code point */ --- old/src/java.base/share/classes/sun/text/normalizer/UnicodeMatcher.java 2015-05-15 20:25:28.166444023 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/UnicodeMatcher.java 2015-05-15 20:25:28.014444023 +0400 @@ -45,7 +45,8 @@ public interface UnicodeMatcher { /** - * The character at index i, where i < contextStart || i >= contextLimit, + * The character at index {@code i}, where + * {@code i < contextStart || i >= contextLimit}, * is ETHER. This allows explicit matching by rules and UnicodeSets * of text outside the context. In traditional terms, this allows anchoring * at the start and/or end. --- old/src/java.base/share/classes/sun/text/normalizer/UnicodeSet.java 2015-05-15 20:25:28.666444022 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/UnicodeSet.java 2015-05-15 20:25:28.514444022 +0400 @@ -107,8 +107,8 @@ * *[a{ab}{ac}]
[\p{Lu}]
Sets may be intersected using the '&' operator or the asymmetric + *
Sets may be intersected using the {@literal '&'} operator or the asymmetric * set difference may be taken using the '-' operator, for example, - * "[[:L:]&[\\u0000-\\u0FFF]]" indicates the set of all Unicode letters - * with values less than 4096. Operators ('&' and '|') have equal + * "{@code [[:L:]&[\\u0000-\\u0FFF]]}" indicates the set of all Unicode letters + * with values less than 4096. Operators ({@literal '&'} and '|') have equal * precedence and bind left-to-right. Thus * "[[:L:]-[a-z]-[\\u0100-\\u01FF]]" is equivalent to * "[[[:L:]-[a-z]]-[\\u0100-\\u01FF]]". This only really matters for @@ -166,7 +166,7 @@ * that is, U+0000 through 'a'-1 and 'z'+1 through U+10FFFF *
[[pat1][pat2]]
* [[pat1]&[pat2]]
+ * [[pat1]&[pat2]]
* [[pat1]-[pat2]]
* property :=
end >
- * start
then an empty set is created.
+ * Constructs a set containing the given range.
+ * If {@code end > start} then an empty set is created.
*
* @param start first character, inclusive, of range
* @param end last character, inclusive, of range
@@ -651,7 +651,7 @@
* Adds the specified multicharacter to this set if it is not already
* present. If this set already contains the multicharacter,
* the call leaves this set unchanged.
- * Thus "ch" => {"ch"}
+ * Thus {@code "ch" => {"ch"}}
* end > start
+ * added if it is not in this set. If {@code end > start}
* then an empty range is complemented, leaving the set unchanged.
*
* @param start first character, inclusive, of range to be removed
@@ -1698,8 +1698,8 @@
* Modifies this set to contain those code points which have the
* given value for the given property. Prior contents of this
* set are lost.
- * @param propertyAlias
- * @param valueAlias
+ * @param propertyAlias the property alias
+ * @param valueAlias the value alias
* @param symbols if not null, then symbols are first called to see if a property
* is available. If true, then everything else is skipped.
* @return this set
--- old/src/java.base/share/classes/sun/text/normalizer/UnicodeSetIterator.java 2015-05-15 20:25:29.186444022 +0400
+++ new/src/java.base/share/classes/sun/text/normalizer/UnicodeSetIterator.java 2015-05-15 20:25:29.034444022 +0400
@@ -73,35 +73,35 @@
public class UnicodeSetIterator {
/**
- * Value of codepoint if the iterator points to a string.
- * If codepoint == IS_STRING, then examine
- * string for the current iteration result.
+ * Value of {@code codepoint} if the iterator points to a string.
+ * If {@code codepoint == IS_STRING}, then examine
+ * {@code string} for the current iteration result.
* @stable ICU 2.0
*/
public static int IS_STRING = -1;
/**
- * Current code point, or the special value IS_STRING, if
+ * Current code point, or the special value {@code IS_STRING}, if
* the iterator points to a string.
* @stable ICU 2.0
*/
public int codepoint;
/**
- * When iterating over ranges using nextRange(),
- * codepointEnd contains the inclusive end of the
- * iteration range, if codepoint != IS_STRING. If
- * iterating over code points using next(), or if
- * codepoint == IS_STRING, then the value of
- * codepointEnd is undefined.
+ * When iterating over ranges using {@code nextRange()},
+ * {@code codepointEnd} contains the inclusive end of the
+ * iteration range, if {@code codepoint != IS_STRING}. If
+ * iterating over code points using {@code next()}, or if
+ * {@code codepoint == IS_STRING}, then the value of
+ * {@code codepointEnd} is undefined.
* @stable ICU 2.0
*/
public int codepointEnd;
/**
- * If codepoint == IS_STRING, then string points
- * to the current string. If codepoint != IS_STRING, the
- * value of string is undefined.
+ * If {@code codepoint == IS_STRING}, then {@code string} points
+ * to the current string. If {@code codepoint != IS_STRING}, the
+ * value of {@code string} is undefined.
* @stable ICU 2.0
*/
public String string;
@@ -118,17 +118,17 @@
/**
* Returns the next element in the set, either a code point range
* or a string. If there are no more elements in the set, return
- * false. If codepoint == IS_STRING, the value is a
- * string in the string field. Otherwise the value is a
- * range of one or more code points from codepoint to
- * codepointeEnd inclusive.
+ * false. If {@code codepoint == IS_STRING}, the value is a
+ * string in the {@code string} field. Otherwise the value is a
+ * range of one or more code points from {@code codepoint} to
+ * {@code codepointeEnd} inclusive.
*
* The order of iteration is all code points ranges in sorted
* order, followed by all strings sorted order. Ranges are
- * disjoint and non-contiguous. string is undefined
- * unless codepoint == IS_STRING. Do not mix calls to
- * next() and nextRange() without calling
- * reset() between them. The results of doing so are
+ * disjoint and non-contiguous. {@code string} is undefined
+ * unless {@code codepoint == IS_STRING}. Do not mix calls to
+ * {@code next()} and {@code nextRange()} without calling
+ * {@code reset()} between them. The results of doing so are
* undefined.
*
* @return true if there was another element in the set and this
@@ -162,8 +162,8 @@
/**
* Sets this iterator to visit the elements of the given set and
* resets it to the start of that set. The iterator is valid only
- * so long as set is valid.
- * @param set the set to iterate over.
+ * so long as {@code set} is valid.
+ * @param uset the set to iterate over.
* @stable ICU 2.0
*/
public void reset(UnicodeSet uset) {
--- old/src/java.base/share/classes/sun/text/normalizer/Utility.java 2015-05-15 20:25:29.686444021 +0400
+++ new/src/java.base/share/classes/sun/text/normalizer/Utility.java 2015-05-15 20:25:29.534444021 +0400
@@ -227,7 +227,7 @@
/**
* Convert a integer to size width hex uppercase digits.
- * E.g., hex('a', 4, str) => "0041".
+ * E.g., {@code hex('a', 4, str) => "0041"}.
* Append the output to the given StringBuffer.
* If width is too small to fit, nothing will be appended to output.
*/
@@ -237,7 +237,7 @@
/**
* Convert a integer to size width (minimum) hex uppercase digits.
- * E.g., hex('a', 4, str) => "0041". If the integer requires more
+ * E.g., {@code hex('a', 4, str) => "0041"}. If the integer requires more
* than width digits, more will be used.
*/
public static String hex(int ch, int width) {
@@ -334,8 +334,8 @@
}
/**
- * Escape unprintable characters using A converter between Java types and the limited set of classes
- * defined by Open MBeans. A Java type is an instance of java.lang.reflect.Type. For our
+ * A Java type is an instance of java.lang.reflect.Type. For our
* purposes, it is either a Class, such as String.class or int.class;
- * or a ParameterizedType, such as List Each Type is associated with an DefaultMXBeanMappingFactory. The
- * DefaultMXBeanMappingFactory defines an OpenType corresponding to the Type, plus a
- * Java class corresponding to the OpenType. For example: Each Type is associated with an DefaultMXBeanMappingFactory. The
+ * DefaultMXBeanMappingFactory defines an
+ * OpenType corresponding to the Type, plus a
+ * Java class corresponding to the OpenType. For example:
*
- * Apart from simple types, arrays, and collections, Java types are
* converted through introspection into CompositeType. The Java type
* must have at least one getter (method such as "int getSize()" or
* "boolean isBig()"), and we must be able to deduce how to
* reconstruct an instance of the Java class from the values of the
- * getters using one of various heuristics. True if and only if this MXBeanMapping's toOpenValue and
- * fromOpenValue methods are the identity function. Name of the attribute that specifies a default class loader
+ * Name of the attribute that specifies a default class loader
* object.
- * The value associated with this attribute is a ClassLoader object Name of the attribute that specifies a default class loader
- * ObjectName.
- * The value associated with this attribute is an ObjectName object
* Returns:
- *
*
* Returns:
- *
* Name of the attribute that specifies the size of a notification
+ * Name of the attribute that specifies the size of a notification
* buffer for a connector server. The default value is 1000.
*/
public static final String BUFFER_SIZE_PROPERTY =
@@ -316,10 +315,10 @@
}
/**
- * Name of the attribute that specifies the maximum number of
- * notifications that a client will fetch from its server.. The
+ * Name of the attribute that specifies the maximum number of
+ * notifications that a client will fetch from its server. The
* value associated with this attribute should be an
- * Name of the attribute that specifies the timeout for a
+ * Name of the attribute that specifies the timeout for a
* client to fetch notifications from its server. The value
* associated with this attribute should be a Name of the attribute that specifies an object that will check
+ * Name of the attribute that specifies an object that will check
* accesses to add/removeNotificationListener and also attempts to
* receive notifications. The value associated with this attribute
* should be a
* This field is not public because of its com.sun dependency.
*/
public static final String NOTIF_ACCESS_CONTROLLER =
@@ -630,9 +630,9 @@
}
/**
- * Name of the attribute that specifies the timeout to keep a
+ * Name of the attribute that specifies the timeout to keep a
* server side connection after answering last client request.
- * The default value is 120000 milliseconds. Name of the attribute that specifies the period in
- * millisecond for a client to check its connection. The default
- * value is 60000 milliseconds. Name of the attribute that specifies whether a connector server
+ * Name of the attribute that specifies whether a connector server
* should not prevent the VM from exiting
*/
public static final String JMX_SERVER_DAEMON = "jmx.remote.x.daemon";
/**
- * Returns true if {@value SERVER_DAEMON} is specified in the {@code env}
+ * Returns true if {@value JMX_SERVER_DAEMON} is specified in the {@code env}
* as a key and its value is a String and it is equal to true ignoring case.
*
* @param env
--- old/src/java.management/share/classes/sun/management/HotspotRuntimeMBean.java 2015-05-15 20:25:32.222444019 +0400
+++ new/src/java.management/share/classes/sun/management/HotspotRuntimeMBean.java 2015-05-15 20:25:32.058444019 +0400
@@ -64,7 +64,7 @@
* Returns a list of internal counters maintained in the Java
* virtual machine for the runtime system.
*
- * @return a List of internal counters maintained in the VM
+ * @return a {@code List} of internal counters maintained in the VM
* for the runtime system.
*/
public java.util.List
*
- * @return a Map object of the name of all VM internal threads
+ * @return a {@code Map} object of the name of all VM internal threads
* to the thread CPU time in nanoseconds.
*
* @throws java.lang.UnsupportedOperationException if the Java virtual
--- old/src/java.management/share/classes/sun/management/MappedMXBeanType.java 2015-05-15 20:25:33.214444018 +0400
+++ new/src/java.management/share/classes/sun/management/MappedMXBeanType.java 2015-05-15 20:25:33.058444019 +0400
@@ -45,13 +45,15 @@
* A mapped mxbean type maps a Java type to an open type.
* Only the following Java types are mappable
* (currently required by the platform MXBeans):
- * 1. Primitive types
- * 2. Wrapper classes such java.lang.Integer, etc
- * 3. Classes with only getter methods and with a static "from" method
- * that takes a CompositeData argument.
- * 4. E[] where E is a type of 1-4 (can be multi-dimensional array)
- * 5. List
- * A AbstractSensor object consists of two attributes:
+ * A {@code AbstractSensor} object consists of two attributes:
* Other part of code has no access to broadcast loop and have to use
* provided static methods
* {@link #startDiscoveryService(InetAddress,int,String,String) startDiscoveryService}
- * and {@link #stopDiscoveryService() stopDiscoveryService} {@link #startDiscoveryService(InetAddress,int,String,String) startDiscoveryService} could be called multiple
- * times as it stops the running service if it is necessary. Call to {@link #stopDiscoveryService() stopDiscoveryService}
- * ignored if service isn't run System properties below could be used to control broadcast loop behavior.
* Property below have to be set explicitly in command line. It's not possible to
* set it in management.config file. Careless changes of these properties could
@@ -59,9 +58,9 @@
*
+ *
*
* {@code
* Type Open class OpenType
* ---- ---------- --------
- * Integer Integer SimpleType.INTEGER
- * int int SimpleType.INTEGER
- * Integer[] Integer[] ArrayType(1, SimpleType.INTEGER)
- * int[] Integer[] ArrayType(SimpleType.INTEGER, true)
- * String[][] String[][] ArrayType(2, SimpleType.STRING)
- * List
+ * }rspOutgoing
to inform that a response is sent out
* for the received request.
* @return the value of the termination flag:
- *
+ * true if the connection is already being terminated,
+ * false otherwise.
*/
public boolean reqIncoming() {
if (logger.traceOn()) {
@@ -80,8 +80,8 @@
/**
* Tells that a response is sent out for a received request.
* @return the value of the termination flag:
- * true
if the connection is already being terminated,
- * false
otherwise.
+ * true if the connection is already being terminated,
+ * false otherwise.
*/
public boolean rspOutgoing() {
if (logger.traceOn()) {
--- old/src/java.management/share/classes/com/sun/jmx/remote/util/EnvHelp.java 2015-05-15 20:25:31.702444020 +0400
+++ new/src/java.management/share/classes/com/sun/jmx/remote/util/EnvHelp.java 2015-05-15 20:25:31.546444020 +0400
@@ -55,17 +55,17 @@
public class EnvHelp {
/**
- * true
if the connection is already being terminated,
- * false
otherwise.
*
* @exception InstanceNotFoundException if
* jmx.remote.default.class.loader.name
is specified
* but mbs is null.
* jmx.remote.default.class.loader.name
is specified
* and the ClassLoader MBean is not found in mbs.
@@ -172,7 +172,6 @@
* Get the Connector Client default class loader.
*
*
- Integer
object. The default value is 1000.Long
- * object. The default value is 60000 milliseconds.NotificationAccessController
object.
- * The default value is null.
+ *
*
* OpenDataException will be thrown if a Java type is not supported.
*/
--- old/src/java.management/share/classes/sun/management/Sensor.java 2015-05-15 20:25:33.718444018 +0400
+++ new/src/java.management/share/classes/sun/management/Sensor.java 2015-05-15 20:25:33.562444018 +0400
@@ -34,12 +34,12 @@
* An abstract sensor.
*
*
- *
*
@@ -54,7 +54,7 @@
private boolean on;
/**
- * Constructs a Sensor object.
+ * Constructs a {@code Sensor} object.
*
* @param name The name of this sensor.
*/
@@ -88,8 +88,8 @@
/**
* Tests if this sensor is currently on.
*
- * @return true if the sensor is currently on;
- * false otherwise.
+ * @return {@code true} if the sensor is currently on;
+ * {@code false} otherwise.
*
*/
public boolean isOn() {
@@ -112,7 +112,7 @@
/**
* Triggers this sensor. This method sets this sensor on
- * and increments the count with the input increment.
+ * and increments the count with the input {@code increment}.
*/
public void trigger(int increment) {
synchronized (lock) {
@@ -126,7 +126,7 @@
/**
* Triggers this sensor piggybacking a memory usage object.
* This method sets this sensor on
- * and increments the count with the input increment.
+ * and increments the count with the input {@code increment}.
*/
public void trigger(int increment, MemoryUsage usage) {
synchronized (lock) {
@@ -150,7 +150,7 @@
/**
* Clears this sensor
- * and increments the count with the input increment.
+ * and increments the count with the input {@code increment}.
*/
public void clear(int increment) {
synchronized (lock) {
--- old/src/java.management/share/classes/sun/management/counter/Counter.java 2015-05-15 20:25:34.218444018 +0400
+++ new/src/java.management/share/classes/sun/management/counter/Counter.java 2015-05-15 20:25:34.066444018 +0400
@@ -63,7 +63,7 @@
public Object getValue();
/**
- * Returns true if this counter is an internal counter.
+ * Returns {@code true} if this counter is an internal counter.
*/
public boolean isInternal();
--- old/src/java.management/share/classes/sun/management/counter/perf/InstrumentationException.java 2015-05-15 20:25:34.714444017 +0400
+++ new/src/java.management/share/classes/sun/management/counter/perf/InstrumentationException.java 2015-05-15 20:25:34.558444017 +0400
@@ -27,14 +27,14 @@
public class InstrumentationException extends RuntimeException {
/**
- * Constructs a InstrumentationException with no
+ * Constructs a {@code InstrumentationException} with no
* detail message.
*/
public InstrumentationException() {
}
/**
- * Constructs a InstrumentationException with a specified
+ * Constructs a {@code InstrumentationException} with a specified
* detail message.
*
* @param message the detail message
--- old/src/java.management/share/classes/sun/management/jdp/JdpController.java 2015-05-15 20:25:35.210444017 +0400
+++ new/src/java.management/share/classes/sun/management/jdp/JdpController.java 2015-05-15 20:25:35.054444017 +0400
@@ -37,19 +37,18 @@
import sun.misc.ManagedLocalsThread;
/**
- * JdpController is responsible to create and manage a broadcast loop
+ * JdpController is responsible to create and manage a broadcast loop.
*
*
null parameters values are filtered out on {@link JdpPacketWriter} level and - * corresponding keys are not placed to packet.
+ * corresponding keys are not placed to packet. */ public final class JdpController { --- old/src/java.naming/share/classes/com/sun/jndi/ldap/BasicControl.java 2015-05-15 20:25:35.710444016 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/BasicControl.java 2015-05-15 20:25:35.554444017 +0400 @@ -28,7 +28,7 @@ import javax.naming.ldap.*; /** - * This class provides a basic implementation of the Control + * This class provides a basic implementation of the {@code Control} * interface. It represents an LDAPv3 Control as defined in RFC-2251. * * @author Vincent Ryan --- old/src/java.naming/share/classes/com/sun/jndi/ldap/BerDecoder.java 2015-05-15 20:25:36.210444016 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/BerDecoder.java 2015-05-15 20:25:36.054444016 +0400 @@ -295,7 +295,7 @@ * the relative parsed position is not returned. * @return A non-null array containing the octet string. * @throws DecodeException If the next byte in the BER buffer is not - * tag, or if length specified in the BER buffer exceeds the + * {@code tag}, or if length specified in the BER buffer exceeds the * number of bytes left in the buffer. */ public byte[] parseOctetString(int tag, int rlen[]) throws DecodeException { --- old/src/java.naming/share/classes/com/sun/jndi/ldap/EventQueue.java 2015-05-15 20:25:36.710444016 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/EventQueue.java 2015-05-15 20:25:36.554444016 +0400 @@ -73,16 +73,16 @@ // package private; /** * Enqueue an event. - * @param event Either a NamingExceptionEvent or a subclass - * of NamingEvent or - * UnsolicitedNotificationEvent. - * If it is a subclass of NamingEvent, all listeners must implement - * the corresponding subinterface of NamingListener. - * For example, for a ObjectAddedEvent, all listeners must - * implement the ObjectAddedListener interface. + * @param event Either a {@code NamingExceptionEvent} or a subclass + * of {@code NamingEvent} or + * {@code UnsolicitedNotificationEvent}. + * If it is a subclass of {@code NamingEvent}, all listeners must implement + * the corresponding subinterface of {@code NamingListener}. + * For example, for a {@code ObjectAddedEvent}, all listeners must + * implement the {@code ObjectAddedListener} interface. * The current implementation does not check this before dispatching * the event. - * If the event is a NamingExceptionEvent, then all listeners + * If the event is a {@code NamingExceptionEvent}, then all listeners * are notified. * @param vector List of NamingListeners that will be notified of event. */ --- old/src/java.naming/share/classes/com/sun/jndi/ldap/EventSupport.java 2015-05-15 20:25:37.210444015 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/EventSupport.java 2015-05-15 20:25:37.054444015 +0400 @@ -55,14 +55,14 @@ *- *A notifier (NamingEventNotifier) is a worker thread that is responsible + *A notifier ({@code NamingEventNotifier}) is a worker thread that is responsible *for gathering information for generating events requested by its listeners. *Each notifier maintains its own list of listeners; these listeners have *all made the same registration request (at different times) and implements - *the same NamingListener interfaces. + *the same {@code NamingListener} interfaces. *
*For unsolicited listeners, this class maintains a vector, unsolicited. *When an unsolicited listener is registered, this class adds itself @@ -93,7 +93,7 @@ *The notifiers are responsible for gather information for generating events *requested by their respective listeners. When a notifier gets sufficient *information to generate an event, it creates invokes the - *appropriate fireXXXEvent on this class with the information and list of + *appropriate {@code fireXXXEvent} on this class with the information and list of *listeners. This causes an event and the list of listeners to be added *to the event queue. *This class maintains an event queue and a dispatching thread that dequeues @@ -138,7 +138,7 @@ } /** - * Adds l to list of listeners interested in nm. + * Adds {@code l} to list of listeners interested in {@code nm}. */ /* * Make the add/removeNamingListeners synchronized to: @@ -173,7 +173,7 @@ } /** - * Adds l to list of listeners interested in nm + * Adds {@code l} to list of listeners interested in {@code nm} * and filter. */ synchronized void addNamingListener(String nm, String filter, @@ -201,7 +201,7 @@ } /** - * Removes l from all notifiers in this context. + * Removes {@code l} from all notifiers in this context. */ synchronized void removeNamingListener(NamingListener l) { if (debug) System.err.println("EventSupport removing listener"); --- old/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-05-15 20:25:37.714444015 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-05-15 20:25:37.558444015 +0400 @@ -336,7 +336,7 @@ * characters: *
, = + < > # ; " \+ *
{@literal , = + < > # ; " \}*
- * An LdapReferralException object contains one or more referrals. + * An {@code LdapReferralException} object contains one or more referrals. * Each referral is an alternative location for the same target entry. * For example, a referral may be an LDAP URL. * The referrals are attempted in sequence until one is successful or @@ -46,20 +46,20 @@ * of an authentication error, a referral may be retried with different * environment properties. *
- * An LdapReferralException object may also contain a reference - * to a chain of unprocessed LdapReferralException objects. + * An {@code LdapReferralException} object may also contain a reference + * to a chain of unprocessed {@code LdapReferralException} objects. * Once the current set of referrals have been exhausted and unprocessed - * LdapReferralException objects remain, then the - * LdapReferralException object referenced by the current + * {@code LdapReferralException} objects remain, then the + * {@code LdapReferralException} object referenced by the current * object is thrown and the cycle continues. *
- * If new LdapReferralException objects are generated while + * If new {@code LdapReferralException} objects are generated while * following an existing referral then these new objects are appended - * to the end of the chain of unprocessed LdapReferralException + * to the end of the chain of unprocessed {@code LdapReferralException} * objects. *
* If an exception was recorded while processing a chain of - * LdapReferralException objects then it is throw once + * {@code LdapReferralException} objects then it is throw once * processing has completed. * * @author Vincent Ryan --- old/src/java.naming/share/classes/com/sun/jndi/ldap/UnsolicitedResponseImpl.java 2015-05-15 20:25:38.722444014 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/UnsolicitedResponseImpl.java 2015-05-15 20:25:38.566444014 +0400 @@ -65,7 +65,7 @@ * Retrieves the object identifier of the response. * * @return A possibly null object identifier string representing the LDAP - * ExtendedResponse.responseName component. + * {@code ExtendedResponse.responseName} component. */ public String getID() { return oid; @@ -79,7 +79,7 @@ * the response value. It does not include the response OID. * * @return A possibly null byte array representing the ASN.1 BER encoded - * contents of the LDAP ExtendedResponse.response + * contents of the LDAP {@code ExtendedResponse.response} * component. */ public byte[] getEncodedValue() { --- old/src/java.naming/share/classes/com/sun/jndi/ldap/ext/StartTlsResponseImpl.java 2015-05-15 20:25:39.222444014 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/ext/StartTlsResponseImpl.java 2015-05-15 20:25:39.066444014 +0400 @@ -52,10 +52,10 @@ * The object identifier for StartTLS is 1.3.6.1.4.1.1466.20037 * and no extended response value is defined. * - *
+ *
* The Start TLS extended request and response are used to establish * a TLS connection over the existing LDAP connection associated with - * the JNDI context on which extendedOperation() is invoked. + * the JNDI context on which {@code extendedOperation()} is invoked. * * @see StartTlsRequest * @author Vincent Ryan @@ -124,7 +124,7 @@ /** * Overrides the default list of cipher suites enabled for use on the * TLS connection. The cipher suites must have already been listed by - * SSLSocketFactory.getSupportedCipherSuites() as being supported. + * {@code SSLSocketFactory.getSupportedCipherSuites()} as being supported. * Even if a suite has been enabled, it still might not be used because * the peer does not support it, or because the requisite certificates * (and private keys) are not available. @@ -140,12 +140,12 @@ } /** - * Overrides the default hostname verifier used by negotiate() + * Overrides the default hostname verifier used by {@code negotiate()} * after the TLS handshake has completed. If - * setHostnameVerifier() has not been called before - * negotiate() is invoked, negotiate() + * {@code setHostnameVerifier()} has not been called before + * {@code negotiate()} is invoked, {@code negotiate()} * will perform a simple case ignore match. If called after - * negotiate(), this method does not do anything. + * {@code negotiate()}, this method does not do anything. * * @param verifier The non-null hostname verifier callback. * @see #negotiate @@ -157,10 +157,10 @@ /** * Negotiates a TLS session using the default SSL socket factory. *
- * This method is equivalent to negotiate(null). + * This method is equivalent to {@code negotiate(null)}. * * @return The negotiated SSL session - * @throw IOException If an IO error was encountered while establishing + * @throws IOException If an IO error was encountered while establishing * the TLS session. * @see #setEnabledCipherSuites * @see #setHostnameVerifier @@ -177,7 +177,7 @@ * attaches it to the existing connection. Performs the TLS handshake * and returns the negotiated session information. *
- * If cipher suites have been set via setEnabledCipherSuites + * If cipher suites have been set via {@code setEnabledCipherSuites} * then they are enabled before the TLS handshake begins. *
* Hostname verification is performed after the TLS handshake completes. @@ -186,7 +186,7 @@ * hostname is extracted from the subjectAltName in the server's * certificate (if present). Otherwise the value of the common name * attribute of the subject name is used. If a callback has - * been set via setHostnameVerifier then that verifier is used if + * been set via {@code setHostnameVerifier} then that verifier is used if * the default check fails. *
* If an error occurs then the SSL socket is closed and an IOException @@ -195,7 +195,7 @@ * @param factory The possibly null SSL socket factory to use. * If null, the default SSL socket factory is used. * @return The negotiated SSL session - * @throw IOException If an IO error was encountered while establishing + * @throws IOException If an IO error was encountered while establishing * the TLS session. * @see #setEnabledCipherSuites * @see #setHostnameVerifier @@ -252,7 +252,7 @@ * Closes the TLS connection gracefully and reverts back to the underlying * connection. * - * @throw IOException If an IO error was encountered while closing the + * @throws IOException If an IO error was encountered while closing the * TLS connection */ public void close() throws IOException { --- old/src/java.naming/share/classes/com/sun/jndi/ldap/sasl/LdapSasl.java 2015-05-15 20:25:39.722444013 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/sasl/LdapSasl.java 2015-05-15 20:25:39.570444013 +0400 @@ -72,12 +72,12 @@ * property has not been set, Context.SECURITY_PRINCIPAL is used. * If SASL_CALLBACK has been set, use that instead of the default * CallbackHandler. - *
+ *
* If bind is successful and the selected SASL mechanism has a security * layer, set inStream and outStream to be filter streams that use * the security layer. These will be used for subsequent communication * with the server. - *
+ * * @param conn The non-null connection to use for sending an LDAP BIND * @param server Non-null string name of host to connect to * @param dn Non-null DN to bind as; also used as authentication ID --- old/src/java.naming/share/classes/com/sun/jndi/toolkit/ctx/Continuation.java 2015-05-15 20:25:40.222444013 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/toolkit/ctx/Continuation.java 2015-05-15 20:25:40.066444013 +0400 @@ -329,7 +329,7 @@ *
* After this method is called, isContinuing() returns true. * - * @param resObj The possibly null resolved object. + * @param obj The possibly null resolved object. * @param relResName The non-null resolved name relative to currCtx. * @param currCtx The non-null context from which relResName is to be resolved. */ @@ -349,7 +349,7 @@ *
* After this method is called, isContinuing() returns true. * - * @param resObj The possibly null resolved object. + * @param obj The possibly null resolved object. * @param relResName The non-null resolved name relative to currCtx. * @param currCtx The non-null context from which relResName is to be resolved. * @param remain The non-null remaining name. @@ -366,7 +366,7 @@ /** * String overload. * - * @param resObj The possibly null resolved object. + * @param obj The possibly null resolved object. * @param relResName The non-null resolved name relative to currCtx. * @param currCtx The non-null context from which relResName is to be resolved. * @param remain The non-null remaining name. --- old/src/java.naming/share/classes/com/sun/jndi/toolkit/ctx/PartialCompositeContext.java 2015-05-15 20:25:40.722444012 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/toolkit/ctx/PartialCompositeContext.java 2015-05-15 20:25:40.566444012 +0400 @@ -452,14 +452,14 @@ * nonempty component, and if 'prefix' ends with an empty component or * 'name' starts with one, then one empty component is dropped. * For example: - *
+ **/ public Name composeName(Name name, Name prefix) throws NamingException { Name res = (Name)prefix.clone(); --- old/src/java.naming/share/classes/com/sun/jndi/toolkit/dir/HierMemDirCtx.java 2015-05-15 20:25:41.222444012 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/toolkit/dir/HierMemDirCtx.java 2015-05-15 20:25:41.066444012 +0400 @@ -32,8 +32,8 @@ /** * A sample service provider that implements a hierarchical directory in memory. * Every operation begins by doing a lookup on the name passed to it and then - * calls a corresponding "do{@code * elideEmpty=false elideEmpty=true * {"a"} + {"b"} => {"a", "b"} {"a", "b"} * {"a"} + {""} => {"a", ""} {"a", ""} * {"a"} + {"", "b"} => {"a", "", "b"} {"a", "b"} * {"a", ""} + {"b", ""} => {"a", "", "b", ""} {"a", "b", ""} * {"a", ""} + {"", "b"} => {"a", "", "", "b"} {"a", "", "b"} - *+ * }
{i}
specifies the i
'th element from
* the array args
is to be substituted for the
--- old/src/java.naming/share/classes/com/sun/jndi/toolkit/url/GenericURLContext.java 2015-05-15 20:25:42.234444011 +0400
+++ new/src/java.naming/share/classes/com/sun/jndi/toolkit/url/GenericURLContext.java 2015-05-15 20:25:42.078444011 +0400
@@ -107,12 +107,14 @@
* the subclass must override getURLSuffix() to get the correct behavior.
* Remember, the behavior must match getRootURLContext().
*
+ * {@code * URL Suffix * foo://host:port*/ protected Name getURLSuffix(String prefix, String url) throws NamingException { String suffix = url.substring(prefix.length()); --- old/src/java.naming/share/classes/com/sun/jndi/toolkit/url/Uri.java 2015-05-15 20:25:42.798444011 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/toolkit/url/Uri.java 2015-05-15 20:25:42.646444011 +0400 @@ -47,7 +47,7 @@ * still run on pre-1.4 platforms not containing that class. * ** foo://host:port/rest/of/name rest/of/name * foo:///rest/of/name rest/of/name * foo:/rest/of/name rest/of/name * foo:rest/of/name rest/of/name + * }
The format of an absolute URI (see the RFCs mentioned above) is: - *
* - *+ *+ * }{@code * absoluteURI = scheme ":" ( hier_part | opaque_part ) * * scheme = alpha *( alpha | digit | "+" | "-" | "." ) @@ -94,12 +94,12 @@ * mark = "-" | "_" | "." | "!" | "~" | "*" | "'" | "(" | ")" * escaped = "%" hex hex * unwise = "{" | "}" | "|" | "\" | "^" | "`" - *
Currently URIs containing userinfo or reg_name + *
Currently URIs containing {@code userinfo} or {@code reg_name} * are not supported. - * The opaque_part of a non-hierarchical URI is treated as if - * if were a path without a leading slash. + * The {@code opaque_part} of a non-hierarchical URI is treated as if + * if were a {@code path} without a leading slash. */ --- old/src/java.rmi/share/classes/com/sun/rmi/rmid/ExecOptionPermission.java 2015-05-15 20:25:43.366444010 +0400 +++ new/src/java.rmi/share/classes/com/sun/rmi/rmid/ExecOptionPermission.java 2015-05-15 20:25:43.210444010 +0400 @@ -32,7 +32,6 @@ /** * The ExecOptionPermission class represents permission for rmid to use * a specific command-line option when launching an activation group. - *
* * @author Ann Wollrath * @@ -68,9 +67,9 @@ * Checks if the specified permission is "implied" by * this object. *
- * More specifically, this method returns true if:
+ * More specifically, this method returns true if: *
+ *
+ * * @param obj the object we are testing for equality with this object. * @return true if obj is an ExecOptionPermission, and has the same * name as this ExecOptionPermission object, false otherwise. @@ -154,7 +153,7 @@ * Returns a new PermissionCollection object for storing * ExecOptionPermission objects. *
- * A ExecOptionPermissionCollection stores a collection of + * An ExecOptionPermissionCollection stores a collection of * ExecOptionPermission permissions. * *
ExecOptionPermission objects must be stored in a manner that allows
--- old/src/java.rmi/share/classes/com/sun/rmi/rmid/ExecPermission.java 2015-05-15 20:25:43.870444010 +0400
+++ new/src/java.rmi/share/classes/com/sun/rmi/rmid/ExecPermission.java 2015-05-15 20:25:43.714444010 +0400
@@ -40,14 +40,13 @@
* all the files and directories contained in that directory. A pathname
* that ends with "/-" indicates (recursively) all files
* and subdirectories contained in that directory. A pathname consisting of
- * the special token "<<ALL FILES>>" matches
* Note: A pathname consisting of a single "*" indicates all the files
* in the current directory, while a pathname consisting of a single "-"
* indicates all the files in the current directory and
* (recursively) all files and subdirectories contained in the current
* directory.
- *
*
*
* @author Ann Wollrath
@@ -72,7 +71,7 @@
* a directory and all the files contained in that directory. A pathname
* that ends with "/-" indicates a directory and (recursively) all files
* and subdirectories contained in that directory. The special pathname
- * "<<ALL FILES>>" matches all files.
+ * "{@code < A pathname consisting of a single "*" indicates all the files
* in the current directory, while a pathname consisting of a single "-"
@@ -96,7 +95,7 @@
* a directory and all the files contained in that directory. A pathname
* that ends with "/-" indicates a directory and (recursively) all files
* and subdirectories contained in that directory. The special pathname
- * "<<ALL FILES>>" matches all files.
+ * "{@code < A pathname consisting of a single "*" indicates all the files
* in the current directory, while a pathname consisting of a single "-"
@@ -114,9 +113,9 @@
/**
* Checks if this ExecPermission object "implies" the specified permission.
*
- * More specifically, this method returns true if:
+ * More specifically, this method returns true if:
* and
+ *
+ *
* @param obj the object we are testing for equality with this object.
* @return true if obj is an ExecPermission, and has the same
* pathname as this ExecPermission object, false otherwise.
--- old/src/java.rmi/share/classes/sun/rmi/log/LogInputStream.java 2015-05-15 20:25:44.442444009 +0400
+++ new/src/java.rmi/share/classes/sun/rmi/log/LogInputStream.java 2015-05-15 20:25:44.286444009 +0400
@@ -35,7 +35,7 @@
/**
* Creates a log input file with the specified system dependent
* file descriptor.
- * @param fd the system dependent file descriptor
+ * @param in the system dependent file descriptor
* @param length the total number of bytes allowed to be read
* @exception IOException If an I/O error has occurred.
*/
--- old/src/java.rmi/share/classes/sun/rmi/log/LogOutputStream.java 2015-05-15 20:25:45.002444009 +0400
+++ new/src/java.rmi/share/classes/sun/rmi/log/LogOutputStream.java 2015-05-15 20:25:44.846444009 +0400
@@ -35,7 +35,7 @@
/**
* Creates an output file with the specified system dependent
* file descriptor.
- * @param fd the system dependent file descriptor
+ * @param raf the system dependent file descriptor.
* @exception IOException If an I/O error has occurred.
*/
public LogOutputStream(RandomAccessFile raf) throws IOException {
--- old/src/java.rmi/share/classes/sun/rmi/log/ReliableLog.java 2015-05-15 20:25:45.502444008 +0400
+++ new/src/java.rmi/share/classes/sun/rmi/log/ReliableLog.java 2015-05-15 20:25:45.346444008 +0400
@@ -124,7 +124,7 @@
* stable storage directory.
*
* @param dirPath path to the stable storage directory
- * @param logCl the closure object containing callbacks for logging and
+ * @param handler the closure object containing callbacks for logging and
* recovery
* @param pad ignored
* @exception IOException If a directory creation error has
@@ -170,8 +170,8 @@
* stable storage directory.
*
* @param dirPath path to the stable storage directory
- * @param logCl the closure object containing callbacks for logging and
- * recovery
+ * @param handler the closure object containing callbacks for logging and
+ * recovery
* @exception IOException If a directory creation error has
* occurred or if initialSnapshot callback raises an exception
*/
--- old/src/java.rmi/share/classes/sun/rmi/registry/RegistryImpl.java 2015-05-15 20:25:46.006444008 +0400
+++ new/src/java.rmi/share/classes/sun/rmi/registry/RegistryImpl.java 2015-05-15 20:25:45.850444008 +0400
@@ -155,7 +155,7 @@
/**
* Returns the remote object for specified name in the registry.
* @exception RemoteException If remote operation failed.
- * @exception NotBound If name is not currently bound.
+ * @exception NotBoundException If name is not currently bound.
*/
public Remote lookup(String name)
throws RemoteException, NotBoundException
@@ -188,7 +188,7 @@
/**
* Unbind the name.
* @exception RemoteException If remote operation failed.
- * @exception NotBound If name is not currently bound.
+ * @exception NotBoundException If name is not currently bound.
*/
public void unbind(String name)
throws RemoteException, NotBoundException, AccessException
--- old/src/java.rmi/share/classes/sun/rmi/runtime/Log.java 2015-05-15 20:25:46.506444008 +0400
+++ new/src/java.rmi/share/classes/sun/rmi/runtime/Log.java 2015-05-15 20:25:46.350444008 +0400
@@ -96,7 +96,7 @@
* care to interpret a range of values between BRIEF, VERBOSE and
* SILENT.
*
- * An override < 0 is interpreted to mean that the logging
+ * An override {@literal <} 0 is interpreted to mean that the logging
* configuration should not be overridden. The level passed to the
* factories createLog method will be null in this case.
*
--- old/src/java.rmi/share/classes/sun/rmi/server/ActivationGroupImpl.java 2015-05-15 20:25:47.070444007 +0400
+++ new/src/java.rmi/share/classes/sun/rmi/server/ActivationGroupImpl.java 2015-05-15 20:25:46.914444007 +0400
@@ -345,7 +345,7 @@
* request.
*
* @param id the object's activation identifier
- * @returns true if the operation succeeds (the operation will
+ * @return true if the operation succeeds (the operation will
* succeed if the object in currently known to be active and is
* either already unexported or is currently exported and has no
* pending/executing calls); false is returned if the object has
@@ -430,7 +430,7 @@
* hasn't already done so.
*
* @param id the object's identifier
- * @param obj the remote object implementation
+ * @param impl the remote object implementation
* @exception UnknownObjectException if object is not registered
* @exception RemoteException if call informing monitor fails
*/
--- old/src/java.rmi/share/classes/sun/rmi/server/ActivationGroupInit.java 2015-05-15 20:25:47.638444007 +0400
+++ new/src/java.rmi/share/classes/sun/rmi/server/ActivationGroupInit.java 2015-05-15 20:25:47.482444007 +0400
@@ -36,7 +36,7 @@
* The activator spawns (as a child process) an activation group as needed
* and directs activation requests to the appropriate activation
* group. After spawning the VM, the activator passes some
- * information to the bootstrap code via its stdin:
+ * information to the bootstrap code via its stdin:
*
+ *
*
- *
*
1.0 Backgroud
* This synchronization provider is registered with the
* SyncFactory
by default as the
--- old/src/jdk.rmic/share/classes/sun/rmi/rmic/RMIGenerator.java 2015-05-15 20:25:50.690444004 +0400
+++ new/src/jdk.rmic/share/classes/sun/rmi/rmic/RMIGenerator.java 2015-05-15 20:25:50.530444004 +0400
@@ -79,7 +79,7 @@
* Examine and consume command line arguments.
* @param argv The command line arguments. Ignore null
* and unknown arguments. Set each consumed argument to null.
- * @param error Report any errors using the main.error() methods.
+ * @param main Report any errors using the main.error() methods.
* @return true if no errors, false otherwise.
*/
public boolean parseArgs(String argv[], Main main) {