# HG changeset patch # User yan # Date 1398855744 -14400 # Node ID 61c9885d76e2b57b4fb1f4658be1d1f72f22db6d # Parent 705325a63a58a595e016a2641b1aa92c29d7f2ea 8029451: Tidy warnings cleanup for java.util package; minor changes in java.nio, java.sql Reviewed-by: lancea Contributed-by: Alexander Stepanov diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/nio/package.html --- a/jdk/src/share/classes/java/nio/package.html Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/nio/package.html Wed Apr 30 15:02:24 2014 +0400 @@ -121,7 +121,7 @@ available.

  • A byte buffer provides access to its content as either a heterogeneous - or homogeneous sequence of binary data + or homogeneous sequence of binary data of any non-boolean primitive type, in either big-endian or little-endian byte order.

    • diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/sql/package.html --- a/jdk/src/share/classes/java/sql/package.html Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/sql/package.html Wed Apr 30 15:02:24 2014 +0400 @@ -323,10 +323,10 @@ diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/ArrayList.java --- a/jdk/src/share/classes/java/util/ArrayList.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/ArrayList.java Wed Apr 30 15:02:24 2014 +0400 @@ -70,9 +70,9 @@ * unsynchronized access to the list:
      *   List list = Collections.synchronizedList(new ArrayList(...));
    * - *

    + *

    * The iterators returned by this class's {@link #iterator() iterator} and - * {@link #listIterator(int) listIterator} methods are fail-fast: + * {@link #listIterator(int) listIterator} methods are fail-fast: * if the list is structurally modified at any time after the iterator is * created, in any way except through the iterator's own * {@link ListIterator#remove() remove} or diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/Arrays.java --- a/jdk/src/share/classes/java/util/Arrays.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/Arrays.java Wed Apr 30 15:02:24 2014 +0400 @@ -2561,7 +2561,7 @@ * arrays contain the same number of elements, and all corresponding pairs * of elements in the two arrays are equal. In other words, two arrays * are equal if they contain the same elements in the same order. Also, - * two array references are considered equal if both are null.

    + * two array references are considered equal if both are null. * * @param a one array to be tested for equality * @param a2 the other array to be tested for equality @@ -2590,7 +2590,7 @@ * arrays contain the same number of elements, and all corresponding pairs * of elements in the two arrays are equal. In other words, two arrays * are equal if they contain the same elements in the same order. Also, - * two array references are considered equal if both are null.

    + * two array references are considered equal if both are null. * * @param a one array to be tested for equality * @param a2 the other array to be tested for equality @@ -2619,7 +2619,7 @@ * arrays contain the same number of elements, and all corresponding pairs * of elements in the two arrays are equal. In other words, two arrays * are equal if they contain the same elements in the same order. Also, - * two array references are considered equal if both are null.

    + * two array references are considered equal if both are null. * * @param a one array to be tested for equality * @param a2 the other array to be tested for equality @@ -2648,7 +2648,7 @@ * arrays contain the same number of elements, and all corresponding pairs * of elements in the two arrays are equal. In other words, two arrays * are equal if they contain the same elements in the same order. Also, - * two array references are considered equal if both are null.

    + * two array references are considered equal if both are null. * * @param a one array to be tested for equality * @param a2 the other array to be tested for equality @@ -2677,7 +2677,7 @@ * arrays contain the same number of elements, and all corresponding pairs * of elements in the two arrays are equal. In other words, two arrays * are equal if they contain the same elements in the same order. Also, - * two array references are considered equal if both are null.

    + * two array references are considered equal if both are null. * * @param a one array to be tested for equality * @param a2 the other array to be tested for equality @@ -2706,7 +2706,7 @@ * arrays contain the same number of elements, and all corresponding pairs * of elements in the two arrays are equal. In other words, two arrays * are equal if they contain the same elements in the same order. Also, - * two array references are considered equal if both are null.

    + * two array references are considered equal if both are null. * * @param a one array to be tested for equality * @param a2 the other array to be tested for equality @@ -2735,7 +2735,7 @@ * arrays contain the same number of elements, and all corresponding pairs * of elements in the two arrays are equal. In other words, two arrays * are equal if they contain the same elements in the same order. Also, - * two array references are considered equal if both are null.

    + * two array references are considered equal if both are null. * * Two doubles d1 and d2 are considered equal if: * 

        new Double(d1).equals(new Double(d2))
    @@ -2770,7 +2770,7 @@ * arrays contain the same number of elements, and all corresponding pairs * of elements in the two arrays are equal. In other words, two arrays * are equal if they contain the same elements in the same order. Also, - * two array references are considered equal if both are null.

    + * two array references are considered equal if both are null. * * Two floats f1 and f2 are considered equal if: * 

        new Float(f1).equals(new Float(f2))
    @@ -2807,7 +2807,7 @@ * and e2 are considered equal if (e1==null ? e2==null * : e1.equals(e2)). In other words, the two arrays are equal if * they contain the same elements in the same order. Also, two array - * references are considered equal if both are null.

    + * references are considered equal if both are null. * * @param a one array to be tested for equality * @param a2 the other array to be tested for equality diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/Locale.java --- a/jdk/src/share/classes/java/util/Locale.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/Locale.java Wed Apr 30 15:02:24 2014 +0400 @@ -951,7 +951,6 @@ * functionality, this method should only be used if the caller is * prepared to reinitialize locale-sensitive code running within the * same Java Virtual Machine. - *

    * * @param category - the specified category to set the default locale * @param newLocale - the new default locale diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/Properties.java --- a/jdk/src/share/classes/java/util/Properties.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/Properties.java Wed Apr 30 15:02:24 2014 +0400 @@ -754,7 +754,6 @@ *

    * After the entries have been written, the output stream is flushed. * The output stream remains open after this method returns. - *

    * * @param writer an output character stream writer. * @param comments a description of the property list. @@ -802,7 +801,7 @@ *

    * After the entries have been written, the output stream is flushed. * The output stream remains open after this method returns. - *

    + * * @param out an output stream. * @param comments a description of the property list. * @exception IOException if writing this property list to the specified diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/PropertyPermission.java --- a/jdk/src/share/classes/java/util/PropertyPermission.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/PropertyPermission.java Wed Apr 30 15:02:24 2014 +0400 @@ -193,7 +193,7 @@ /** * Checks two PropertyPermission objects for equality. Checks that obj is * a PropertyPermission, and has the same name and actions as this object. - *

    + * * @param obj the object we are testing for equality with this object. * @return true if obj is a PropertyPermission, and has the same name and * actions as this PropertyPermission object. @@ -369,7 +369,6 @@ /** * Returns a new PermissionCollection object for storing * PropertyPermission objects. - *

    * * @return a new PermissionCollection object suitable for storing * PropertyPermissions. diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/Vector.java --- a/jdk/src/share/classes/java/util/Vector.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/Vector.java Wed Apr 30 15:02:24 2014 +0400 @@ -45,9 +45,9 @@ * capacity of a vector before inserting a large number of * components; this reduces the amount of incremental reallocation. * - *

    + *

    * The iterators returned by this class's {@link #iterator() iterator} and - * {@link #listIterator(int) listIterator} methods are fail-fast: + * {@link #listIterator(int) listIterator} methods are fail-fast: * if the vector is structurally modified at any time after the iterator is * created, in any way except through the iterator's own * {@link ListIterator#remove() remove} or diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/concurrent/locks/ReentrantReadWriteLock.java --- a/jdk/src/share/classes/java/util/concurrent/locks/ReentrantReadWriteLock.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/concurrent/locks/ReentrantReadWriteLock.java Wed Apr 30 15:02:24 2014 +0400 @@ -80,7 +80,6 @@ * {@link ReadLock#tryLock()} and {@link WriteLock#tryLock()} methods * do not honor this fair setting and will immediately acquire the lock * if it is possible, regardless of waiting threads.) - *

    * * *

  • Reentrancy diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/jar/Pack200.java --- a/jdk/src/share/classes/java/util/jar/Pack200.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/jar/Pack200.java Wed Apr 30 15:02:24 2014 +0400 @@ -224,7 +224,7 @@ * Note: Unless otherwise noted, passing a null argument to a * constructor or method in this class will cause a {@link NullPointerException} * to be thrown. - *

    + * * @since 1.5 */ public interface Packer { diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/jar/package.html --- a/jdk/src/share/classes/java/util/jar/package.html Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/jar/package.html Wed Apr 30 15:02:24 2014 +0400 @@ -43,8 +43,7 @@ file format. See java.util.zip package description.

    - In JAR files, all file names must be encoded in the UTF-8 encoding. -

    + In JAR files, all file names must be encoded in the UTF-8 encoding.

  • Manifest and Signature Specification - The manifest format specification. diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/ConsoleHandler.java --- a/jdk/src/share/classes/java/util/logging/ConsoleHandler.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/ConsoleHandler.java Wed Apr 30 15:02:24 2014 +0400 @@ -62,7 +62,7 @@ *
  • com.foo.MyHandler.level=INFO
    • *
  • com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter
    • * - *

    + * * @since 1.4 */ public class ConsoleHandler extends StreamHandler { @@ -86,7 +86,7 @@ *

    * The logging request was made initially to a Logger object, * which initialized the LogRecord and forwarded it here. - *

    + * * @param record description of the log event. A null record is * silently ignored and is not published */ diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/FileHandler.java --- a/jdk/src/share/classes/java/util/logging/FileHandler.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/FileHandler.java Wed Apr 30 15:02:24 2014 +0400 @@ -243,7 +243,7 @@ /** * Construct a default FileHandler. This will be configured * entirely from LogManager properties (or their default values). - *

    + * * @exception IOException if there are IO problems opening the files. * @exception SecurityException if a security manager exists and if * the caller does not have LoggingPermission("control")). diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/Formatter.java --- a/jdk/src/share/classes/java/util/logging/Formatter.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/Formatter.java Wed Apr 30 15:02:24 2014 +0400 @@ -105,7 +105,6 @@ * java.text.MessageFormat is used to format the string. *

  • Otherwise no formatting is performed. * - *

    * * @param record the log record containing the raw message * @return a localized and formatted message diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/Handler.java --- a/jdk/src/share/classes/java/util/logging/Handler.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/Handler.java Wed Apr 30 15:02:24 2014 +0400 @@ -158,7 +158,7 @@ *

    * Some Handlers may not use Formatters, in * which case the Formatter will be remembered, but not used. - *

    + * * @param newFormatter the Formatter to use (may not be null) * @exception SecurityException if a security manager exists and if * the caller does not have LoggingPermission("control"). @@ -329,7 +329,7 @@ * may make other Handler specific checks that might prevent a * handler from logging the LogRecord. It will return false if * the LogRecord is null. - *

    + * * @param record a LogRecord * @return true if the LogRecord would be logged. * diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/Level.java --- a/jdk/src/share/classes/java/util/logging/Level.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/Level.java Wed Apr 30 15:02:24 2014 +0400 @@ -195,7 +195,7 @@ /** * Create a named Level with a given integer value and a * given localization resource name. - *

    + * * @param name the name of the Level, for example "SEVERE". * @param value an integer value for the level. * @param resourceBundleName name of a resource bundle to use in diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/LogManager.java --- a/jdk/src/share/classes/java/util/logging/LogManager.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/LogManager.java Wed Apr 30 15:02:24 2014 +0400 @@ -1130,7 +1130,7 @@ * is no strong reference to the Logger. The caller of this method * must check the return value for null in order to properly handle * the case where the Logger has been garbage collected. - *

    + * * @param name name of the logger * @return matching logger or null if none is found */ @@ -1151,7 +1151,7 @@ * return value from {@code LogManager.getLogger()} for null to properly * handle the case where the Logger has been garbage collected in the * time since its name was returned by this method. - *

    + * * @return enumeration of logger name strings */ public Enumeration getLoggerNames() { diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/Logger.java --- a/jdk/src/share/classes/java/util/logging/Logger.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/Logger.java Wed Apr 30 15:02:24 2014 +0400 @@ -338,7 +338,7 @@ * suitable per-Logger granularity. Developers also need to keep a * strong reference to their Logger objects to prevent them from * being garbage collected. - *

    + * * @deprecated Initialization of this field is prone to deadlocks. * The field must be initialized by the Logger class initialization * which may cause deadlocks with the LogManager class initialization. @@ -526,7 +526,7 @@ * name is used. If the named Logger already exists and has * a different resource bundle name then an IllegalArgumentException * is thrown. - *

    + * * @param name A name for the logger. This should * be a dot-separated name and should normally * be based on the package name or class name @@ -595,7 +595,6 @@ * from the root logger. Changing its parent via the * {@link #setParent(java.util.logging.Logger) setParent} method * will still require the security permission specified by that method. - *

    * * @return a newly created private Logger */ @@ -621,7 +620,7 @@ * from the root logger. Changing its parent via the * {@link #setParent(java.util.logging.Logger) setParent} method * will still require the security permission specified by that method. - *

    + * * @param resourceBundleName name of ResourceBundle to be used for localizing * messages for this logger. * May be null if none of the messages require localization. @@ -776,7 +775,7 @@ * If the logger is currently enabled for the given message * level then the given message is forwarded to all the * registered output Handler objects. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param msg The string message (or a key in the message catalog) */ @@ -796,7 +795,7 @@ * level then the message is constructed by invoking the provided * supplier function and forwarded to all the registered output * Handler objects. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param msgSupplier A function, which when called, produces the * desired log message @@ -815,7 +814,7 @@ * If the logger is currently enabled for the given message * level then a corresponding LogRecord is created and forwarded * to all the registered output Handler objects. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param msg The string message (or a key in the message catalog) * @param param1 parameter to the message @@ -836,7 +835,7 @@ * If the logger is currently enabled for the given message * level then a corresponding LogRecord is created and forwarded * to all the registered output Handler objects. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param msg The string message (or a key in the message catalog) * @param params array of parameters to the message @@ -861,7 +860,7 @@ * property, rather than the LogRecord parameters property. Thus it is * processed specially by output Formatters and is not treated * as a formatting parameter to the LogRecord message property. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param msg The string message (or a key in the message catalog) * @param thrown Throwable associated with log message. @@ -887,7 +886,7 @@ * property, rather than the LogRecord parameters property. Thus it is * processed specially by output Formatters and is not treated * as a formatting parameter to the LogRecord message property. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param thrown Throwable associated with log message. * @param msgSupplier A function, which when called, produces the @@ -914,7 +913,7 @@ * If the logger is currently enabled for the given message * level then the given message is forwarded to all the * registered output Handler objects. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -938,7 +937,7 @@ * level then the message is constructed by invoking the provided * supplier function and forwarded to all the registered output * Handler objects. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -964,7 +963,7 @@ * If the logger is currently enabled for the given message * level then a corresponding LogRecord is created and forwarded * to all the registered output Handler objects. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -991,7 +990,7 @@ * If the logger is currently enabled for the given message * level then a corresponding LogRecord is created and forwarded * to all the registered output Handler objects. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -1022,7 +1021,7 @@ * property, rather than the LogRecord parameters property. Thus it is * processed specially by output Formatters and is not treated * as a formatting parameter to the LogRecord message property. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -1054,7 +1053,7 @@ * property, rather than the LogRecord parameters property. Thus it is * processed specially by output Formatters and is not treated * as a formatting parameter to the LogRecord message property. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -1113,7 +1112,7 @@ * The msg string is localized using the named resource bundle. If the * resource bundle name is null, or an empty String or invalid * then the msg string is not localized. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -1147,7 +1146,7 @@ * The msg string is localized using the named resource bundle. If the * resource bundle name is null, or an empty String or invalid * then the msg string is not localized. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -1184,7 +1183,7 @@ * The msg string is localized using the named resource bundle. If the * resource bundle name is null, or an empty String or invalid * then the msg string is not localized. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -1220,7 +1219,7 @@ * The {@code msg} string is localized using the given resource bundle. * If the resource bundle is {@code null}, then the {@code msg} string is not * localized. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass Name of the class that issued the logging request * @param sourceMethod Name of the method that issued the logging request @@ -1260,7 +1259,7 @@ * property, rather than the LogRecord parameters property. Thus it is * processed specially by output Formatters and is not treated * as a formatting parameter to the LogRecord message property. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that issued the logging request @@ -1301,7 +1300,7 @@ * property, rather than the LogRecord parameters property. Thus it is * processed specially by output Formatters and is not treated * as a formatting parameter to the LogRecord message property. - *

    + * * @param level One of the message level identifiers, e.g., SEVERE * @param sourceClass Name of the class that issued the logging request * @param sourceMethod Name of the method that issued the logging request @@ -1333,7 +1332,7 @@ * This is a convenience method that can be used to log entry * to a method. A LogRecord with message "ENTRY", log level * FINER, and the given sourceMethod and sourceClass is logged. - *

    + * * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that is being entered */ @@ -1348,7 +1347,7 @@ * to a method. A LogRecord with message "ENTRY {0}", log level * FINER, and the given sourceMethod, sourceClass, and parameter * is logged. - *

    + * * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that is being entered * @param param1 parameter to the method being entered @@ -1365,7 +1364,7 @@ * format {N} indicator for each entry in the parameter array), * log level FINER, and the given sourceMethod, sourceClass, and * parameters is logged. - *

    + * * @param sourceClass name of class that issued the logging request * @param sourceMethod name of method that is being entered * @param params array of parameters to the method being entered @@ -1389,7 +1388,7 @@ * This is a convenience method that can be used to log returning * from a method. A LogRecord with message "RETURN", log level * FINER, and the given sourceMethod and sourceClass is logged. - *

    + * * @param sourceClass name of class that issued the logging request * @param sourceMethod name of the method */ @@ -1405,7 +1404,7 @@ * from a method. A LogRecord with message "RETURN {0}", log level * FINER, and the gives sourceMethod, sourceClass, and result * object is logged. - *

    + * * @param sourceClass name of class that issued the logging request * @param sourceMethod name of the method * @param result Object that is being returned @@ -1430,7 +1429,7 @@ * property, rather than the LogRecord parameters property. Thus it is * processed specially by output Formatters and is not treated * as a formatting parameter to the LogRecord message property. - *

    + * * @param sourceClass name of class that issued the logging request * @param sourceMethod name of the method. * @param thrown The Throwable that is being thrown. @@ -1456,7 +1455,7 @@ * If the logger is currently enabled for the SEVERE message * level then the given message is forwarded to all the * registered output Handler objects. - *

    + * * @param msg The string message (or a key in the message catalog) */ public void severe(String msg) { @@ -1469,7 +1468,7 @@ * If the logger is currently enabled for the WARNING message * level then the given message is forwarded to all the * registered output Handler objects. - *

    + * * @param msg The string message (or a key in the message catalog) */ public void warning(String msg) { @@ -1482,7 +1481,7 @@ * If the logger is currently enabled for the INFO message * level then the given message is forwarded to all the * registered output Handler objects. - *

    + * * @param msg The string message (or a key in the message catalog) */ public void info(String msg) { @@ -1495,7 +1494,7 @@ * If the logger is currently enabled for the CONFIG message * level then the given message is forwarded to all the * registered output Handler objects. - *

    + * * @param msg The string message (or a key in the message catalog) */ public void config(String msg) { @@ -1508,7 +1507,7 @@ * If the logger is currently enabled for the FINE message * level then the given message is forwarded to all the * registered output Handler objects. - *

    + * * @param msg The string message (or a key in the message catalog) */ public void fine(String msg) { @@ -1521,7 +1520,7 @@ * If the logger is currently enabled for the FINER message * level then the given message is forwarded to all the * registered output Handler objects. - *

    + * * @param msg The string message (or a key in the message catalog) */ public void finer(String msg) { @@ -1534,7 +1533,7 @@ * If the logger is currently enabled for the FINEST message * level then the given message is forwarded to all the * registered output Handler objects. - *

    + * * @param msg The string message (or a key in the message catalog) */ public void finest(String msg) { @@ -1554,7 +1553,7 @@ * level then the message is constructed by invoking the provided * supplier function and forwarded to all the registered output * Handler objects. - *

    + * * @param msgSupplier A function, which when called, produces the * desired log message * @since 1.8 @@ -1571,7 +1570,7 @@ * level then the message is constructed by invoking the provided * supplier function and forwarded to all the registered output * Handler objects. - *

    + * * @param msgSupplier A function, which when called, produces the * desired log message * @since 1.8 @@ -1588,7 +1587,7 @@ * level then the message is constructed by invoking the provided * supplier function and forwarded to all the registered output * Handler objects. - *

    + * * @param msgSupplier A function, which when called, produces the * desired log message * @since 1.8 @@ -1605,7 +1604,7 @@ * level then the message is constructed by invoking the provided * supplier function and forwarded to all the registered output * Handler objects. - *

    + * * @param msgSupplier A function, which when called, produces the * desired log message * @since 1.8 @@ -1622,7 +1621,7 @@ * level then the message is constructed by invoking the provided * supplier function and forwarded to all the registered output * Handler objects. - *

    + * * @param msgSupplier A function, which when called, produces the * desired log message * @since 1.8 @@ -1639,7 +1638,7 @@ * level then the message is constructed by invoking the provided * supplier function and forwarded to all the registered output * Handler objects. - *

    + * * @param msgSupplier A function, which when called, produces the * desired log message * @since 1.8 @@ -1656,7 +1655,7 @@ * level then the message is constructed by invoking the provided * supplier function and forwarded to all the registered output * Handler objects. - *

    + * * @param msgSupplier A function, which when called, produces the * desired log message * @since 1.8 @@ -1769,7 +1768,7 @@ /** * Get the Handlers associated with this logger. - *

    + * * @return an array of all registered Handlers */ public Handler[] getHandlers() { @@ -2015,7 +2014,7 @@ * the LogManager to update a Logger when the namespace changes. *

    * It should not be called from application code. - *

    + * * @param parent the new parent logger * @throws SecurityException if a security manager exists and if * the caller does not have LoggingPermission("control"). diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/MemoryHandler.java --- a/jdk/src/share/classes/java/util/logging/MemoryHandler.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/MemoryHandler.java Wed Apr 30 15:02:24 2014 +0400 @@ -82,7 +82,7 @@ *

  • com.foo.MyHandler.level=INFO
    • *
  • com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter
    • * - *

    + * * @since 1.4 */ @@ -267,7 +267,7 @@ * whether it satisfies any Filter. However it does not * check whether the LogRecord would result in a "push" of the * buffer contents. It will return false if the LogRecord is null. - *

    + * * @param record a LogRecord * @return true if the LogRecord would be logged. * diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/StreamHandler.java --- a/jdk/src/share/classes/java/util/logging/StreamHandler.java Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/StreamHandler.java Wed Apr 30 15:02:24 2014 +0400 @@ -71,7 +71,7 @@ *

  • com.foo.MyHandler.level=INFO
    • *
  • com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter
    • * - *

    + * * @since 1.4 */ @@ -91,7 +91,7 @@ /** * Create a StreamHandler with a given Formatter * and output stream. - *

    + * * @param out the target output stream * @param formatter Formatter to be used to format output */ @@ -224,7 +224,7 @@ * This method checks if the LogRecord has an appropriate level and * whether it satisfies any Filter. It will also return false if * no output stream has been assigned yet or the LogRecord is null. - *

    + * * @param record a LogRecord * @return true if the LogRecord would be logged. * diff -r 705325a63a58 -r 61c9885d76e2 jdk/src/share/classes/java/util/logging/package.html --- a/jdk/src/share/classes/java/util/logging/package.html Wed Apr 30 11:28:05 2014 +0200 +++ b/jdk/src/share/classes/java/util/logging/package.html Wed Apr 30 15:02:24 2014 +0400 @@ -54,18 +54,18 @@ When a problem occurs in the field, it may be necessary to return the captured logging information to the original development team for diagnosis. This logging information may be extremely detailed and fairly inscrutable. Such information might include - detailed tracing on the internal execution of particular subsystems. + detailed tracing on the internal execution of particular subsystems.

  • Problem diagnosis by developers. The Logging APIs may also be used to help debug an application under development. This may include logging information generated by the target application - as well as logging information generated by lower-level libraries. + as well as logging information generated by lower-level libraries. Note however that while this use is perfectly reasonable, the logging APIs are not intended to replace the normal debugging and profiling tools that may already exist in the development environment. -

    +

    The key elements of this package include: