--- 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:
- ' ' for any kind of white - * space character;
- 'a' for any lower case alphabetical character - * value;
- 'A' for any upper case alphabetical character value;
- * - 'd' for any decimal digit character value;
- 'z' for any - * character less then ' ' except '\t', '\n', '\r';
- 'X' for any not - * ASCII character;
- 'Z' for EOS character.
An ASCII (7 bit) - * character which does not fall in any category listed above is mapped to - * it self. + * Possible character type values are: + * + * An ASCII (7 bit) character which does not fall in any category + * listed above is mapped to itself. * * @param ch The character to map. * @return The type of character. --- old/src/java.base/share/classes/sun/misc/Cache.java 2015-05-15 20:25:03.178444043 +0400 +++ new/src/java.base/share/classes/sun/misc/Cache.java 2015-05-15 20:25:03.030444043 +0400 @@ -196,8 +196,8 @@ /** * Gets the object associated with the specified key in the Cache. * @param key the key in the hash table - * @returns the element for the key or null if the key - * is not defined in the hash table. + * @return the element for the key or null if the key + * is not defined in the hash table. * @see Cache#put */ public synchronized Object get(Object key) { --- old/src/java.base/share/classes/sun/misc/CharacterDecoder.java 2015-05-15 20:25:03.678444043 +0400 +++ new/src/java.base/share/classes/sun/misc/CharacterDecoder.java 2015-05-15 20:25:03.526444043 +0400 @@ -120,7 +120,7 @@ /** * This method does an actual decode. It takes the decoded bytes and * writes them to the OutputStream. The integer l tells the - * method how many bytes are required. This is always <= bytesPerAtom(). + * method how many bytes are required. This is always {@literal <=} bytesPerAtom(). */ protected void decodeAtom(PushbackInputStream aStream, OutputStream bStream, int l) throws IOException { throw new CEStreamExhausted(); --- old/src/java.base/share/classes/sun/misc/CharacterEncoder.java 2015-05-15 20:25:04.178444042 +0400 +++ new/src/java.base/share/classes/sun/misc/CharacterEncoder.java 2015-05-15 20:25:04.026444042 +0400 @@ -68,7 +68,7 @@ * referenced in the See Also list below. * * @author Chuck McManis - * @see CharacterDecoder; + * @see CharacterDecoder * @see UCEncoder * @see UUEncoder * @see BASE64Encoder @@ -107,7 +107,7 @@ /** * Encode the suffix that ends every output line. By default - * this method just prints a into the output stream. + * this method just prints a {@code } into the output stream. */ protected void encodeLineSuffix(OutputStream aStream) throws IOException { pStream.println(); --- old/src/java.base/share/classes/sun/misc/ConditionLock.java 2015-05-15 20:25:04.678444042 +0400 +++ new/src/java.base/share/classes/sun/misc/ConditionLock.java 2015-05-15 20:25:04.526444042 +0400 @@ -34,7 +34,7 @@ * with the lock() and unlock() methods. However if there is a thread * waiting for the state variable to become a particular value and you * simply call Unlock(), that thread will not be able to acquire the - * lock until the state variable equals its desired value.

+ * 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: - *
+     * 
{@code
      * -1: this <  x + y
      *  0: this == x + y
      *  1: this >  x + y
-     * 
+ * }
* @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 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: - *

- * + *

* * @param lvmid an integer that uniquely identifies the * target local Java virtual machine. --- old/src/java.base/share/classes/sun/misc/PerfCounter.java 2015-05-15 20:25:09.338444038 +0400 +++ new/src/java.base/share/classes/sun/misc/PerfCounter.java 2015-05-15 20:25:09.190444038 +0400 @@ -37,7 +37,7 @@ * The perf counters will be created in the jvmstat perf buffer * that the HotSpot VM creates. The default size is 32K and thus * the number of counters is bounded. You can alter the size - * with -XX:PerfDataMemorySize= option. If there is + * with {@code -XX:PerfDataMemorySize=} option. If there is * insufficient memory in the jvmstat perf buffer, the C heap memory * will be used and thus the application will continue to run if * the counters added exceeds the buffer size but the counters --- old/src/java.base/share/classes/sun/misc/PerformanceLogger.java 2015-05-15 20:25:09.838444038 +0400 +++ new/src/java.base/share/classes/sun/misc/PerformanceLogger.java 2015-05-15 20:25:09.686444038 +0400 @@ -51,10 +51,12 @@ *

* To automatically track startup performance in an app or applet, * use the command-line parameter sun.perflog as follows:
+ *

{@code
  *     -Dsun.perflog[=file:]
+ * }
*
* where simply using the parameter with no value will enable output - * to the console and a value of "file:" will cause + * to the console and a value of "{@code file:}" will cause * that given filename to be created and used for all output. *

* 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: *

  * new Signal("INT");
- * 
+ * * constructs a signal object corresponding to 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 @@ *
  • String: any object (not just a java.lang.String) *
  • InterfaceMethodRef: (NYI) a method handle to invoke on that call site's arguments * - * @params hostClass context for linkage, access control, protection domain, and class loader - * @params data bytes of a class file - * @params cpPatches where non-null entries exist, they replace corresponding CP entries in data + * @param hostClass context for linkage, access control, protection domain, and class loader + * @param data bytes of a class file + * @param cpPatches where non-null entries exist, they replace corresponding CP entries in data */ public native Class defineAnonymousClass(Class hostClass, byte[] data, Object[] cpPatches); @@ -808,9 +808,9 @@ * The system imposes a maximum of 3 samples, representing * averages over the last 1, 5, and 15 minutes, respectively. * - * @params loadavg an array of double of size nelems - * @params nelems the number of samples to be retrieved and - * must be 1 to 3. + * @param loadavg an array of double of size nelems + * @param nelems the number of samples to be retrieved and + * must be 1 to 3. * * @return the number of samples actually retrieved; or -1 * if the load average is unobtainable. @@ -1108,7 +1108,6 @@ *

    * 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 ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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; /** - *

    This class represents the ResourceBundle + * This class represents the ResourceBundle * for sun.misc. * * @author Michael Colburn @@ -36,7 +36,7 @@ /** * Returns the contents of this ResourceBundle. - *

    + * * @return the contents of this 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: - *

      + *
        *
      • Fast access of the indexed values. *
      • Smaller memory footprint. *
      --- 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. *

      * - * 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. - *

      * *

      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: + *

          *
        • {@link #LEVEL_DEFAULT_LTR} *
        • {@link #LEVEL_DEFAULT_RTL} *
        • {@link #LEVEL_OVERRIDE} @@ -153,7 +153,8 @@ * Reordering mode values indicate which variant of the Bidi algorithm to * use. * - *
            See Also: + *

            See Also: + *

              *
            • {@link #setReorderingMode} *
            • {@link #REORDER_DEFAULT} *
            • {@link #REORDER_NUMBERS_SPECIAL} @@ -166,7 +167,8 @@ * *

              Basic concept: Reordering Options

              * Reordering options can be applied during Bidi text transformations. - *
                See Also: + *

                See Also: + *

                  *
                • {@link #setReorderingOptions} *
                • {@link #OPTION_DEFAULT} *
                • {@link #OPTION_INSERT_MARKS} @@ -202,7 +204,7 @@ * and therefore its implementation omitted from this sample code.
                • *
                * - *
                + * 
                {@code
                  *
                  *  package com.ibm.icu.dev.test.bidi;
                  *
                @@ -451,7 +453,7 @@
                  *      }
                  *  }
                  *
                - * 
                + * }
                */ public class BidiBase { @@ -2419,9 +2421,9 @@ * (same index) character if the level has the * 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.

                + * 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 [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". * *

                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.

                + * file header and authenticates them. *

                Header format: *

                  *
                • Header size (char) @@ -84,7 +84,7 @@ * [0] major [1] minor [2] milli [3] micro *
                • Unicode version (4 bytes) this ICU is based on. *
                - *

                + * *

                * 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: *

                  *
                • {@link #COMPOSE} - Unicode canonical decompositiion @@ -985,7 +985,7 @@ mode = newMode; } /** - * Return the basic operation performed by this Normalizer + * Return the basic operation performed by this {@code Normalizer} * * @see #setMode * @stable ICU 2.8 @@ -995,8 +995,8 @@ } /** - * Set the input text over which this Normalizer will iterate. - * The iteration position is set to the beginning of the input text-> + * Set the input text over which this {@code Normalizer} will iterate. + * The iteration position is set to the beginning of the input text. * @param newText The new string to be normalized. * @stable ICU 2.8 */ @@ -1011,8 +1011,8 @@ } /** - * Set the input text over which this Normalizer will iterate. - * The iteration position is set to the beginning of the input text-> + * Set the input text over which this {@code Normalizer} will iterate. + * The iteration position is set to the beginning of the input text. * @param newText The new string to be normalized. * @stable ICU 2.8 */ @@ -1571,7 +1571,7 @@ // /** - * 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. * * @param str The string to be normalized. The normalization @@ -1646,7 +1646,6 @@ * perform further tests to arrive at a true/false result. * @param str the input string to be checked to see if it is normalized * @param form the normalization form - * @param options the optional features to be enabled. */ public static boolean isNormalized(String str, Normalizer.Form form) { return isNormalized(str, form, UNICODE_LATEST); --- old/src/java.base/share/classes/sun/text/normalizer/RangeValueIterator.java 2015-05-15 20:25:22.658444027 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/RangeValueIterator.java 2015-05-15 20:25:22.510444027 +0400 @@ -38,12 +38,13 @@ package sun.text.normalizer; /** - *

                  Interface for enabling iteration over sets of , + *

                  Interface for enabling iteration over sets of + * {@code }, * where index is the sorted integer index in ascending order and value, its - * associated integer value.

                  + * associated integer value. *

                  The result for each iteration is the consecutive range of - * with the same value. Result is represented by - * where

                  + * {@code } with the same value. Result is represented by + * {@code } where *
                    *
                  • start is the starting integer of the result range *
                  • limit is 1 after the maximum integer that follows start, such that @@ -56,10 +57,10 @@ * Hence value(start) = value(start + 1) = .... = value(start + n) = .... = * value(limit - 1). However value(start -1) != value(start) and * value(limit) != value(start). - *

                    + * *

                    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 @@
                      *   
                  • If there is no previous character (i.e. start == 0), use the * following character
                  • *
                  • If there is no following character (i.e. the replaceable was - * empty), use default metadata
                    + * empty), use default metadata
                  • *
                  • If the code point U+FFFF is seen, it should be interpreted as - * a special marker having no metadata
                  • - *
                  • + * a special marker having no metadata
                  • *
                  * If this is not the behavior, the subclass should document any differences. * @@ -111,10 +110,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/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<Class enabling iteration of the values in a Trie.

                  + * Class enabling iteration of the values in a Trie. *

                  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 - *

                  + * 
                  {@code
                    * // utrie_enum(&fcdTrie, NULL, _enumPropertyStartsRange, set);
                    * TrieIterator fcdIter  = new TrieIterator(fcdTrieImpl.fcdTrie);
                    * while(fcdIter.next(result)){
                    *     set.add(result.start);
                    * }
                  - * 
                  - *

                  + * }
                  + * * @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
                    * 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: * - * - *

                  +     * 
                  {@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()];
                        *             }
                        *         }
                  -     * 
                  - *
                  + * }
                  * * @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 @@ /** *

                  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().

                  + * using bounds(). * Examples: *

                  The following examples illustrate use of some of these methods. - *

                  + * 
                  {@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);
                    * }
                  - * 
                  + * }
                  * Notes: *
                    *
                  • @@ -515,12 +515,12 @@ /** *

                    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}] - * The character 'a' and the multicharacter strings "ab" and - * "ac" + * The character 'a' and the multicharacter strings "ab" and + * "ac" * * * [\p{Lu}] @@ -148,10 +148,10 @@ * literal. Thus "[a\\-b]", "[-ab]", and "[ab-]" all indicate the same * set of three characters, 'a', 'b', and '-'. * - *

                    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]] * The union of sets specified by pat1 and pat2 - * [[pat1]&[pat2]] + * [[pat1]&[pat2]] * The intersection of sets specified by pat1 and pat2 * [[pat1]-[pat2]] * The asymmetric difference of sets specified by pat1 and @@ -227,7 +227,7 @@ * * * property :=  - * a Unicode property set pattern + * a Unicode property set pattern * * *
                    @@ -337,8 +337,8 @@ } /** - * Constructs a set containing the given range. If 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"}} *
                    Warning: you cannot add an empty string ("") to a UnicodeSet. * @param s the source string * @return this object, for chaining @@ -691,7 +691,7 @@ /** * Complements the specified range in this set. Any character in * the range will be removed if it is in this set, or will be - * added if it is not in this set. If 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 uxxxx notation - * for U+0000 to U+FFFF and Uxxxxxxxx for U+10000 and + * Escape unprintable characters using {@code uxxxx} notation + * for U+0000 to U+FFFF and {@code Uxxxxxxxx} for U+10000 and * above. If the character is printable ASCII, then do nothing * and return FALSE. Otherwise, append the escaped notation and * return TRUE. --- old/src/java.base/share/classes/sun/text/normalizer/VersionInfo.java 2015-05-15 20:25:30.186444021 +0400 +++ new/src/java.base/share/classes/sun/text/normalizer/VersionInfo.java 2015-05-15 20:25:30.034444021 +0400 @@ -53,7 +53,7 @@ * @param version version String in the format of "major.minor.milli.micro" * or "major.minor.milli" or "major.minor" or "major", * where major, minor, milli, micro are non-negative numbers - * <= 255. If the trailing version numbers are + * {@literal <=} 255. If the trailing version numbers are * not specified they are taken as 0s. E.g. Version "3.1" is * equivalent to "3.1.0.0". * @return an instance of VersionInfo with the argument version. @@ -98,12 +98,12 @@ /** * Returns an instance of VersionInfo with the argument version. - * @param major major version, non-negative number <= 255. - * @param minor minor version, non-negative number <= 255. - * @param milli milli version, non-negative number <= 255. - * @param micro micro version, non-negative number <= 255. + * @param major major version, non-negative number {@literal <=} 255. + * @param minor minor version, non-negative number {@literal <=} 255. + * @param milli milli version, non-negative number {@literal <=} 255. + * @param micro micro version, non-negative number {@literal <=} 255. * @exception throws an IllegalArgumentException when either arguments are - * negative or > 255 + * negative or {@literal >} 255 * @stable ICU 2.6 */ public static VersionInfo getInstance(int major, int minor, int milli, --- old/src/java.management/share/classes/com/sun/jmx/mbeanserver/DefaultMXBeanMappingFactory.java 2015-05-15 20:25:30.690444021 +0400 +++ new/src/java.management/share/classes/com/sun/jmx/mbeanserver/DefaultMXBeanMappingFactory.java 2015-05-15 20:25:30.534444021 +0400 @@ -79,44 +79,46 @@ /** *

                    A converter between Java types and the limited set of classes - * defined by Open MBeans.

                    + * 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 or Map. On J2SE 1.4 and earlier, it can only be a Class.

                    + * or a ParameterizedType, such as {@code List} or + * {@code Map}. + * On J2SE 1.4 and earlier, it can only be a Class. * - *

                    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: * - *

                    + *   
                    {@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                   String[]       ArrayType(1, SimpleType.STRING)
                    + *   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             String[]       ArrayType(1, SimpleType.STRING)
                      *   ThreadState (an Enum)    String         SimpleType.STRING
                    - *   Map   TabularData          TabularType(
                    + *   Map   TabularData    TabularType(
                      *                                           CompositeType(
                      *                                             {"key", SimpleType.INTEGER},
                      *                                             {"value",
                      *                                               ArrayType(1,
                      *                                                SimpleType.STRING)}),
                      *                                           indexNames={"key"})
                    - *   
                    + * }
                    * *

                    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.

                    + * getters using one of various heuristics. * - * @since 1.6 + * @since 1.6 */ public class DefaultMXBeanMappingFactory extends MXBeanMappingFactory { static abstract class NonNullMXBeanMapping extends MXBeanMapping { @@ -148,8 +150,8 @@ throws OpenDataException; /** - *

                    True if and only if this MXBeanMapping's toOpenValue and - * fromOpenValue methods are the identity function.

                    + * True if and only if this MXBeanMapping's toOpenValue and + * fromOpenValue methods are the identity function. */ boolean isIdentity() { return false; --- old/src/java.management/share/classes/com/sun/jmx/remote/internal/ServerCommunicatorAdmin.java 2015-05-15 20:25:31.202444020 +0400 +++ new/src/java.management/share/classes/com/sun/jmx/remote/internal/ServerCommunicatorAdmin.java 2015-05-15 20:25:31.046444020 +0400 @@ -57,8 +57,8 @@ * 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.
                    + * 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 { /** - *

                    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

                    + * The value associated with this attribute is a ClassLoader object. */ private static final String DEFAULT_CLASS_LOADER = JMXConnectorFactory.DEFAULT_CLASS_LOADER; /** - *

                    Name of the attribute that specifies a default class loader - * ObjectName. - * The value associated with this attribute is an ObjectName object

                    + * Name of the attribute that specifies a default class loader + * ObjectName. + * The value associated with this attribute is an ObjectName object. */ private static final String DEFAULT_CLASS_LOADER_NAME = JMXConnectorServerFactory.DEFAULT_CLASS_LOADER_NAME; @@ -74,7 +74,6 @@ * Get the Connector Server default class loader. *

                    * Returns: - *

                    *

                      *
                    • * The ClassLoader object found in env for @@ -114,6 +113,7 @@ * jmx.remote.default.class.loader.name is specified * but mbs is null. *
                    • + *
                    * @exception InstanceNotFoundException if * 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. *

                    * Returns: - *

                    *

                      *
                    • * The ClassLoader object found in env for @@ -232,7 +231,7 @@ /** * Returns the cause field of a {@code Throwable} object. * The cause field can be got only if t has an - * {@link Throwable#getCause()} method (JDK Version >= 1.4) + * {@link Throwable#getCause()} method (JDK Version {@literal >=} 1.4) * @param t {@code Throwable} on which the cause must be set. * @return the cause if getCause() succeeded and the got value is not * null, otherwise return the t. @@ -254,7 +253,7 @@ /** - *

                      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 - * Integer object. The default value is 1000.

                      + * {@code Integer} object. The default value is 1000. */ public static final String MAX_FETCH_NOTIFS = "jmx.remote.x.notification.fetch.max"; @@ -334,10 +333,10 @@ } /** - *

                      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 Long - * object. The default value is 60000 milliseconds.

                      + * object. The default value is 60000 milliseconds. */ public static final String FETCH_TIMEOUT = "jmx.remote.x.notification.fetch.timeout"; @@ -351,11 +350,12 @@ } /** - *

                      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 NotificationAccessController object. - * The default value is null.

                      + * The default value is null. + *

                      * 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.

                      + * The default value is 120000 milliseconds. */ public static final String SERVER_CONNECTION_TIMEOUT = "jmx.remote.x.server.connection.timeout"; @@ -646,9 +646,9 @@ } /** - *

                      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 the period in + * millisecond for a client to check its connection. The default + * value is 60000 milliseconds. */ public static final String CLIENT_CONNECTION_CHECK_PERIOD = "jmx.remote.x.client.connection.check.period"; @@ -741,13 +741,13 @@ } /** - *

                      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 getInternalRuntimeCounters(); --- old/src/java.management/share/classes/sun/management/HotspotThreadMBean.java 2015-05-15 20:25:32.718444019 +0400 +++ new/src/java.management/share/classes/sun/management/HotspotThreadMBean.java 2015-05-15 20:25:32.562444019 +0400 @@ -40,12 +40,11 @@ public int getInternalThreadCount(); /** - * Returns a Map of the name of all VM internal threads + * Returns a {@code Map} of the name of all VM internal threads * to the thread CPU time in nanoseconds. The returned value is * of nanoseconds precision but not necessarily nanoseconds accuracy. - *

                      * - * @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 where E is a type of 1-3 - * 6. Map where K and V are a type of 1-4 + *

                        + *
                      1. Primitive types
                      2. + *
                      3. Wrapper classes such java.lang.Integer, etc
                      4. + *
                      5. Classes with only getter methods and with a static "from" method + * that takes a CompositeData argument.
                      6. + *
                      7. {@code E[]} where {@code E} is a type of 1-4 (can be multi-dimensional array)
                      8. + *
                      9. {@code List} where E is a type of 1-3
                      10. + *
                      11. {@code Map} where {@code K} and {@code V} are a type of 1-4
                      12. + *
                      * * 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. * *

                      - * A AbstractSensor object consists of two attributes: + * A {@code AbstractSensor} object consists of two attributes: *

                        - *
                      • on is a boolean flag indicating if a sensor is + *
                      • {@code on} is a boolean flag indicating if a sensor is * triggered. This flag will be set or cleared by the * component that owns the sensor.
                      • - *
                      • count is the total number of times that a sensor + *
                      • {@code count} is the total number of times that a sensor * has been triggered.
                      • *
                      * @@ -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. * *

                      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}

                      + * 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

                      + * 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 @@ *

                    • com.sun.management.jdp.pause - set broadcast interval in seconds
                    • *
                    • com.sun.management.jdp.source_addr - an address of interface to use for broadcast
                    • *
                    -

                    + * *

                    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 @@ *
                  • The filter (default is "(objectclass=*)"). *
                  • The search controls (default is null SearchControls). *
                  • The events that the listener is interested in. This is determined by - * finding out which NamingListener interface the listener supports. + * finding out which {@code NamingListener} interface the listener supports. *
                  *

                  - *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: *

                    *
                  • leading and trailing whitespace - *
                  • , = + < > # ; " \
                    + *
                  • {@literal , = + < > # ; " \}
                    *
                  * If the value is a byte array, it is converted to hex * notation (such as "#CEB1DF80"). --- old/src/java.naming/share/classes/com/sun/jndi/ldap/LdapReferralException.java 2015-05-15 20:25:38.218444014 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/LdapReferralException.java 2015-05-15 20:25:38.062444014 +0400 @@ -35,7 +35,7 @@ * This exception is raised when a referral to an alternative context * is encountered. *

                  - * 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: - *

                  +     * 
                  {@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"}
                  -     * 
                  + * }
                  */ 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" on the result of the lookup. The - * "do" does the work without any further resolution (it assumes + * calls a corresponding "{@code do}" on the result of the lookup. The + * "{@code do}" does the work without any further resolution (it assumes * that it is the target context). */ --- old/src/java.naming/share/classes/com/sun/jndi/toolkit/dir/SearchFilter.java 2015-05-15 20:25:41.730444011 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/toolkit/dir/SearchFilter.java 2015-05-15 20:25:41.574444012 +0400 @@ -548,8 +548,8 @@ /** - * Finds the first occurrence of ch in val starting - * from position start. It doesn't count if ch + * Finds the first occurrence of {@code ch} in {@code val} starting + * from position {@code start}. It doesn't count if {@code ch} * has been escaped by a backslash (\) */ public static int findUnescaped(char ch, String val, int start) { @@ -568,8 +568,8 @@ } /** - * Formats the expression expr using arguments from the array - * args. + * Formats the expression {@code expr} using arguments from the array + * {@code args}. * * {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                         
                         * 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
                  +      * }
                  */ 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. * *

                  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: *

                    - *
                  • p's class is the same as this object's class, and

                    + *

                  • p's class is the same as this object's class, and *
                  • p's name equals or (in the case of wildcards) * is implied by this object's * name. For example, "a.b.*" implies "a.b.c", and @@ -111,7 +110,7 @@ * Checks two ExecOptionPermission objects for equality. * Checks that obj's class is the same as this object's class * and has the same name as this object. - *

                    + * * @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 any file. + * the special token "{@code <>}" matches any file. *

                    * 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 <>}" matches all files. * *

                    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 <>}" matches all files. * *

                    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: *

                      - *
                    • p is an instanceof ExecPermission,

                      and + *

                    • p is an instanceof ExecPermission, and *
                    • p's pathname is implied by this object's * pathname. For example, "/tmp/*" implies "/tmp/foo", since * "/tmp/*" encompasses the "/tmp" directory and all files in that @@ -140,7 +139,7 @@ * Checks two ExecPermission objects for equality. * Checks that obj's class is the same as this object's class * and has the same name as this object. - *

                      + * * @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: *

                        *
                      • the activation group's id, *
                      • the activation group's descriptor (an instance of the class --- old/src/java.rmi/share/classes/sun/rmi/transport/Channel.java 2015-05-15 20:25:48.138444006 +0400 +++ new/src/java.rmi/share/classes/sun/rmi/transport/Channel.java 2015-05-15 20:25:47.982444006 +0400 @@ -42,7 +42,7 @@ /** * Free the connection generated by this channel. - * @param c The connection + * @param conn The connection. * @param reuse If true, the connection is in a state in which it * can be reused for another method call. */ --- old/src/java.rmi/share/classes/sun/rmi/transport/LiveRef.java 2015-05-15 20:25:48.638444006 +0400 +++ new/src/java.rmi/share/classes/sun/rmi/transport/LiveRef.java 2015-05-15 20:25:48.482444006 +0400 @@ -56,7 +56,7 @@ /** * Construct a "well-known" live reference to a remote object - * @param isLocalServer If true, indicates this ref specifies a local + * @param isLocal If true, indicates this ref specifies a local * server in this address space; if false, the ref is for a remote * object (hence a surrogate or proxy) in another address space. */ --- old/src/java.rmi/share/classes/sun/rmi/transport/proxy/CGIHandler.java 2015-05-15 20:25:49.138444005 +0400 +++ new/src/java.rmi/share/classes/sun/rmi/transport/proxy/CGIHandler.java 2015-05-15 20:25:48.982444005 +0400 @@ -81,7 +81,7 @@ /** * The CGIHandler class contains methods for executing as a CGI program. * The main function interprets the query string as a command of the form - * "=". + * "{@code =}". * * This class depends on the CGI 1.0 environment variables being set as * properties of the same name in this Java VM. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/JoinRowSetImpl.java 2015-05-15 20:25:49.646444005 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/JoinRowSetImpl.java 2015-05-15 20:25:49.486444005 +0400 @@ -4063,14 +4063,16 @@ } /** - * Provide interface coverage for getURL(int) in ResultSet->RowSet + * Provide interface coverage for getURL(int) in + * ResultSet{@literal ->}RowSet */ public java.net.URL getURL(int columnIndex) throws SQLException { return crsInternal.getURL(columnIndex); } /** - * Provide interface coverage for getURL(String) in ResultSet->RowSet + * Provide interface coverage for getURL(String) in + * ResultSet{@literal ->}RowSet */ public java.net.URL getURL(String columnName) throws SQLException { return crsInternal.getURL(columnName); --- old/src/java.sql.rowset/share/classes/com/sun/rowset/providers/RIOptimisticProvider.java 2015-05-15 20:25:50.190444004 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/providers/RIOptimisticProvider.java 2015-05-15 20:25:50.034444005 +0400 @@ -36,7 +36,7 @@ * The reference implementation of a JDBC Rowset synchronization provider * providing optimistic synchronization with a relational datastore * using any JDBC technology-enabled driver. - *

                        + * *

                        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) {