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>
--- a/jdk/src/share/classes/java/lang/Character.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/Math.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/Runtime.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/SecurityManager.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/String.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/System.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/instrument/package.html Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/invoke/MethodHandles.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/management/MemoryNotificationInfo.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/management/ThreadInfo.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/lang/management/package.html Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/java/math/BigInteger.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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/jdk/src/share/classes/javax/script/ScriptEngineFactory.java Fri May 09 15:24:57 2014 +0200
+++ b/jdk/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