OpenJDK / bsd-port / jdk9 / jdk
changeset 9913:35bbba418241
8030709: Tidy warnings cleanup for java.lang package; minor cleanup in java.math, javax.script
Reviewed-by: lancea
Contributed-by: Alexander Stepanov <alexander.v.stepanov@oracle.com>
line wrap: on
line diff
--- a/src/share/classes/java/lang/Character.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/Character.java Mon May 12 14:12:33 2014 +0400 @@ -4498,7 +4498,6 @@ * Character case is ignored for all of the valid script names. * The en_US locale's case mapping rules are used to provide * case-insensitive string comparisons for script name validation. - * <p> * * @param scriptName A {@code UnicodeScript} name. * @return The {@code UnicodeScript} constant identified @@ -5503,7 +5502,7 @@ * '\u00D0' '\u00D1' '\u00D2' '\u00D3' '\u00D4' '\u00D5' '\u00D6' '\u00D8' * '\u00D9' '\u00DA' '\u00DB' '\u00DC' '\u00DD' '\u00DE' * </pre></blockquote> - * <p> Many other Unicode characters are uppercase too.<p> + * <p> Many other Unicode characters are uppercase too. * * @param codePoint the character (Unicode code point) to be tested. * @return {@code true} if the character is uppercase; @@ -5581,7 +5580,7 @@ * <li>{@code LATIN CAPITAL LETTER N WITH SMALL LETTER J} * <li>{@code LATIN CAPITAL LETTER D WITH SMALL LETTER Z} * </ul> - * <p> Many other Unicode characters are titlecase too.<p> + * <p> Many other Unicode characters are titlecase too. * * @param codePoint the character (Unicode code point) to be tested. * @return {@code true} if the character is titlecase; @@ -6777,7 +6776,6 @@ * <li> It is {@code '\u005Cu001E'}, U+001E RECORD SEPARATOR. * <li> It is {@code '\u005Cu001F'}, U+001F UNIT SEPARATOR. * </ul> - * <p> * * @param codePoint the character (Unicode code point) to be tested. * @return {@code true} if the character is a Java whitespace @@ -7121,7 +7119,6 @@ /** * Converts the character (Unicode code point) argument to uppercase using * information from the UnicodeData file. - * <p> * * @param codePoint the character (Unicode code point) to be converted. * @return either the uppercase equivalent of the character, if
--- a/src/share/classes/java/lang/Math.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/Math.java Mon May 12 14:12:33 2014 +0400 @@ -1048,7 +1048,6 @@ * whereas {@code (-4 / 3) == -1}. * </li> * </ul> - * <p> * * @param x the dividend * @param y the divisor
--- a/src/share/classes/java/lang/Runtime.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/Runtime.java Mon May 12 14:12:33 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -83,7 +83,7 @@ * blocks indefinitely. * * <p> The <tt>{@link System#exit(int) System.exit}</tt> method is the - * conventional and convenient means of invoking this method. <p> + * conventional and convenient means of invoking this method. * * @param status * Termination status. By convention, a nonzero status code @@ -180,7 +180,7 @@ * method goes awry by, for example, corrupting internal data structures or * attempting to access nonexistent memory. If the virtual machine aborts * then no guarantee can be made about whether or not any shutdown hooks - * will be run. <p> + * will be run. * * @param hook * An initialized but unstarted <tt>{@link Thread}</tt> object @@ -248,7 +248,7 @@ * hooks to be started and does not run uninvoked finalizers if * finalization-on-exit has been enabled. If the shutdown sequence has * already been initiated then this method does not wait for any running - * shutdown hooks or finalizers to finish their work. <p> + * shutdown hooks or finalizers to finish their work. * * @param status * Termination status. By convention, a nonzero status code
--- a/src/share/classes/java/lang/SecurityManager.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/SecurityManager.java Mon May 12 14:12:33 2014 +0400 @@ -1242,7 +1242,6 @@ * <code>super.checkPropertiesAccess</code> * at the point the overridden method would normally throw an * exception. - * <p> * * @exception SecurityException if the calling thread does not have * permission to access or modify the system properties. @@ -1320,7 +1319,6 @@ * <code>super.checkPrintJobAccess</code> * at the point the overridden method would normally throw an * exception. - * <p> * * @exception SecurityException if the calling thread does not have * permission to initiate a print job request. @@ -1566,7 +1564,6 @@ * <code>super.checkSetFactory</code> * at the point the overridden method would normally throw an * exception. - * <p> * * @exception SecurityException if the calling thread does not have * permission to specify a socket factory or a stream
--- a/src/share/classes/java/lang/String.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/String.java Mon May 12 14:12:33 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -2650,7 +2650,7 @@ * LATIN SMALL LETTER DOTLESS I character. * To obtain correct results for locale insensitive strings, use * {@code toLowerCase(Locale.ROOT)}. - * <p> + * * @return the {@code String}, converted to lowercase. * @see java.lang.String#toLowerCase(Locale) */ @@ -2812,7 +2812,7 @@ * LATIN CAPITAL LETTER I WITH DOT ABOVE character. * To obtain correct results for locale insensitive strings, use * {@code toUpperCase(Locale.ROOT)}. - * <p> + * * @return the {@code String}, converted to uppercase. * @see java.lang.String#toUpperCase(Locale) */
--- a/src/share/classes/java/lang/System.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/System.java Mon May 12 14:12:33 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1994, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -133,7 +133,6 @@ * <p>First, if there is a security manager, its <code>checkPermission</code> * method is called with a <code>RuntimePermission("setIO")</code> permission * to see if it's ok to reassign the "standard" input stream. - * <p> * * @param in the new standard input stream. * @@ -762,7 +761,6 @@ * permission. This may result in a SecurityException being thrown. * If no exception is thrown, the specified property is set to the given * value. - * <p> * * @param key the name of the system property. * @param value the value of the system property. @@ -801,7 +799,6 @@ * is called with a <code>PropertyPermission(key, "write")</code> * permission. This may result in a SecurityException being thrown. * If no exception is thrown, the specified property is removed. - * <p> * * @param key the name of the system property to be removed. * @return the previous string value of the system property,
--- a/src/share/classes/java/lang/instrument/package.html Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/instrument/package.html Mon May 12 14:12:33 2014 +0400 @@ -1,5 +1,5 @@ <!-- - Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. This code is free software; you can redistribute it and/or modify it @@ -140,7 +140,7 @@ <li><p>The system class loader ( {@link java.lang.ClassLoader#getSystemClassLoader ClassLoader.getSystemClassLoader}) must - support a mechanism to add an agent JAR file to the system class path. <p></li> + support a mechanism to add an agent JAR file to the system class path.</li> </ol> <P>
--- a/src/share/classes/java/lang/invoke/MethodHandles.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/invoke/MethodHandles.java Mon May 12 14:12:33 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2008, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2008, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -50,7 +50,7 @@ * <li>Combinator methods, which combine or transform pre-existing method handles into new ones. * <li>Other factory methods to create method handles that emulate other common JVM operations or control flow patterns. * </ul> - * <p> + * * @author John Rose, JSR 292 EG * @since 1.7 */
--- a/src/share/classes/java/lang/management/MemoryNotificationInfo.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/management/MemoryNotificationInfo.java Mon May 12 14:12:33 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -89,7 +89,7 @@ * Subsequent crossing of the usage threshold value does not cause * further notification until the memory usage has returned * to become less than the usage threshold value. - * <p></li> + * </li> * <li>A {@link #MEMORY_COLLECTION_THRESHOLD_EXCEEDED * collection usage threshold exceeded notification}. * <br>This notification will be emitted when
--- a/src/share/classes/java/lang/management/ThreadInfo.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/management/ThreadInfo.java Mon May 12 14:12:33 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -429,12 +429,12 @@ * <br>The thread is in the {@link java.lang.Thread.State#BLOCKED BLOCKED} * state waiting to enter the <tt>synchronized</tt> statement * or method. - * <p></li> + * </li> * <li>an object monitor to be notified by another thread. * <br>The thread is in the {@link java.lang.Thread.State#WAITING WAITING} * or {@link java.lang.Thread.State#TIMED_WAITING TIMED_WAITING} state * due to a call to the {@link Object#wait Object.wait} method. - * <p></li> + * </li> * <li>a synchronization object responsible for the thread parking. * <br>The thread is in the {@link java.lang.Thread.State#WAITING WAITING} * or {@link java.lang.Thread.State#TIMED_WAITING TIMED_WAITING} state
--- a/src/share/classes/java/lang/management/package.html Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/lang/management/package.html Mon May 12 14:12:33 2014 +0400 @@ -1,5 +1,5 @@ <!-- - Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. This code is free software; you can redistribute it and/or modify it @@ -31,7 +31,6 @@ Java virtual machine and other components in the Java runtime. It allows both local and remote monitoring and management of the running Java virtual machine. -<p> <h4><a name="MXBean">Platform MXBean</a></h4> <p> @@ -41,7 +40,6 @@ Each platform MXBean is a {@link java.lang.management.PlatformManagedObject} with a unique {@linkplain java.lang.management.PlatformManagedObject#getObjectName name}. -<p> <h4>ManagementFactory</h4> <p>The {@link java.lang.management.ManagementFactory} class is the management @@ -80,7 +78,6 @@ Java virtual machine and the runtime in the following ways: <p> <b>1. Direct access to an MXBean interface</b> -<p> <ul> <li>Get an MXBean instance locally in the running Java virtual machine: <pre> @@ -100,7 +97,6 @@ // Get the standard attribute "VmVendor" String vendor = mxbean.getVmVendor(); </pre> -<p> </li> <li>Construct an MXBean proxy instance that forwards the method calls to a given MBeanServer: @@ -132,7 +128,7 @@ </li> </ul> <p> -<b>2. Indirect access to an MXBean interface via MBeanServer</b><p> +<b>2. Indirect access to an MXBean interface via MBeanServer</b> <ul> <li>Go through the {@link java.lang.management.ManagementFactory#getPlatformMBeanServer @@ -143,7 +139,7 @@ <em>JMX open types</em> which include basic data types, {@link javax.management.openmbean.CompositeData CompositeData}, and {@link javax.management.openmbean.TabularData TabularData} - defined in {@link javax.management.openmbean.OpenType OpenType}.<p> + defined in {@link javax.management.openmbean.OpenType OpenType}. <pre> MBeanServerConnection mbs;
--- a/src/share/classes/java/math/BigInteger.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/java/math/BigInteger.java Mon May 12 14:12:33 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1996, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -3597,7 +3597,7 @@ * Converts the specified BigInteger to a string and appends to * {@code sb}. This implements the recursive Schoenhage algorithm * for base conversions. - * <p/> + * <p> * See Knuth, Donald, _The Art of Computer Programming_, Vol. 2, * Answers to Exercises (4.4) Question 14. * @@ -3646,7 +3646,7 @@ /** * Returns the value radix^(2^exponent) from the cache. * If this value doesn't already exist in the cache, it is added. - * <p/> + * <p> * This could be changed to a more complicated caching method using * {@code Future}. */
--- a/src/share/classes/javax/script/ScriptEngineFactory.java Fri May 09 15:24:57 2014 +0200 +++ b/src/share/classes/javax/script/ScriptEngineFactory.java Mon May 12 14:12:33 2014 +0400 @@ -160,7 +160,6 @@ * return ret; * } * } </pre> - * <p> * * @param obj The name representing the object whose method is to be invoked. The * name is the one used to create bindings using the <code>put</code> method of