stan/jdk-24
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

8080422: some docs cleanup for core libs

Browse Source 
Some docs cleanup

Reviewed-by: rriggs, lancea
This commit is contained in:
Alexander Stepanov 2015-05-19 16:04:14 +04:00
parent d4f45f51c9
commit 30cda926e9
106 changed files with 539 additions and 558 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
jdk/src/java.base/share/classes/java/text/ChoiceFormat.java
View File

@ -490,7 +490,7 @@ public class ChoiceFormat extends NumberFormat {
}
/**
* Equality comparision between two
* Equality comparison between two
*/
public boolean equals(Object obj) {
if (obj == null) return false;

2
jdk/src/java.base/share/classes/java/util/ArrayPrefixHelpers.java
View File

@ -85,7 +85,7 @@ class ArrayPrefixHelpers {
*
* As usual for this sort of utility, there are 4 versions, that
* are simple copy/paste/adapt variants of each other. (The
* double and int versions differ from long version soley by
* double and int versions differ from long version solely by
* replacing "long" (with case-matching)).
*/

6
jdk/src/java.base/share/classes/java/util/Calendar.java
View File

@ -1172,7 +1172,7 @@ public abstract class Calendar implements Serializable, Cloneable, Comparable<Ca
* {@code fieldValuePairs} that are pairs of a field and its value.
* For example,
* <pre>
* setFeilds(Calendar.YEAR, 2013,
* setFields(Calendar.YEAR, 2013,
* Calendar.MONTH, Calendar.DECEMBER,
* Calendar.DAY_OF_MONTH, 23);</pre>
* is equivalent to the sequence of the following
@ -1298,7 +1298,7 @@ public abstract class Calendar implements Serializable, Cloneable, Comparable<Ca
/**
* Sets the time zone parameter to the given {@code zone}. If no time
* zone parameter is given to this {@code Caledar.Builder}, the
* zone parameter is given to this {@code Calendar.Builder}, the
* {@linkplain TimeZone#getDefault() default
* <code>TimeZone</code>} will be used in the {@link #build() build}
* method.
@ -3316,7 +3316,7 @@ public abstract class Calendar implements Serializable, Cloneable, Comparable<Ca
* @param field the calendar field
* @return the calendar field name
* @exception IndexOutOfBoundsException if <code>field</code> is negative,
* equal to or greater then <code>FIELD_COUNT</code>.
* equal to or greater than {@code FIELD_COUNT}.
*/
static String getFieldName(int field) {
return FIELD_NAME[field];

2
jdk/src/java.base/share/classes/java/util/Collection.java
View File

@ -537,7 +537,7 @@ public interface Collection<E> extends Iterable<E> {
* @implSpec
* The default implementation creates a
* <em><a href="Spliterator.html#binding">late-binding</a></em> spliterator
* from the collections's {@code Iterator}. The spliterator inherits the
* from the collection's {@code Iterator}. The spliterator inherits the
* <em>fail-fast</em> properties of the collection's iterator.
* <p>
* The created {@code Spliterator} reports {@link Spliterator#SIZED}.

6
jdk/src/java.base/share/classes/java/util/Locale.java
View File

@ -719,7 +719,7 @@ public final class Locale implements Cloneable, Serializable {
* created and cached.
*
* @param language lowercase 2 to 8 language code.
* @param country uppercase two-letter ISO-3166 code and numric-3 UN M.49 area code.
* @param country uppercase two-letter ISO-3166 code and numeric-3 UN M.49 area code.
* @param variant vendor and browser specific code. See class description.
* @return the <code>Locale</code> instance requested
* @exception NullPointerException if any argument is null.
@ -1236,7 +1236,7 @@ public final class Locale implements Cloneable, Serializable {
/**
* Package private method returning the Locale's LocaleExtensions,
* used by ResourceBundle.
* @return locale exnteions of this Locale,
* @return locale extensions of this Locale,
* or {@code null} if no extensions are defined
*/
LocaleExtensions getLocaleExtensions() {
@ -2609,7 +2609,7 @@ public final class Locale implements Cloneable, Serializable {
* href="./Locale.html#def_locale_extension">well-formed</a> or an exception
* is thrown.
*
* <p>Attribute comparision for removal is case-insensitive.
* <p>Attribute comparison for removal is case-insensitive.
*
* @param attribute the attribute
* @return This builder.

4
jdk/src/java.base/share/classes/java/util/TreeMap.java
View File

@ -859,7 +859,7 @@ public class TreeMap<K,V>
* Returns a {@link Set} view of the mappings contained in this map.
*
* <p>The set's iterator returns the entries in ascending key order. The
* sets's spliterator is
* set's spliterator is
* <em><a href="Spliterator.html#binding">late-binding</a></em>,
* <em>fail-fast</em>, and additionally reports {@link Spliterator#SORTED} and
* {@link Spliterator#ORDERED} with an encounter order that is ascending key
@ -2643,7 +2643,7 @@ public class TreeMap<K,V>
* child, also serving as origin for the split-off spliterator.
* Left-hands are symmetric. Descending versions place the origin
* at the end and invert ascending split rules. This base class
* is non-commital about directionality, or whether the top-level
* is non-committal about directionality, or whether the top-level
* spliterator covers the whole tree. This means that the actual
* split mechanics are located in subclasses. Some of the subclass
* trySplit methods are identical (except for return types), but

2
jdk/src/java.base/share/classes/java/util/concurrent/ConcurrentHashMap.java
View File

@ -481,7 +481,7 @@ public class ConcurrentHashMap<K,V> extends AbstractMap<K,V>
*
* Maintaining API and serialization compatibility with previous
* versions of this class introduces several oddities. Mainly: We
* leave untouched but unused constructor arguments refering to
* leave untouched but unused constructor arguments referring to
* concurrencyLevel. We accept a loadFactor constructor argument,
* but apply it only to initial table capacity (which is the only
* time that we can guarantee to honor it.) We also declare an

4
jdk/src/java.base/share/classes/java/util/concurrent/ConcurrentSkipListMap.java
View File

@ -2710,7 +2710,7 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V>
}
/**
* Returns lowest absolute key (ignoring directonality).
* Returns lowest absolute key (ignoring directionality).
*/
K lowestKey() {
Comparator<? super K> cmp = m.comparator;
@ -2722,7 +2722,7 @@ public class ConcurrentSkipListMap<K,V> extends AbstractMap<K,V>
}
/**
* Returns highest absolute key (ignoring directonality).
* Returns highest absolute key (ignoring directionality).
*/
K highestKey() {
Comparator<? super K> cmp = m.comparator;

58
jdk/src/java.base/share/classes/jdk/internal/util/xml/impl/Parser.java
View File

@ -145,12 +145,12 @@ public abstract class Parser {
/**
* ASCII character type array.
*
* This array maps an ASCII (7 bit) character to the character type.<br />
* Possible character type values are:<br /> - ' ' for any kind of white
* space character;<br /> - 'a' for any lower case alphabetical character
* value;<br /> - 'A' for any upper case alphabetical character value;<br />
* - 'd' for any decimal digit character value;<br /> - 'z' for any
* character less then ' ' except '\t', '\n', '\r';<br /> An ASCII (7 bit)
* This array maps an ASCII (7 bit) character to the character type.<br>
* Possible character type values are:<br> - ' ' for any kind of white
* space character;<br> - 'a' for any lower case alphabetical character
* value;<br> - 'A' for any upper case alphabetical character value;<br>
* - 'd' for any decimal digit character value;<br> - 'z' for any
* character less than ' ' except '\t', '\n', '\r';<br> An ASCII (7 bit)
* character which does not fall in any category listed above is mapped to
* it self.
*/
@ -158,11 +158,11 @@ public abstract class Parser {
/**
* NMTOKEN character type array.
*
* This array maps an ASCII (7 bit) character to the character type.<br />
* Possible character type values are:<br /> - 0 for underscore ('_') or any
* lower and upper case alphabetical character value;<br /> - 1 for colon
* (':') character;<br /> - 2 for dash ('-') and dot ('.') or any decimal
* digit character value;<br /> - 3 for any kind of white space character<br
* This array maps an ASCII (7 bit) character to the character type.<br>
* Possible character type values are:<br> - 0 for underscore ('_') or any
* lower and upper case alphabetical character value;<br> - 1 for colon
* (':') character;<br> - 2 for dash ('-') and dot ('.') or any decimal
* digit character value;<br> - 3 for any kind of white space character<br
* /> An ASCII (7 bit) character which does not fall in any category listed
* above is mapped to 0xff.
*/
@ -1841,10 +1841,12 @@ public abstract class Parser {
/**
* Reads an attribute value.
*
* The grammar which this method can read is:<br />
* <code>eqstr := S &quot;=&quot; qstr</code><br />
* <code>qstr := S (&quot;'&quot; string &quot;'&quot;) |
* ('&quot;' string '&quot;')</code><br /> This method resolves entities
* The grammar this method can read is:
* <pre>{@code
* eqstr := S "=" qstr
* qstr := S ("'" string "'") | ('"' string '"')
* }</pre>
* This method resolves entities
* inside a string unless the parser parses DTD.
*
* @param flag The '=' character forces the method to accept the '='
@ -2633,7 +2635,7 @@ public abstract class Parser {
* Reports characters and empties the parser's buffer. This method is called
* only if parser is going to return control to the main loop. This means
* that this method may use parser buffer to report white space without
* copeing characters to temporary buffer.
* copying characters to temporary buffer.
*/
protected abstract void bflash()
throws Exception;
@ -2642,7 +2644,7 @@ public abstract class Parser {
* Reports white space characters and empties the parser's buffer. This
* method is called only if parser is going to return control to the main
* loop. This means that this method may use parser buffer to report white
* space without copeing characters to temporary buffer.
* space without copying characters to temporary buffer.
*/
protected abstract void bflash_ws()
throws Exception;
@ -3290,16 +3292,20 @@ public abstract class Parser {
}
/**
* Maps a character to it's type.
* Maps a character to its type.
*
* Possible character type values are:<br /> - ' ' for any kind of white
* space character;<br /> - 'a' for any lower case alphabetical character
* value;<br /> - 'A' for any upper case alphabetical character value;<br />
* - 'd' for any decimal digit character value;<br /> - 'z' for any
* character less then ' ' except '\t', '\n', '\r';<br /> - 'X' for any not
* ASCII character;<br /> - 'Z' for EOS character.<br /> An ASCII (7 bit)
* character which does not fall in any category listed above is mapped to
* it self.
* Possible character type values are:
* <ul>
* <li>' ' - for any kind of whitespace character;</li>
* <li>'a' - for any lower case alphabetical character value;</li>
* <li>'A' - for any upper case alphabetical character value;</li>
* <li>'d' - for any decimal digit character value;</li>
* <li>'z' - for any character less than ' ' except '\t', '\n', '\r';</li>
* <li>'X' - for any not ASCII character;</li>
* <li>'Z' - for EOS character.</li>
* </ul>
* 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.

4
jdk/src/java.base/share/classes/jdk/internal/util/xml/impl/ParserSAX.java
View File

@ -649,7 +649,7 @@ final class ParserSAX
* Reports characters and empties the parser's buffer. This method is called
* only if parser is going to return control to the main loop. This means
* that this method may use parser buffer to report white space without
* copeing characters to temporary buffer.
* copying characters to temporary buffer.
*/
protected void bflash() throws SAXException {
if (mBuffIdx >= 0) {
@ -663,7 +663,7 @@ final class ParserSAX
* Reports white space characters and empties the parser's buffer. This
* method is called only if parser is going to return control to the main
* loop. This means that this method may use parser buffer to report white
* space without copeing characters to temporary buffer.
* space without copying characters to temporary buffer.
*/
protected void bflash_ws() throws SAXException {
if (mBuffIdx >= 0) {

4
jdk/src/java.base/share/classes/sun/misc/Cache.java
View File

@ -196,8 +196,8 @@ public
/**
* 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) {

2
jdk/src/java.base/share/classes/sun/misc/CharacterDecoder.java
View File

@ -120,7 +120,7 @@ public abstract class CharacterDecoder {
/**
* This method does an actual decode. It takes the decoded bytes and
* writes them to the OutputStream. The integer <i>l</i> 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();

4
jdk/src/java.base/share/classes/sun/misc/CharacterEncoder.java
View File

@ -68,7 +68,7 @@ import java.nio.ByteBuffer;
* referenced in the See Also list below.
*
* @author Chuck McManis
* @see CharacterDecoder;
* @see CharacterDecoder
* @see UCEncoder
* @see UUEncoder
* @see BASE64Encoder
@ -107,7 +107,7 @@ public abstract class CharacterEncoder {
/**
* Encode the suffix that ends every output line. By default
* this method just prints a <newline> into the output stream.
* this method just prints a newline into the output stream.
*/
protected void encodeLineSuffix(OutputStream aStream) throws IOException {
pStream.println();

2
jdk/src/java.base/share/classes/sun/misc/ConditionLock.java
View File

@ -34,7 +34,7 @@ package sun.misc;
* 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. <p>
* lock until the state variable equals its desired value.
*
* @author Peter King
*/

51
jdk/src/java.base/share/classes/sun/misc/ExtensionDependency.java
View File

@ -45,26 +45,26 @@ import java.net.MalformedURLException;
import sun.net.www.ParseUtil;
/**
* <p>
* This class checks dependent extensions a particular jar file may have
* declared through its manifest attributes.
* </p>
* <p>
* Jar file declared dependent extensions through the extension-list
* attribute. The extension-list contains a list of keys used to
* fetch the other attributes describing the required extension.
* If key is the extension key declared in the extension-list
* attribute, the following describing attribute can be found in
* the manifest :
* key-Extension-Name: (Specification package name)
* key-Specification-Version: (Specification-Version)
* key-Implementation-Version: (Implementation-Version)
* key-Implementation-Vendor-Id: (Imlementation-Vendor-Id)
* key-Implementation-Version: (Implementation version)
* key-Implementation-URL: (URL to download the requested extension)
* the manifest:
* <ul>
* <li>key-Extension-Name: (Specification package name)</li>
* <li>key-Specification-Version: (Specification-Version)</li>
* <li>key-Implementation-Version: (Implementation-Version)</li>
* <li>key-Implementation-Vendor-Id: (Imlementation-Vendor-Id)</li>
* <li>key-Implementation-Version: (Implementation version)</li>
* <li>key-Implementation-URL: (URL to download the requested extension)</li>
* </ul>
* <p>
* This class also maintain versioning consistency of installed
* extensions dependencies declared in jar file manifest.
* </p>
*
* @deprecated this class will be removed in a future release.
* @author Jerome Dochez
@ -76,10 +76,9 @@ public class ExtensionDependency {
private static Vector<ExtensionInstallationProvider> providers;
/**
* <p>
* Register an ExtensionInstallationProvider. The provider is responsible
* for handling the installation (upgrade) of any missing extensions.
* </p>
*
* @param eip ExtensionInstallationProvider implementation
*/
public synchronized static void addExtensionInstallationProvider
@ -92,9 +91,7 @@ public class ExtensionDependency {
}
/**
* <p>
* Unregister a previously installed installation provider
* </p>
*/
public synchronized static void removeExtensionInstallationProvider
(ExtensionInstallationProvider eip)
@ -103,10 +100,9 @@ public class ExtensionDependency {
}
/**
* <p>
* Checks the dependencies of the jar file on installed extension.
* </p>
* @param jarFile containing the attriutes declaring the dependencies
*
* @param jar containing the attributes declaring the dependencies
*/
public static boolean checkExtensionsDependencies(JarFile jar)
{
@ -182,9 +178,8 @@ public class ExtensionDependency {
/*
* <p>
* Check that a particular dependency on an extension is satisfied.
* </p>
*
* @param extensionName is the key used for the attributes in the manifest
* @param attr is the attributes of the manifest file
*
@ -204,10 +199,9 @@ public class ExtensionDependency {
}
/*
* <p>
* Check if a particular extension is part of the currently installed
* extensions.
* </p>
*
* @param extensionName is the key for the attributes in the manifest
* @param attr is the attributes of the manifest
*
@ -262,11 +256,9 @@ public class ExtensionDependency {
}
/*
* <p>
* Check if the requested extension described by the attributes
* in the manifest under the key extensionName is compatible with
* the jar file.
* </p>
*
* @param extensionName key in the attribute list
* @param attr manifest file attributes
@ -337,10 +329,8 @@ public class ExtensionDependency {
}
/*
* <p>
* An required extension is missing, if an ExtensionInstallationProvider is
* registered, delegate the installation of that particular extension to it.
* </p>
*
* @param reqInfo Missing extension information
* @param instInfo Older installed version information
@ -380,11 +370,9 @@ public class ExtensionDependency {
}
/**
* <p>
* Checks if the extension, that is specified in the extension-list in
* the applet jar manifest, is already installed (i.e. exists in the
* extension directory).
* </p>
*
* @param extensionName extension name in the extension-list
*
@ -428,9 +416,7 @@ public class ExtensionDependency {
}
/**
* <p>
* @return the java.ext.dirs property as a list of directory
* </p>
*/
private static File[] getExtDirs() {
String s = java.security.AccessController.doPrivileged(
@ -456,9 +442,8 @@ public class ExtensionDependency {
}
/*
* <p>
* Scan the directories and return all files installed in those
* </p>
*
* @param dirs list of directories to scan
*
* @return the list of files installed in all the directories
@ -483,9 +468,7 @@ public class ExtensionDependency {
}
/*
* <p>
* @return the list of installed extensions jar files
* </p>
*/
private File[] getInstalledExtensions() throws IOException {
return AccessController.doPrivileged(
@ -503,9 +486,7 @@ public class ExtensionDependency {
}
/*
* <p>
* Add the newly installed jar file to the extension class loader.
* </p>
*
* @param cl the current installed extension class loader
*

35
jdk/src/java.base/share/classes/sun/misc/ExtensionInfo.java
View File

@ -45,9 +45,7 @@ import java.lang.Character.*;
public class ExtensionInfo {
/**
* <p>
* public static values returned by the isCompatible method
* </p>
*/
public static final int COMPATIBLE = 0;
public static final int REQUIRE_SPECIFICATION_UPGRADE = 1;
@ -56,10 +54,8 @@ public class ExtensionInfo {
public static final int INCOMPATIBLE = 4;
/**
* <p>
* attributes fully describer an extension. The underlying described
* extension may be installed and requested.
* <p>
*/
public String title;
public String name;
@ -76,15 +72,12 @@ public class ExtensionInfo {
/**
* <p>
* Create a new uninitialized extension information object
* </p>
*/
public ExtensionInfo() {
}
/**
* <p>
* 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 @@ public class ExtensionInfo {
* 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
* <p>
*
* @param extensionKey unique extension key in the manifest
* @param attr Attributes of a manifest file
*/
@ -149,13 +142,11 @@ public class ExtensionInfo {
}
/**
* <p>
* @return true if the extension described by this extension information
* is compatible with the extension described by the extension
* information passed as a parameter
* </p>
*
* @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 @@ public class ExtensionInfo {
}
/**
* <p>
* helper method to print sensible information on the undelying described
* extension
* </p>
*/
public String toString() {
return "Extension : title(" + title + "), name(" + name + "), spec vendor(" +
@ -217,15 +206,15 @@ public class ExtensionInfo {
}
/*
* <p>
* helper method to compare two versions.
* version are in the x.y.z.t pattern.
* </p>
*
* @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 <pre>{@code
* < 0 if source < version
* > 0 if source > version
* = 0 if source = version}</pre>
*/
private int compareExtensionVersion(String source, String target)
throws NumberFormatException
@ -238,15 +227,15 @@ public class ExtensionInfo {
/*
* <p>
* helper method to compare two versions.
* version are in the x.y.z.t pattern.
* </p>
*
* @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 <pre>{@code
* < 0 if source < version
* > 0 if source > version
* = 0 if source = version}</pre>
*/
private int strictCompareExtensionVersion(String source, String target)
throws NumberFormatException

34
jdk/src/java.base/share/classes/sun/misc/FDBigInteger.java
View File

@ -384,8 +384,8 @@ public /*@ spec_bigint_math @*/ class FDBigInteger {
* Retrieves the normalization bias of the <code>FDBigIntger</code>. 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:
* <code>(highestWord & 0xf0000000) == 0</code>, but the next bit should be 1
* <code>(highestWord & 0x08000000) != 0</code>.
* {@code (highestWord & 0xf0000000) == 0}, but the next bit should be 1
* {@code (highestWord & 0x08000000) != 0}.
*
* @return The normalization bias.
*/
@ -546,9 +546,9 @@ public /*@ spec_bigint_math @*/ class FDBigInteger {
* 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 <code>FDBigInteger</code>.
* @param S The divisor of this <code>FDBigInteger</code>.
* @return <code>q = (int)(this / S)</code>.
*/
/*@
@ -685,7 +685,7 @@ public /*@ spec_bigint_math @*/ class FDBigInteger {
*
* @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 @@ public /*@ spec_bigint_math @*/ class FDBigInteger {
/**
* Compares the parameter with this <code>FDBigInteger</code>. Returns an
* integer accordingly as:
* <pre>
* >0: this > other
* 0: this == other
* <0: this < other
* </pre>
* <pre>{@code
* > 0: this > other
* 0: this == other
* < 0: this < other
* }</pre>
*
* @param other The <code>FDBigInteger</code> to compare.
* @return A negative value, zero, or a positive value according to the
@ -974,11 +974,11 @@ public /*@ spec_bigint_math @*/ class FDBigInteger {
* Compares this <code>FDBigInteger</code> with
* <code>5<sup>p5</sup> * 2<sup>p2</sup></code>.
* Returns an integer accordingly as:
* <pre>
* >0: this > other
* 0: this == other
* <0: this < other
* </pre>
* <pre>{@code
* > 0: this > other
* 0: this == other
* < 0: this < other
* }</pre>
* @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 @@ public /*@ spec_bigint_math @*/ class FDBigInteger {
/**
* Compares this <code>FDBigInteger</code> with <code>x + y</code>. Returns a
* value according to the comparison as:
* <pre>
* <pre>{@code
* -1: this < x + y
* 0: this == x + y
* 1: this > x + y
* </pre>
* }</pre>
* @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.

2
jdk/src/java.base/share/classes/sun/misc/FloatingDecimal.java
View File

@ -154,7 +154,7 @@ public class FloatingDecimal{
/**
* Indicates the sign of the value.
* @return <code>value < 0.0</code>.
* @return {@code value < 0.0}.
*/
public boolean isNegative();

2
jdk/src/java.base/share/classes/sun/misc/IOUtils.java
View File

@ -39,7 +39,7 @@ public class IOUtils {
/**
* Read up to <code>length</code> of bytes from <code>in</code>
* 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

2
jdk/src/java.base/share/classes/sun/misc/JarFilter.java
View File

@ -29,10 +29,8 @@ import java.io.File;
import java.io.FilenameFilter;
/**
* <p>
* This class checks that only jar and zip files are included in the file list.
* This class is used in extension installation support (ExtensionDependency).
* <p>
*
* @deprecated this class will be removed in a future release.
* @author Michael Colburn

14
jdk/src/java.base/share/classes/sun/misc/JavaLangAccess.java
View File

@ -91,14 +91,14 @@ public interface JavaLangAccess {
* 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);

9
jdk/src/java.base/share/classes/sun/misc/Perf.java
View File

@ -67,13 +67,13 @@ public final class Perf {
* <code>AccessController.doPrivileged(PrivilegedAction)</code>.
* <p> Here is a suggested idiom for use of this class:
*
* <blockquote><pre>
* <blockquote><pre>{@code
* class MyTrustedClass {
* private static final Perf perf =
* AccessController.doPrivileged(new Perf.GetPerfAction<Perf>());
* ...
* }
* </pre></blockquote>
* }</pre></blockquote>
* <p>
* In the presence of a security manager, the <code>MyTrustedClass</code>
* class in the above example will need to be granted the
@ -171,8 +171,7 @@ public final class Perf {
* The attach mode specifies the access permissions requested for the
* instrumentation buffer of the target virtual machine. The permitted
* access permissions are:
* <p>
* <bl>
* <ul>
* <li>"r" - Read only access. This Java virtual machine has only
* read access to the instrumentation buffer for the target Java
* virtual machine.
@ -180,7 +179,7 @@ public final class Perf {
* write access to the instrumentation buffer for the target Java virtual
* machine. This mode is currently not supported and is reserved for
* future enhancements.
* </bl>
* </ul>
*
* @param lvmid an integer that uniquely identifies the
* target local Java virtual machine.

2
jdk/src/java.base/share/classes/sun/misc/PerfCounter.java
View File

@ -37,7 +37,7 @@ import java.security.AccessController;
* 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=<bytes> option. If there is
* with {@code -XX:PerfDataMemorySize=<bytes>} 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

4
jdk/src/java.base/share/classes/sun/misc/PerformanceLogger.java
View File

@ -51,10 +51,12 @@ import java.io.Writer;
* <P>
* To automatically track startup performance in an app or applet,
* use the command-line parameter sun.perflog as follows:<BR>
* <pre>{@code
* -Dsun.perflog[=file:<filename>]
* }</pre>
* <BR>
* where simply using the parameter with no value will enable output
* to the console and a value of "file:<filename>" will cause
* to the console and a value of "{@code file:<filename>}" will cause
* that given filename to be created and used for all output.
* <P>
* By default, times are measured using System.currentTimeMillis(). To use

3
jdk/src/java.base/share/classes/sun/misc/Resource.java
View File

@ -154,7 +154,8 @@ public abstract class Resource {
/**
* Returns the Resource data as a ByteBuffer, but only if the input stream
* was implemented on top of a ByteBuffer. Return <tt>null</tt> 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();

6
jdk/src/java.base/share/classes/sun/misc/Signal.java
View File

@ -50,7 +50,7 @@ import java.util.Hashtable;
* Signal objects are created based on their names. For example:
* <blockquote><pre>
* new Signal("INT");
* </blockquote></pre>
* </pre></blockquote>
* constructs a signal object corresponding to <code>SIGINT</code>, which is
* typically produced when the user presses <code>Ctrl-C</code> at the command line.
* The <code>Signal</code> constructor throws <code>IllegalArgumentException</code>
@ -64,7 +64,7 @@ import java.util.Hashtable;
* }
* };
* Signal.handle(new Signal("INT"), handler);
* </blockquote></pre>
* </pre></blockquote>
*
* @author Sheng Liang
* @author Bill Shannon
@ -149,7 +149,7 @@ public final class Signal {
*
* @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

13
jdk/src/java.base/share/classes/sun/misc/Unsafe.java
View File

@ -641,9 +641,9 @@ public final class Unsafe {
* <li>String: any object (not just a java.lang.String)
* <li>InterfaceMethodRef: (NYI) a method handle to invoke on that call site's arguments
* </ul>
* @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 @@ public final class Unsafe {
* 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 @@ public final class Unsafe {
* <p>
* 8-byte atomicity is only guaranteed on platforms on which
* support atomic accesses to longs.
* <p>
*
* @param o Java heap object in which the value resides, if any, else
* null

2
jdk/src/java.base/share/classes/sun/misc/VM.java
View File

@ -315,7 +315,7 @@ public class VM {
}
/*
* Add <tt>n</tt> 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

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_de.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_de extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_es.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_es extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_fr.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_fr extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_it.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_it extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_ja.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_ja extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_ko.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_ko extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_pt_BR.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_pt_BR extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_sv.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_sv extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_zh_CN.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_zh_CN extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

8
jdk/src/java.base/share/classes/sun/misc/resources/Messages_zh_TW.java
View File

@ -26,7 +26,7 @@
package sun.misc.resources;
/**
* <p> This class represents the <code>ResourceBundle</code>
* This class represents the {@code ResourceBundle}
* for sun.misc.
*
* @author Michael Colburn
@ -35,9 +35,9 @@ package sun.misc.resources;
public class Messages_zh_TW extends java.util.ListResourceBundle {
/**
* Returns the contents of this <code>ResourceBundle</code>.
* <p>
* @return the contents of this <code>ResourceBundle</code>.
* Returns the contents of this {@code ResourceBundle}.
*
* @return the contents of this {@code ResourceBundle}.
*/
public Object[][] getContents() {
return contents;

28
jdk/src/java.base/share/classes/sun/nio/cs/Surrogate.java
View File

@ -175,10 +175,10 @@ public class Surrogate {
* @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 @@ public class Surrogate {
* @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 @@ public class Surrogate {
* @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 @@ public class Surrogate {
* @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)) {

2
jdk/src/java.base/share/classes/sun/text/CompactByteArray.java
View File

@ -49,7 +49,7 @@ package sun.text;
* 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:
* <UL type = round>
* <UL type = circle>
* <LI>Fast access of the indexed values.
* <LI>Smaller memory footprint.
* </UL>

8
jdk/src/java.base/share/classes/sun/text/ComposedCharIter.java
View File

@ -50,7 +50,7 @@ public final class ComposedCharIter {
}
/**
* Construct a new <tt>ComposedCharIter</tt>. 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 @@ public final class ComposedCharIter {
/**
* Returns the next precomposed Unicode character.
* Repeated calls to <tt>next</tt> 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 <tt>false</tt> and further calls
* to <tt>next</tt> 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) {

2
jdk/src/java.base/share/classes/sun/text/Normalizer.java
View File

@ -32,7 +32,7 @@ import sun.text.normalizer.NormalizerImpl;
* 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 {

28
jdk/src/java.base/share/classes/sun/text/bidi/BidiBase.java
View File

@ -81,14 +81,13 @@ import sun.text.normalizer.UTF16;
*
* <h3>General remarks about the API:</h3>
*
* The &quot;limit&quot; 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.
* <p>
*
* Some of the API methods provide access to &quot;runs&quot;. Such a
* &quot;run&quot; 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.
* <p>
*
* <h3>Basic concept: paragraph</h3>
* A piece of text can be divided into several paragraphs by characters
@ -141,7 +140,8 @@ import sun.text.normalizer.UTF16;
* these special values are designed that way. Also, the implementation
* assumes that MAX_EXPLICIT_LEVEL is odd.
*
* <ul><b>See Also:</b>
* <p><b>See Also:</b>
* <ul>
* <li>{@link #LEVEL_DEFAULT_LTR}
* <li>{@link #LEVEL_DEFAULT_RTL}
* <li>{@link #LEVEL_OVERRIDE}
@ -153,7 +153,8 @@ import sun.text.normalizer.UTF16;
* Reordering mode values indicate which variant of the Bidi algorithm to
* use.
*
* <ul><b>See Also:</b>
* <p><b>See Also:</b>
* <ul>
* <li>{@link #setReorderingMode}
* <li>{@link #REORDER_DEFAULT}
* <li>{@link #REORDER_NUMBERS_SPECIAL}
@ -166,7 +167,8 @@ import sun.text.normalizer.UTF16;
*
* <h3>Basic concept: Reordering Options</h3>
* Reordering options can be applied during Bidi text transformations.
* <ul><b>See Also:</b>
* <p><b>See Also:</b>
* <ul>
* <li>{@link #setReorderingOptions}
* <li>{@link #OPTION_DEFAULT}
* <li>{@link #OPTION_INSERT_MARKS}
@ -202,7 +204,7 @@ import sun.text.normalizer.UTF16;
* and therefore its implementation omitted from this sample code.</li>
* </ul>
*
* <pre>
* <pre>{@code
*
* package com.ibm.icu.dev.test.bidi;
*
@ -451,7 +453,7 @@ import sun.text.normalizer.UTF16;
* }
* }
*
* </pre>
* }</pre>
*/
public class BidiBase {
@ -2419,9 +2421,9 @@ public class BidiBase {
* (same index) character if the level has the
* <code>LEVEL_OVERRIDE</code> bit set.<br><br>
* Except for that bit, it must be
* <code>paraLevel<=embeddingLevels[]<=MAX_EXPLICIT_LEVEL</code>,
* {@code paraLevel<=embeddingLevels[]<=MAX_EXPLICIT_LEVEL},
* with one exception: a level of zero may be specified for a
* paragraph separator even if <code>paraLevel&gt;0</code> when multiple
* paragraph separator even if {@code paraLevel > 0} when multiple
* paragraphs are submitted in the same call to <code>setPara()</code>.<br><br>
* <strong>Caution: </strong>A reference to this array, not a copy
* of the levels, will be stored in the <code>Bidi</code> object;
@ -2680,7 +2682,7 @@ public class BidiBase {
* 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.<p>
* the same value in such a case.
*
* @param paragraph a paragraph of text with optional character and
* paragraph attribute information
@ -2817,7 +2819,7 @@ public class BidiBase {
}
/**
* Get the index of a paragraph, given a position within the text.<p>
* 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 <code>[0..getProcessedLength()-1]</code>.

2
jdk/src/java.base/share/classes/sun/text/bidi/BidiRun.java
View File

@ -42,7 +42,7 @@ package sun.text.bidi;
/**
* 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 <quote>run</quote>.
* at the same embedding level, each such sequence is called a "run".
*
* <p>A BidiRun represents such a run by storing its essential properties,
* but does not duplicate the characters which form the run.

6
jdk/src/java.base/share/classes/sun/text/normalizer/ICUBinary.java
View File

@ -65,7 +65,7 @@ public final class ICUBinary
/**
* <p>ICU data header reader method.
* Takes a ICU generated big-endian input stream, parse the ICU standard
* file header and authenticates them.</p>
* file header and authenticates them.
* <p>Header format:
* <ul>
* <li> Header size (char)
@ -84,7 +84,7 @@ public final class ICUBinary
* [0] major [1] minor [2] milli [3] micro
* <li> Unicode version (4 bytes) this ICU is based on.
* </ul>
* </p>
*
* <p>
* Example of use:<br>
* <pre>
@ -98,7 +98,7 @@ public final class ICUBinary
* System.out.println("This is not a ICU data file");
* }
* </pre>
* </p>
*
* @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.

2
jdk/src/java.base/share/classes/sun/text/normalizer/IntTrie.java
View File

@ -58,7 +58,7 @@ public class IntTrie extends Trie
* trie.</p>
* @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

87
jdk/src/java.base/share/classes/sun/text/normalizer/NormalizerBase.java
View File

@ -55,16 +55,16 @@ import java.text.Normalizer;
* In Unicode, this can be encoded as a single character (the
* "composed" form):
*
* <p>
* <pre>
* 00C1 LATIN CAPITAL LETTER A WITH ACUTE
* </p>
* </pre>
*
* or as two separate characters (the "decomposed" form):
*
* <p>
* <pre>
* 0041 LATIN CAPITAL LETTER A
* 0301 COMBINING ACUTE ACCENT
* </p>
* </pre>
*
* 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 @@ import java.text.Normalizer;
*
* Similarly, the string "ffi" can be encoded as three separate letters:
*
* <p>
* <pre>
* 0066 LATIN SMALL LETTER F
* 0066 LATIN SMALL LETTER F
* 0069 LATIN SMALL LETTER I
* </p>
* </pre>
*
* or as the single character
*
* <p>
* <pre>
* FB03 LATIN SMALL LIGATURE FFI
* </p>
* </pre>
*
* 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 @@ public final class NormalizerBase implements Cloneable {
//-------------------------------------------------------------------------
/**
* Creates a new <tt>Normalizer</tt> object for iterating over the
* Creates a new {@code Normalizer} object for iterating over the
* normalized form of a given string.
* <p>
* The <tt>options</tt> parameter specifies which optional
* <tt>Normalizer</tt> features are to be enabled for this object.
* <p>
* 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 @@ public final class NormalizerBase implements Cloneable {
}
/**
* Creates a new <tt>Normalizer</tt> object for iterating over the
* Creates a new {@code Normalizer} object for iterating over the
* normalized form of the given text.
* <p>
*
* @param iter The input text to be normalized. The normalization
* will start at the beginning of the string.
*
@ -592,9 +592,9 @@ public final class NormalizerBase implements Cloneable {
}
/**
* Creates a new <tt>Normalizer</tt> object for iterating over the
* Creates a new {@code Normalizer} object for iterating over the
* normalized form of the given text.
* <p>
*
* @param iter The input text to be normalized. The normalization
* will start at the beginning of the string.
*
@ -615,13 +615,13 @@ public final class NormalizerBase implements Cloneable {
}
/**
* Clones this <tt>Normalizer</tt> 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 <tt>CharacterIterator</tt> is not duplicated unless the
* iterator's <tt>clone</tt> 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 @@ public final class NormalizerBase implements Cloneable {
//-------------------------------------------------------------------------
/**
* 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 @@ public final class NormalizerBase implements Cloneable {
* while {@link #next} and {@link #previous} iterate through characters
* in the normalized <em>output</em>. This means that there is not
* necessarily a one-to-one correspondence between characters returned
* by <tt>next</tt> and <tt>previous</tt> and the indices passed to and
* returned from <tt>setIndex</tt> and {@link #getIndex}.
* <p>
* @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 @@ public final class NormalizerBase implements Cloneable {
/**
* Retrieve the index of the start of the input text. This is the begin
* index of the <tt>CharacterIterator</tt> or the start (i.e. 0) of the
* <tt>String</tt> over which this <tt>Normalizer</tt> 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 @@ public final class NormalizerBase implements Cloneable {
/**
* Retrieve the index of the end of the input text. This is the end index
* of the <tt>CharacterIterator</tt> or the length of the <tt>String</tt>
* over which this <tt>Normalizer</tt> 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 @@ public final class NormalizerBase implements Cloneable {
* <b>Note:</b> This method sets the position in the <em>input</em>, while
* {@link #next} and {@link #previous} iterate through characters in the
* <em>output</em>. This means that there is not necessarily a one-to-one
* correspondence between characters returned by <tt>next</tt> and
* <tt>previous</tt> and the indices passed to and returned from
* <tt>setIndex</tt> 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 @@ public final class NormalizerBase implements Cloneable {
}
/**
* Retrieve the index of the end of the input text-> This is the end index
* of the <tt>CharacterIterator</tt> or the length of the <tt>String</tt>
* over which this <tt>Normalizer</tt> 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 @@ public final class NormalizerBase implements Cloneable {
* 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 <tt>setMode</tt>.
* <p>
* @param newMode the new mode for this <tt>Normalizer</tt>.
* {@link #last}, etc. after calling {@code setMode}.
*
* @param newMode the new mode for this {@code Normalizer}.
* The supported modes are:
* <ul>
* <li>{@link #COMPOSE} - Unicode canonical decompositiion
@ -985,7 +985,7 @@ public final class NormalizerBase implements Cloneable {
mode = newMode;
}
/**
* Return the basic operation performed by this <tt>Normalizer</tt>
* Return the basic operation performed by this {@code Normalizer}
*
* @see #setMode
* @stable ICU 2.8
@ -995,8 +995,8 @@ public final class NormalizerBase implements Cloneable {
}
/**
* Set the input text over which this <tt>Normalizer</tt> 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 @@ public final class NormalizerBase implements Cloneable {
}
/**
* Set the input text over which this <tt>Normalizer</tt> 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 @@ public final class NormalizerBase implements Cloneable {
//
/**
* Creates a new <tt>Normalizer</tt> 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 @@ public final class NormalizerBase implements Cloneable {
* 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);

13
jdk/src/java.base/share/classes/sun/text/normalizer/RangeValueIterator.java
View File

@ -38,12 +38,13 @@
package sun.text.normalizer;
/**
* <p>Interface for enabling iteration over sets of <int index, int value>,
* <p>Interface for enabling iteration over sets of
* {@code <int index, int value>},
* where index is the sorted integer index in ascending order and value, its
* associated integer value.</p>
* associated integer value.
* <p>The result for each iteration is the consecutive range of
* <int index, int value> with the same value. Result is represented by
* <start, limit, value> where</p>
* {@code <int index, int value>} with the same value. Result is represented by
* {@code <start, limit, value>} where
* <ul>
* <li> start is the starting integer of the result range
* <li> limit is 1 after the maximum integer that follows start, such that
@ -56,10 +57,10 @@ package sun.text.normalizer;
* Hence value(start) = value(start + 1) = .... = value(start + n) = .... =
* value(limit - 1). However value(start -1) != value(start) and
* value(limit) != value(start).
* </p>
*
* <p>Most implementations will be created by factory methods, such as the
* character type iterator in UCharacter.getTypeIterator. See example below.
* </p>
*
* Example of use:<br>
* <pre>
* RangeValueIterator iterator = UCharacter.getTypeIterator();

11
jdk/src/java.base/share/classes/sun/text/normalizer/Replaceable.java
View File

@ -71,10 +71,9 @@ package sun.text.normalizer;
* <li>If there is no previous character (i.e. start == 0), use the
* following character</li>
* <li>If there is no following character (i.e. the replaceable was
* empty), use default metadata<br>
* empty), use default metadata</li>
* <li>If the code point U+FFFF is seen, it should be interpreted as
* a special marker having no metadata<li>
* </li>
* a special marker having no metadata</li>
* </ul>
* If this is not the behavior, the subclass should document any differences.
*
@ -111,10 +110,10 @@ public interface Replaceable {
* starting at index <code>dstStart</code> and ending at index
* <code>dstStart + (srcLimit-srcStart) - 1</code>.
*
* @param srcStart the beginning index to copy, inclusive; <code>0
* <= start <= limit</code>.
* @param srcStart the beginning index to copy, inclusive;
* {@code 0 <= start <= limit}.
* @param srcLimit the ending index to copy, exclusive;
* <code>start <= limit <= length()</code>.
* {@code start <= limit <= length()}.
* @param dst the destination array.
* @param dstStart the start offset in the destination array.
* @stable ICU 2.0

6
jdk/src/java.base/share/classes/sun/text/normalizer/ReplaceableString.java
View File

@ -109,10 +109,10 @@ public class ReplaceableString implements Replaceable {
* starting at index <code>dstStart</code> and ending at index
* <code>dstStart + (srcLimit-srcStart) - 1</code>.
*
* @param srcStart the beginning index to copy, inclusive; <code>0
* <= start <= limit</code>.
* @param srcStart the beginning index to copy, inclusive;
* {@code 0 <= start <= limit}.
* @param srcLimit the ending index to copy, exclusive;
* <code>start <= limit <= length()</code>.
* {@code start <= limit <= length()}.
* @param dst the destination array.
* @param dstStart the start offset in the destination array.
* @stable ICU 2.0

6
jdk/src/java.base/share/classes/sun/text/normalizer/ReplaceableUCharacterIterator.java
View File

@ -150,14 +150,12 @@ public class ReplaceableUCharacterIterator extends UCharacterIterator {
}
/**
* <p>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.</p>
* 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()) {

15
jdk/src/java.base/share/classes/sun/text/normalizer/RuleCharacterIterator.java
View File

@ -101,22 +101,25 @@ public class RuleCharacterIterator {
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().
*/

4
jdk/src/java.base/share/classes/sun/text/normalizer/SymbolTable.java
View File

@ -78,7 +78,7 @@ public interface SymbolTable {
/**
* Lookup the characters associated with this string and return it.
* Return <tt>null</tt> 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 @@ public interface SymbolTable {
/**
* Lookup the UnicodeMatcher associated with the given character, and
* return it. Return <tt>null</tt> 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.

6
jdk/src/java.base/share/classes/sun/text/normalizer/Trie.java
View File

@ -160,8 +160,10 @@ public abstract class Trie
/**
* Lead surrogate code points' index displacement in the index array.
* <pre>{@code
* 0x10000-0xd800=0x2800
* 0x2800 >> INDEX_STAGE_1_SHIFT_
* }</pre>
*/
protected static final int LEAD_INDEX_OFFSET_ = 0x2800 >> 5;
/**
@ -191,7 +193,7 @@ public abstract class Trie
/**
* 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<<SURROGATE_BLOCK_BITS);
/** Length of the BMP portion of the index (stage 1) array. */
@ -297,7 +299,7 @@ public abstract class Trie
/**
* Internal trie getter from a code point.
* Could be faster(?) but longer with
* if((c32)<=0xd7ff) { (result)=_TRIE_GET_RAW(trie, data, 0, c32); }
* {@code if((c32)<=0xd7ff) { (result)=_TRIE_GET_RAW(trie, data, 0, c32); }}
* Gets the offset to data which the codepoint points to
* @param ch codepoint
* @return offset to data

35
jdk/src/java.base/share/classes/sun/text/normalizer/TrieIterator.java
View File

@ -37,17 +37,17 @@
package sun.text.normalizer;
/**
* <p>Class enabling iteration of the values in a Trie.</p>
* Class enabling iteration of the values in a Trie.
* <p>Result of each iteration contains the interval of codepoints that have
* the same value type and the value type itself.</p>
* the same value type and the value type itself.
* <p>The comparison of each codepoint value is done via extract(), which the
* default implementation is to return the value as it is.</p>
* default implementation is to return the value as it is.
* <p>Method extract() can be overwritten to perform manipulations on
* codepoint values in order to perform specialized comparison.</p>
* codepoint values in order to perform specialized comparison.
* <p>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.</p>
* <p>See com.ibm.icu.text.UCharacterTypeIterator for examples of use.</p>
* result will be in terms of int (32 bit) values.
* <p>See com.ibm.icu.text.UCharacterTypeIterator for examples of use.
* <p>Notes for porting utrie_enum from icu4c to icu4j:<br>
* 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 @@ package sun.text.normalizer;
* 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.
* </p>
* <p>There are basically 3 usage scenarios for porting:</p>
*
* <p>There are basically 3 usage scenarios for porting:
* <p>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.
* </p>
*
* <p>2) UTrieEnumValue and UTrieEnumRange both are implemented then implement
* a subclass of TrieIterator, override the extract method and iterate, e.g
* </p>
* <p>utrie_enum(&normTrie, _enumPropertyStartsValue, _enumPropertyStartsRange,
* set);<br>
* In Java :<br>
* a subclass of TrieIterator, override the extract method and iterate, e.g.<br>
* {@code utrie_enum(&normTrie, _enumPropertyStartsValue, _enumPropertyStartsRange,
* set);}<br>
* In Java:<br>
* <pre>
* class TrieIteratorImpl extends TrieIterator{
* public TrieIteratorImpl(Trie data){
@ -90,17 +89,17 @@ package sun.text.normalizer;
* // port the implementation of _enumPropertyStartsRange
* }
* </pre>
* </p>
*
* <p>3) UTrieEnumRange is the only implemented callback then just implement
* the while loop, when utrie_enum is called
* <pre>
* <pre>{@code
* // utrie_enum(&fcdTrie, NULL, _enumPropertyStartsRange, set);
* TrieIterator fcdIter = new TrieIterator(fcdTrieImpl.fcdTrie);
* while(fcdIter.next(result)){
* set.add(result.start);
* }
* </pre>
* </p>
* }</pre>
*
* @author synwee
* @see com.ibm.icu.impl.Trie
* @see com.ibm.icu.lang.UCharacterTypeIterator

4
jdk/src/java.base/share/classes/sun/text/normalizer/UCharacter.java
View File

@ -128,7 +128,7 @@ import java.util.MissingResourceException;
* Annex C: Compatibility Properties of UTS #18 Unicode Regular Expressions
* (http://www.unicode.org/reports/tr18/#Compatibility_Properties).
* </p>
* <p>
* <pre>{@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 @@ import java.util.MissingResourceException;
* - cntrl: getType(c)==CONTROL
* - graph: hasBinaryProperty(c, UProperty.POSIX_GRAPH)
* - print: hasBinaryProperty(c, UProperty.POSIX_PRINT)
* </p>
* }</pre>
* <p>
* The C/POSIX character classes are also available in UnicodeSet patterns,
* using patterns like [:graph:] or \p{graph}.

8
jdk/src/java.base/share/classes/sun/text/normalizer/UCharacterIterator.java
View File

@ -200,8 +200,7 @@ public abstract class UCharacterIterator
* iterator obtained by calling <code>getLength()</code>.
* <b>Usage:</b>
*
* <code>
* <pre>
* <pre>{@code
* UChacterIterator iter = new UCharacterIterator.getInstance(text);
* char[] buf = new char[iter.getLength()];
* iter.getText(buf);
@ -217,15 +216,14 @@ public abstract class UCharacterIterator
* buf = new char[iter.getLength()];
* }
* }
* </pre>
* </code>
* }</pre>
*
* @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);

18
jdk/src/java.base/share/classes/sun/text/normalizer/UTF16.java
View File

@ -38,26 +38,26 @@ package sun.text.normalizer;
/**
* <p>Standalone utility class providing UTF16 character conversions and
* indexing conversions.</p>
* indexing conversions.
* <p>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 <code>bounds()</code>.</p>
* using <code>bounds()</code>.
* <strong>Examples:</strong>
* <p>The following examples illustrate use of some of these methods.
* <pre>
* <pre>{@code
* // iteration forwards: Original
* for (int i = 0; i &lt; 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 &lt; 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 @@ package sun.text.normalizer;
* ch = UTF16.charAt(s,i);
* doSomethingWith(ch);
* }
* </pre>
* }</pre>
* <strong>Notes:</strong>
* <ul>
* <li>
@ -515,12 +515,12 @@ public final class UTF16
/**
* <p>Converts argument code point and returns a String object representing
* the code point's value in UTF16 format.</p>
* the code point's value in UTF16 format.
* <p>This method does not check for the validity of the codepoint, the
* results are not guaranteed if a invalid codepoint is passed as
* argument.</p>
* argument.
* <p>The result is a string whose length is 1 for non-supplementary code
* points, 2 otherwise.</p>
* points, 2 otherwise.
* @param ch code point
* @return string representation of the code point
*/

3
jdk/src/java.base/share/classes/sun/text/normalizer/UnicodeMatcher.java
View File

@ -45,7 +45,8 @@ package sun.text.normalizer;
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.

26
jdk/src/java.base/share/classes/sun/text/normalizer/UnicodeSet.java
View File

@ -107,8 +107,8 @@ import java.util.TreeSet;
* </tr>
* <tr>
* <td nowrap valign="top" align="left"><code>[a{ab}{ac}]</code></td>
* <td valign="top">The character 'a' and the multicharacter strings &quot;ab&quot; and
* &quot;ac&quot;</td>
* <td valign="top">The character 'a' and the multicharacter strings "ab" and
* "ac"</td>
* </tr>
* <tr>
* <td nowrap valign="top" align="left"><code>[\p{Lu}]</code></td>
@ -148,10 +148,10 @@ import java.util.TreeSet;
* literal. Thus "[a\\-b]", "[-ab]", and "[ab-]" all indicate the same
* set of three characters, 'a', 'b', and '-'.
*
* <p>Sets may be intersected using the '&' operator or the asymmetric
* <p>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 @@ import java.util.TreeSet;
* that is, U+0000 through 'a'-1 and 'z'+1 through U+10FFFF
* <tr valign=top><td nowrap><code>[[<em>pat1</em>][<em>pat2</em>]]</code>
* <td>The union of sets specified by <em>pat1</em> and <em>pat2</em>
* <tr valign=top><td nowrap><code>[[<em>pat1</em>]&[<em>pat2</em>]]</code>
* <tr valign=top><td nowrap><code>[[<em>pat1</em>]&amp;[<em>pat2</em>]]</code>
* <td>The intersection of sets specified by <em>pat1</em> and <em>pat2</em>
* <tr valign=top><td nowrap><code>[[<em>pat1</em>]-[<em>pat2</em>]]</code>
* <td>The asymmetric difference of sets specified by <em>pat1</em> and
@ -227,7 +227,7 @@ import java.util.TreeSet;
* </tr>
* <tr>
* <td nowrap valign="top" align="right"><code>property :=&nbsp; </code></td>
* <td valign="top"><em>a Unicode property set pattern</td>
* <td valign="top"><em>a Unicode property set pattern</em></td>
* </tr>
* </table>
* <br>
@ -337,8 +337,8 @@ public class UnicodeSet implements UnicodeMatcher {
}
/**
* Constructs a set containing the given range. If <code>end >
* start</code> 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 @@ public class UnicodeSet implements UnicodeMatcher {
* 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"}}
* <br><b>Warning: you cannot add an empty string ("") to a UnicodeSet.</b>
* @param s the source string
* @return this object, for chaining
@ -691,7 +691,7 @@ public class UnicodeSet implements UnicodeMatcher {
/**
* 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 <code>end > start</code>
* 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 @@ public class UnicodeSet implements UnicodeMatcher {
* 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

46
jdk/src/java.base/share/classes/sun/text/normalizer/UnicodeSetIterator.java
View File

@ -73,35 +73,35 @@ import java.util.Iterator;
public class UnicodeSetIterator {
/**
* Value of <tt>codepoint</tt> if the iterator points to a string.
* If <tt>codepoint == IS_STRING</tt>, then examine
* <tt>string</tt> 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 <tt>IS_STRING</tt>, 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 <tt>nextRange()</tt>,
* <tt>codepointEnd</tt> contains the inclusive end of the
* iteration range, if <tt>codepoint != IS_STRING</tt>. If
* iterating over code points using <tt>next()</tt>, or if
* <tt>codepoint == IS_STRING</tt>, then the value of
* <tt>codepointEnd</tt> 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 <tt>codepoint == IS_STRING</tt>, then <tt>string</tt> points
* to the current string. If <tt>codepoint != IS_STRING</tt>, the
* value of <tt>string</tt> 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 @@ public class UnicodeSetIterator {
/**
* 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 <tt>codepoint == IS_STRING</tt>, the value is a
* string in the <tt>string</tt> field. Otherwise the value is a
* range of one or more code points from <tt>codepoint</tt> to
* <tt>codepointeEnd</tt> 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.
*
* <p>The order of iteration is all code points ranges in sorted
* order, followed by all strings sorted order. Ranges are
* disjoint and non-contiguous. <tt>string</tt> is undefined
* unless <tt>codepoint == IS_STRING</tt>. Do not mix calls to
* <tt>next()</tt> and <tt>nextRange()</tt> without calling
* <tt>reset()</tt> 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 @@ public class UnicodeSetIterator {
/**
* 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 <tt>set</tt> 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) {

8
jdk/src/java.base/share/classes/sun/text/normalizer/Utility.java
View File

@ -227,7 +227,7 @@ public final class Utility {
/**
* 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 @@ public final class Utility {
/**
* 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 @@ public final class Utility {
}
/**
* Escape unprintable characters using <backslash>uxxxx notation
* for U+0000 to U+FFFF and <backslash>Uxxxxxxxx for U+10000 and
* Escape unprintable characters using {@code <backslash>uxxxx} notation
* for U+0000 to U+FFFF and {@code <backslash>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.

12
jdk/src/java.base/share/classes/sun/text/normalizer/VersionInfo.java
View File

@ -53,7 +53,7 @@ public final class VersionInfo
* @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 @@ public final class VersionInfo
/**
* 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,

42
jdk/src/java.management/share/classes/com/sun/jmx/mbeanserver/DefaultMXBeanMappingFactory.java
View File

@ -79,44 +79,46 @@ import sun.reflect.misc.ReflectUtil;
/**
* <p>A converter between Java types and the limited set of classes
* defined by Open MBeans.</p>
* defined by Open MBeans.
*
* <p>A Java type is an instance of java.lang.reflect.Type. For our
* <p>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<String> or Map<Integer,
* String[]>. On J2SE 1.4 and earlier, it can only be a Class.</p>
* or a ParameterizedType, such as {@code List<String>} or
* {@code Map<Integer, String[]>}.
* On J2SE 1.4 and earlier, it can only be a Class.
*
* <p>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:</p>
* <p>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:
*
* <pre>
* <pre>{@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> 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> String[] ArrayType(1, SimpleType.STRING)
* ThreadState (an Enum) String SimpleType.STRING
* Map<Integer, String[]> TabularData TabularType(
* Map<Integer, String[]> TabularData TabularType(
* CompositeType(
* {"key", SimpleType.INTEGER},
* {"value",
* ArrayType(1,
* SimpleType.STRING)}),
* indexNames={"key"})
* </pre>
* }</pre>
*
* <p>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.</p>
* 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 @@ public class DefaultMXBeanMappingFactory extends MXBeanMappingFactory {
throws OpenDataException;
/**
* <p>True if and only if this MXBeanMapping's toOpenValue and
* fromOpenValue methods are the identity function.</p>
* True if and only if this MXBeanMapping's toOpenValue and
* fromOpenValue methods are the identity function.
*/
boolean isIdentity() {
return false;

8
jdk/src/java.management/share/classes/com/sun/jmx/remote/internal/ServerCommunicatorAdmin.java
View File

@ -57,8 +57,8 @@ public abstract class ServerCommunicatorAdmin {
* <code>rspOutgoing</code> to inform that a response is sent out
* for the received request.
* @return the value of the termination flag:
* <ul><code>true</code> if the connection is already being terminated,
* <br><code>false</code> otherwise.</ul>
* true if the connection is already being terminated,
* false otherwise.
*/
public boolean reqIncoming() {
if (logger.traceOn()) {
@ -80,8 +80,8 @@ public abstract class ServerCommunicatorAdmin {
/**
* Tells that a response is sent out for a received request.
* @return the value of the termination flag:
* <ul><code>true</code> if the connection is already being terminated,
* <br><code>false</code> otherwise.</ul>
* true if the connection is already being terminated,
* false otherwise.
*/
public boolean rspOutgoing() {
if (logger.traceOn()) {

46
jdk/src/java.management/share/classes/com/sun/jmx/remote/util/EnvHelp.java
View File

@ -55,17 +55,17 @@ import javax.management.remote.JMXConnectorServer;
public class EnvHelp {
/**
* <p>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</p>
* The value associated with this attribute is a ClassLoader object.
*/
private static final String DEFAULT_CLASS_LOADER =
JMXConnectorFactory.DEFAULT_CLASS_LOADER;
/**
* <p>Name of the attribute that specifies a default class loader
* ObjectName.
* The value associated with this attribute is an ObjectName object</p>
* 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 @@ public class EnvHelp {
* Get the Connector Server default class loader.
* <p>
* Returns:
* <p>
* <ul>
* <li>
* The ClassLoader object found in <var>env</var> for
@ -114,6 +113,7 @@ public class EnvHelp {
* <code>jmx.remote.default.class.loader.name</code> is specified
* but <var>mbs</var> is null.
* </li>
* </ul>
* @exception InstanceNotFoundException if
* <code>jmx.remote.default.class.loader.name</code> is specified
* and the ClassLoader MBean is not found in <var>mbs</var>.
@ -172,7 +172,6 @@ public class EnvHelp {
* Get the Connector Client default class loader.
* <p>
* Returns:
* <p>
* <ul>
* <li>
* The ClassLoader object found in <var>env</var> for
@ -232,7 +231,7 @@ public class EnvHelp {
/**
* Returns the cause field of a {@code Throwable} object.
* The cause field can be got only if <var>t</var> 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 <var>t</var>.
@ -254,7 +253,7 @@ public class EnvHelp {
/**
* <p>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 @@ public class EnvHelp {
}
/**
* <p>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
* <code>Integer</code> object. The default value is 1000.</p>
* {@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 @@ public class EnvHelp {
}
/**
* <p>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 <code>Long</code>
* object. The default value is 60000 milliseconds.</p>
* object. The default value is 60000 milliseconds.
*/
public static final String FETCH_TIMEOUT =
"jmx.remote.x.notification.fetch.timeout";
@ -351,11 +350,12 @@ public class EnvHelp {
}
/**
* <p>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 <code>NotificationAccessController</code> object.
* The default value is null.</p>
* The default value is null.
* <p>
* This field is not public because of its com.sun dependency.
*/
public static final String NOTIF_ACCESS_CONTROLLER =
@ -630,9 +630,9 @@ public class EnvHelp {
}
/**
* <p>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.</p>
* The default value is 120000 milliseconds.
*/
public static final String SERVER_CONNECTION_TIMEOUT =
"jmx.remote.x.server.connection.timeout";
@ -646,9 +646,9 @@ public class EnvHelp {
}
/**
* <p>Name of the attribute that specifies the period in
* millisecond for a client to check its connection. The default
* value is 60000 milliseconds.</p>
* 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 @@ public class EnvHelp {
}
/**
* <p>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

2
jdk/src/java.management/share/classes/sun/management/HotspotRuntimeMBean.java
View File

@ -64,7 +64,7 @@ public interface HotspotRuntimeMBean {
* Returns a list of internal counters maintained in the Java
* virtual machine for the runtime system.
*
* @return a <tt>List</tt> 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<Counter> getInternalRuntimeCounters();

5
jdk/src/java.management/share/classes/sun/management/HotspotThreadMBean.java
View File

@ -40,12 +40,11 @@ public interface HotspotThreadMBean {
public int getInternalThreadCount();
/**
* Returns a <tt>Map</tt> 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.
* <p>
*
* @return a <tt>Map</tt> 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

16
jdk/src/java.management/share/classes/sun/management/MappedMXBeanType.java
View File

@ -45,13 +45,15 @@ import static javax.management.openmbean.SimpleType.*;
* 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<E> where E is a type of 1-3
* 6. Map<K, V> where K and V are a type of 1-4
* <ol>
* <li>Primitive types</li>
* <li>Wrapper classes such java.lang.Integer, etc</li>
* <li>Classes with only getter methods and with a static "from" method
* that takes a CompositeData argument.</li>
* <li>{@code E[]} where {@code E} is a type of 1-4 (can be multi-dimensional array)</li>
* <li>{@code List<E>} where E is a type of 1-3</li>
* <li>{@code Map<K, V>} where {@code K} and {@code V} are a type of 1-4</li>
* </ol>
*
* OpenDataException will be thrown if a Java type is not supported.
*/

18
jdk/src/java.management/share/classes/sun/management/Sensor.java
View File

@ -34,12 +34,12 @@ import java.util.HashMap;
* An abstract sensor.
*
* <p>
* A <tt>AbstractSensor</tt> object consists of two attributes:
* A {@code AbstractSensor} object consists of two attributes:
* <ul>
* <li><tt>on</tt> is a boolean flag indicating if a sensor is
* <li>{@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.</li>
* <li><tt>count</tt> is the total number of times that a sensor
* <li>{@code count} is the total number of times that a sensor
* has been triggered.</li>
* </ul>
*
@ -54,7 +54,7 @@ public abstract class Sensor {
private boolean on;
/**
* Constructs a <tt>Sensor</tt> object.
* Constructs a {@code Sensor} object.
*
* @param name The name of this sensor.
*/
@ -88,8 +88,8 @@ public abstract class Sensor {
/**
* Tests if this sensor is currently on.
*
* @return <tt>true</tt> if the sensor is currently on;
* <tt>false</tt> otherwise.
* @return {@code true} if the sensor is currently on;
* {@code false} otherwise.
*
*/
public boolean isOn() {
@ -112,7 +112,7 @@ public abstract class Sensor {
/**
* Triggers this sensor. This method sets this sensor on
* and increments the count with the input <tt>increment</tt>.
* and increments the count with the input {@code increment}.
*/
public void trigger(int increment) {
synchronized (lock) {
@ -126,7 +126,7 @@ public abstract class Sensor {
/**
* Triggers this sensor piggybacking a memory usage object.
* This method sets this sensor on
* and increments the count with the input <tt>increment</tt>.
* and increments the count with the input {@code increment}.
*/
public void trigger(int increment, MemoryUsage usage) {
synchronized (lock) {
@ -150,7 +150,7 @@ public abstract class Sensor {
/**
* Clears this sensor
* and increments the count with the input <tt>increment</tt>.
* and increments the count with the input {@code increment}.
*/
public void clear(int increment) {
synchronized (lock) {

2
jdk/src/java.management/share/classes/sun/management/counter/Counter.java
View File

@ -63,7 +63,7 @@ public interface Counter extends java.io.Serializable {
public Object getValue();
/**
* Returns <tt>true</tt> if this counter is an internal counter.
* Returns {@code true} if this counter is an internal counter.
*/
public boolean isInternal();

4
jdk/src/java.management/share/classes/sun/management/counter/perf/InstrumentationException.java
View File

@ -27,14 +27,14 @@ package sun.management.counter.perf;
public class InstrumentationException extends RuntimeException {
/**
* Constructs a <tt>InstrumentationException</tt> with no
* Constructs a {@code InstrumentationException} with no
* detail message.
*/
public InstrumentationException() {
}
/**
* Constructs a <tt>InstrumentationException</tt> with a specified
* Constructs a {@code InstrumentationException} with a specified
* detail message.
*
* @param message the detail message

15
jdk/src/java.management/share/classes/sun/management/jdp/JdpController.java
View File

@ -37,19 +37,18 @@ import sun.management.VMManagement;
import sun.misc.ManagedLocalsThread;
/**
* JdpController is responsible to create and manage a broadcast loop
* JdpController is responsible to create and manage a broadcast loop.
*
* <p> 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}</p>
* and {@link #stopDiscoveryService() stopDiscoveryService}
* <p>{@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</p>
* times as it stops the running service if it is necessary.
* Call to {@link #stopDiscoveryService() stopDiscoveryService}
* ignored if service isn't run.
*
*
* </p>
*
* <p> 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 @@ import sun.misc.ManagedLocalsThread;
* <li>com.sun.management.jdp.pause - set broadcast interval in seconds</li>
* <li>com.sun.management.jdp.source_addr - an address of interface to use for broadcast</li>
* </ul>
</p>
*
* <p>null parameters values are filtered out on {@link JdpPacketWriter} level and
* corresponding keys are not placed to packet.</p>
* corresponding keys are not placed to packet.
*/
public final class JdpController {

2
jdk/src/java.naming/share/classes/com/sun/jndi/ldap/BasicControl.java
View File

@ -28,7 +28,7 @@ package com.sun.jndi.ldap;
import javax.naming.ldap.*;
/**
* This class provides a basic implementation of the <tt>Control</tt>
* This class provides a basic implementation of the {@code Control}
* interface. It represents an LDAPv3 Control as defined in RFC-2251.
*
* @author Vincent Ryan

2
jdk/src/java.naming/share/classes/com/sun/jndi/ldap/BerDecoder.java
View File

@ -295,7 +295,7 @@ public final class BerDecoder extends Ber {
* 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
* <tt>tag</tt>, 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 {

16
jdk/src/java.naming/share/classes/com/sun/jndi/ldap/EventQueue.java
View File

@ -73,16 +73,16 @@ final class EventQueue implements Runnable {
// package private;
/**
* Enqueue an event.
* @param event Either a <tt>NamingExceptionEvent</tt> or a subclass
* of <tt>NamingEvent</tt> or
* <tt>UnsolicitedNotificationEvent</tt>.
* If it is a subclass of <tt>NamingEvent</tt>, all listeners must implement
* the corresponding subinterface of <tt>NamingListener</tt>.
* For example, for a <tt>ObjectAddedEvent</tt>, all listeners <em>must</em>
* implement the <tt>ObjectAddedListener</tt> 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 <em>must</em>
* implement the {@code ObjectAddedListener} interface.
* <em>The current implementation does not check this before dispatching
* the event.</em>
* If the event is a <tt>NamingExceptionEvent</tt>, 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.
*/

14
jdk/src/java.naming/share/classes/com/sun/jndi/ldap/EventSupport.java
View File

@ -55,14 +55,14 @@ import javax.naming.ldap.UnsolicitedNotification;
*<li>The filter (default is "(objectclass=*)").
*<li>The search controls (default is null SearchControls).
*<li>The events that the listener is interested in. This is determined by
* finding out which <tt>NamingListener</tt> interface the listener supports.
* finding out which {@code NamingListener} interface the listener supports.
*</ul>
*<p>
*A notifier (<tt>NamingEventNotifier</tt>) 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 <tt>NamingListener</tt> interfaces.
*the same {@code NamingListener} interfaces.
*<p>
*For unsolicited listeners, this class maintains a vector, unsolicited.
*When an unsolicited listener is registered, this class adds itself
@ -93,7 +93,7 @@ import javax.naming.ldap.UnsolicitedNotification;
*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 <tt>fireXXXEvent</tt> 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 <em>event queue</em>.
*This class maintains an event queue and a dispatching thread that dequeues
@ -138,7 +138,7 @@ final class EventSupport {
}
/**
* Adds <tt>l</tt> to list of listeners interested in <tt>nm</tt>.
* Adds {@code l} to list of listeners interested in {@code nm}.
*/
/*
* Make the add/removeNamingListeners synchronized to:
@ -173,7 +173,7 @@ final class EventSupport {
}
/**
* Adds <tt>l</tt> to list of listeners interested in <tt>nm</tt>
* Adds {@code l} to list of listeners interested in {@code nm}
* and filter.
*/
synchronized void addNamingListener(String nm, String filter,
@ -201,7 +201,7 @@ final class EventSupport {
}
/**
* Removes <tt>l</tt> 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");

2
jdk/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java
View File

@ -336,7 +336,7 @@ public final class LdapName implements Name {
* characters:
*<ul>
*<li>leading and trailing whitespace
*<li><pre>, = + < > # ; " \</pre>
*<li><pre>{@literal , = + < > # ; " \}</pre>
*</ul>
* If the value is a byte array, it is converted to hex
* notation (such as "#CEB1DF80").

16
jdk/src/java.naming/share/classes/com/sun/jndi/ldap/LdapReferralException.java
View File

@ -35,7 +35,7 @@ import java.util.Vector;
* This exception is raised when a referral to an alternative context
* is encountered.
* <p>
* An <tt>LdapReferralException</tt> 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 @@ import java.util.Vector;
* of an authentication error, a referral may be retried with different
* environment properties.
* <p>
* An <tt>LdapReferralException</tt> object may also contain a reference
* to a chain of unprocessed <tt>LdapReferralException</tt> 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
* <tt>LdapReferralException</tt> objects remain, then the
* <tt>LdapReferralException</tt> 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.
* <p>
* If new <tt>LdapReferralException</tt> 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 <tt>LdapReferralException</tt>
* to the end of the chain of unprocessed {@code LdapReferralException}
* objects.
* <p>
* If an exception was recorded while processing a chain of
* <tt>LdapReferralException</tt> objects then it is throw once
* {@code LdapReferralException} objects then it is throw once
* processing has completed.
*
* @author Vincent Ryan

4
jdk/src/java.naming/share/classes/com/sun/jndi/ldap/UnsolicitedResponseImpl.java
View File

@ -65,7 +65,7 @@ final class UnsolicitedResponseImpl implements UnsolicitedNotification {
* Retrieves the object identifier of the response.
*
* @return A possibly null object identifier string representing the LDAP
* <tt>ExtendedResponse.responseName</tt> component.
* {@code ExtendedResponse.responseName} component.
*/
public String getID() {
return oid;
@ -79,7 +79,7 @@ final class UnsolicitedResponseImpl implements UnsolicitedNotification {
* 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 <tt>ExtendedResponse.response</tt>
* contents of the LDAP {@code ExtendedResponse.response}
* component.
*/
public byte[] getEncodedValue() {

26
jdk/src/java.naming/share/classes/com/sun/jndi/ldap/ext/StartTlsResponseImpl.java
View File

@ -52,10 +52,10 @@ import com.sun.jndi.ldap.Connection;
* The object identifier for StartTLS is 1.3.6.1.4.1.1466.20037
* and no extended response value is defined.
*
*<p>
* <p>
* 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 <tt>extendedOperation()</tt> is invoked.
* the JNDI context on which {@code extendedOperation()} is invoked.
*
* @see StartTlsRequest
* @author Vincent Ryan
@ -124,7 +124,7 @@ final public class StartTlsResponseImpl extends StartTlsResponse {
/**
* Overrides the default list of cipher suites enabled for use on the
* TLS connection. The cipher suites must have already been listed by
* <tt>SSLSocketFactory.getSupportedCipherSuites()</tt> 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 @@ final public class StartTlsResponseImpl extends StartTlsResponse {
}
/**
* Overrides the default hostname verifier used by <tt>negotiate()</tt>
* Overrides the default hostname verifier used by {@code negotiate()}
* after the TLS handshake has completed. If
* <tt>setHostnameVerifier()</tt> has not been called before
* <tt>negotiate()</tt> is invoked, <tt>negotiate()</tt>
* {@code setHostnameVerifier()} has not been called before
* {@code negotiate()} is invoked, {@code negotiate()}
* will perform a simple case ignore match. If called after
* <tt>negotiate()</tt>, 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 @@ final public class StartTlsResponseImpl extends StartTlsResponse {
/**
* Negotiates a TLS session using the default SSL socket factory.
* <p>
* This method is equivalent to <tt>negotiate(null)</tt>.
* 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 @@ final public class StartTlsResponseImpl extends StartTlsResponse {
* attaches it to the existing connection. Performs the TLS handshake
* and returns the negotiated session information.
* <p>
* If cipher suites have been set via <tt>setEnabledCipherSuites</tt>
* If cipher suites have been set via {@code setEnabledCipherSuites}
* then they are enabled before the TLS handshake begins.
* <p>
* Hostname verification is performed after the TLS handshake completes.
@ -186,7 +186,7 @@ final public class StartTlsResponseImpl extends StartTlsResponse {
* 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 <tt>setHostnameVerifier</tt> then that verifier is used if
* been set via {@code setHostnameVerifier} then that verifier is used if
* the default check fails.
* <p>
* If an error occurs then the SSL socket is closed and an IOException
@ -195,7 +195,7 @@ final public class StartTlsResponseImpl extends StartTlsResponse {
* @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 @@ final public class StartTlsResponseImpl extends StartTlsResponse {
* 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 {

4
jdk/src/java.naming/share/classes/com/sun/jndi/ldap/sasl/LdapSasl.java
View File

@ -72,12 +72,12 @@ final public class LdapSasl {
* property has not been set, Context.SECURITY_PRINCIPAL is used.
* If SASL_CALLBACK has been set, use that instead of the default
* CallbackHandler.
*<p>
* <p>
* 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.
*<p>
*
* @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

6
jdk/src/java.naming/share/classes/com/sun/jndi/toolkit/ctx/Continuation.java
View File

@ -329,7 +329,7 @@ public class Continuation extends ResolveResult {
*<p>
* 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 @@ public class Continuation extends ResolveResult {
*<p>
* 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 @@ public class Continuation extends ResolveResult {
/**
* 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.

4
jdk/src/java.naming/share/classes/com/sun/jndi/toolkit/ctx/PartialCompositeContext.java
View File

@ -452,14 +452,14 @@ public abstract class PartialCompositeContext implements Context, Resolver {
* nonempty component, and if 'prefix' ends with an empty component or
* 'name' starts with one, then one empty component is dropped.
* For example:
* <pre>
* <pre>{@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"}
* </pre>
* }</pre>
*/
public Name composeName(Name name, Name prefix) throws NamingException {
Name res = (Name)prefix.clone();

4
jdk/src/java.naming/share/classes/com/sun/jndi/toolkit/dir/HierMemDirCtx.java
View File

@ -32,8 +32,8 @@ import java.util.*;
/**
* 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<OperationName>" on the result of the lookup. The
* "do<OperationName>" does the work without any further resolution (it assumes
* calls a corresponding "{@code do<OperationName>}" on the result of the lookup. The
* "{@code do<OperationName>}" does the work without any further resolution (it assumes
* that it is the target context).
*/

8
jdk/src/java.naming/share/classes/com/sun/jndi/toolkit/dir/SearchFilter.java
View File

@ -548,8 +548,8 @@ public class SearchFilter implements AttrFilter {
/**
* Finds the first occurrence of <tt>ch</tt> in <tt>val</tt> starting
* from position <tt>start</tt>. It doesn't count if <tt>ch</tt>
* 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 @@ public class SearchFilter implements AttrFilter {
}
/**
* Formats the expression <tt>expr</tt> using arguments from the array
* <tt>args</tt>.
* Formats the expression {@code expr} using arguments from the array
* {@code args}.
*
* <code>{i}</code> specifies the <code>i</code>'th element from
* the array <code>args</code> is to be substituted for the

2
jdk/src/java.naming/share/classes/com/sun/jndi/toolkit/url/GenericURLContext.java
View File

@ -107,12 +107,14 @@ abstract public class GenericURLContext implements Context {
* the subclass must override getURLSuffix() to get the correct behavior.
* Remember, the behavior must match getRootURLContext().
*
* <pre>{@code
* URL Suffix
* foo://host:port <empty string>
* 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
* }</pre>
*/
protected Name getURLSuffix(String prefix, String url) throws NamingException {
String suffix = url.substring(prefix.length());

10
jdk/src/java.naming/share/classes/com/sun/jndi/toolkit/url/Uri.java
View File

@ -47,7 +47,7 @@ import java.net.MalformedURLException;
* still run on pre-1.4 platforms not containing that class.
*
* <p> The format of an absolute URI (see the RFCs mentioned above) is:
* <p><blockquote><pre>
* <blockquote><pre>{@code
* absoluteURI = scheme ":" ( hier_part | opaque_part )
*
* scheme = alpha *( alpha | digit | "+" | "-" | "." )
@ -94,12 +94,12 @@ import java.net.MalformedURLException;
* mark = "-" | "_" | "." | "!" | "~" | "*" | "'" | "(" | ")"
* escaped = "%" hex hex
* unwise = "{" | "}" | "|" | "\" | "^" | "`"
* </pre></blockquote>
* }</pre></blockquote>
*
* <p> Currently URIs containing <tt>userinfo</tt> or <tt>reg_name</tt>
* <p> Currently URIs containing {@code userinfo} or {@code reg_name}
* are not supported.
* The <tt>opaque_part</tt> of a non-hierarchical URI is treated as if
* if were a <tt>path</tt> 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.
*/

9
jdk/src/java.rmi/share/classes/com/sun/rmi/rmid/ExecOptionPermission.java
View File

@ -32,7 +32,6 @@ import java.util.*;
/**
* The ExecOptionPermission class represents permission for rmid to use
* a specific command-line option when launching an activation group.
* <P>
*
* @author Ann Wollrath
*
@ -68,9 +67,9 @@ public final class ExecOptionPermission extends Permission
* Checks if the specified permission is "implied" by
* this object.
* <P>
* More specifically, this method returns true if:<p>
* More specifically, this method returns true if:
* <ul>
* <li> <i>p</i>'s class is the same as this object's class, and<p>
* <li> <i>p</i>'s class is the same as this object's class, and
* <li> <i>p</i>'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 @@ public final class ExecOptionPermission extends Permission
* Checks two ExecOptionPermission objects for equality.
* Checks that <i>obj</i>'s class is the same as this object's class
* and has the same name as this object.
* <P>
*
* @param obj the object we are testing for equality with this object.
* @return true if <i>obj</i> is an ExecOptionPermission, and has the same
* name as this ExecOptionPermission object, false otherwise.
@ -154,7 +153,7 @@ public final class ExecOptionPermission extends Permission
* Returns a new PermissionCollection object for storing
* ExecOptionPermission objects.
* <p>
* A ExecOptionPermissionCollection stores a collection of
* An ExecOptionPermissionCollection stores a collection of
* ExecOptionPermission permissions.
*
* <p>ExecOptionPermission objects must be stored in a manner that allows

13
jdk/src/java.rmi/share/classes/com/sun/rmi/rmid/ExecPermission.java
View File

@ -40,14 +40,13 @@ import java.util.*;
* 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 "&lt;&lt;ALL FILES&gt;&gt;" matches <bold>any</bold> file.
* the special token "{@code <<ALL FILES>>}" matches <b>any</b> file.
* <P>
* 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.
* <P>
*
*
* @author Ann Wollrath
@ -72,7 +71,7 @@ public final class ExecPermission extends Permission
* 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
* "&lt;&lt;ALL FILES&gt;&gt;" matches all files.
* "{@code <<ALL FILES>>}" matches all files.
*
* <p>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 @@ public final class ExecPermission extends Permission
* 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
* "&lt;&lt;ALL FILES&gt;&gt;" matches all files.
* "{@code <<ALL FILES>>}" matches all files.
*
* <p>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 @@ public final class ExecPermission extends Permission
/**
* Checks if this ExecPermission object "implies" the specified permission.
* <P>
* More specifically, this method returns true if:<p>
* More specifically, this method returns true if:
* <ul>
* <li> <i>p</i> is an instanceof ExecPermission,<p> and
* <li> <i>p</i> is an instanceof ExecPermission, and
* <li> <i>p</i>'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 @@ public final class ExecPermission extends Permission
* Checks two ExecPermission objects for equality.
* Checks that <i>obj</i>'s class is the same as this object's class
* and has the same name as this object.
* <P>
*
* @param obj the object we are testing for equality with this object.
* @return true if <i>obj</i> is an ExecPermission, and has the same
* pathname as this ExecPermission object, false otherwise.

2
jdk/src/java.rmi/share/classes/sun/rmi/log/LogInputStream.java
View File

@ -35,7 +35,7 @@ class LogInputStream extends InputStream {
/**
* 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.
*/

2
jdk/src/java.rmi/share/classes/sun/rmi/log/LogOutputStream.java
View File

@ -35,7 +35,7 @@ class LogOutputStream extends OutputStream {
/**
* 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 {

6
jdk/src/java.rmi/share/classes/sun/rmi/log/ReliableLog.java
View File

@ -124,7 +124,7 @@ public class ReliableLog {
* 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 @@ public class ReliableLog {
* 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
*/

4
jdk/src/java.rmi/share/classes/sun/rmi/registry/RegistryImpl.java
View File

@ -155,7 +155,7 @@ public class RegistryImpl extends java.rmi.server.RemoteServer
/**
* 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 @@ public class RegistryImpl extends java.rmi.server.RemoteServer
/**
* 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

2
jdk/src/java.rmi/share/classes/sun/rmi/runtime/Log.java
View File

@ -96,7 +96,7 @@ public abstract class Log {
* 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.
*

4
jdk/src/java.rmi/share/classes/sun/rmi/server/ActivationGroupImpl.java
View File

@ -345,7 +345,7 @@ public class ActivationGroupImpl extends ActivationGroup {
* 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 @@ public class ActivationGroupImpl extends ActivationGroup {
* 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
*/

2
jdk/src/java.rmi/share/classes/sun/rmi/server/ActivationGroupInit.java
View File

@ -36,7 +36,7 @@ import java.rmi.activation.ActivationGroup;
* 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: <p>
* information to the bootstrap code via its stdin:
* <ul>
* <li> the activation group's id,
* <li> the activation group's descriptor (an instance of the class

2
jdk/src/java.rmi/share/classes/sun/rmi/transport/Channel.java
View File

@ -42,7 +42,7 @@ public interface Channel {
/**
* 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.
*/

2
jdk/src/java.rmi/share/classes/sun/rmi/transport/LiveRef.java
View File

@ -56,7 +56,7 @@ public class LiveRef implements Cloneable {
/**
* 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.
*/

Some files were not shown because too many files have changed in this diff Show More