8190382: fix small typographic errors in comments
Reviewed-by: martin
Contributed-by: christoph.dreis@freenet.de
--- a/src/java.base/share/classes/java/io/FilePermission.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/io/FilePermission.java Mon Oct 30 17:49:33 2017 -0700
@@ -698,7 +698,7 @@
if (p2.equals(EMPTY_PATH)) {
return 0;
} else if (p2.getName(0).equals(DOTDOT_PATH)) {
- // "." contains p2 iif p2 has no "..". Since a
+ // "." contains p2 iff p2 has no "..". Since
// a normalized path can only have 0 or more
// ".." at the beginning. We only need to look
// at the head.
@@ -711,7 +711,7 @@
} else if (p2.equals(EMPTY_PATH)) {
int c1 = p1.getNameCount();
if (!p1.getName(c1 - 1).equals(DOTDOT_PATH)) {
- // "." is inside p1 iif p1 is 1 or more "..".
+ // "." is inside p1 iff p1 is 1 or more "..".
// For the same reason above, we only need to
// look at the tail.
return -1;
--- a/src/java.base/share/classes/java/lang/invoke/MethodHandle.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/lang/invoke/MethodHandle.java Mon Oct 30 17:49:33 2017 -0700
@@ -765,7 +765,7 @@
* In every other case, all conversions are applied <em>pairwise</em>,
* which means that each argument or return value is converted to
* exactly one argument or return value (or no return value).
- * The applied conversions are defined by consulting the
+ * The applied conversions are defined by consulting
* the corresponding component types of the old and new
* method handle types.
* <p>
--- a/src/java.base/share/classes/java/lang/invoke/StringConcatFactory.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/lang/invoke/StringConcatFactory.java Mon Oct 30 17:49:33 2017 -0700
@@ -194,7 +194,7 @@
static {
// In case we need to double-back onto the StringConcatFactory during this
// static initialization, make sure we have the reasonable defaults to complete
- // the static initialization properly. After that, actual users would use the
+ // the static initialization properly. After that, actual users would use
// the proper values we have read from the properties.
STRATEGY = DEFAULT_STRATEGY;
// CACHE_ENABLE = false; // implied
--- a/src/java.base/share/classes/java/lang/invoke/VarHandle.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/lang/invoke/VarHandle.java Mon Oct 30 17:49:33 2017 -0700
@@ -205,7 +205,7 @@
* and {@code double} on 32-bit platforms.
*
* <p>Access modes will override any memory ordering effects specified at
- * the declaration site of a variable. For example, a VarHandle accessing a
+ * the declaration site of a variable. For example, a VarHandle accessing
* a field using the {@code get} access mode will access the field as
* specified <em>by its access mode</em> even if that field is declared
* {@code volatile}. When mixed access is performed extreme care should be
@@ -423,7 +423,7 @@
* {@link java.lang.invoke.MethodHandles#varHandleInvoker}.
*
* <h1>Interoperation between VarHandles and Java generics</h1>
- * A VarHandle can be obtained for a variable, such as a a field, which is
+ * A VarHandle can be obtained for a variable, such as a field, which is
* declared with Java generic types. As with the Core Reflection API, the
* VarHandle's variable type will be constructed from the erasure of the
* source-level type. When a VarHandle access mode method is invoked, the
--- a/src/java.base/share/classes/java/net/DatagramSocket.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/net/DatagramSocket.java Mon Oct 30 17:49:33 2017 -0700
@@ -988,7 +988,7 @@
/**
* Sets the SO_RCVBUF option to the specified value for this
- * {@code DatagramSocket}. The SO_RCVBUF option is used by the
+ * {@code DatagramSocket}. The SO_RCVBUF option is used by
* the network implementation as a hint to size the underlying
* network I/O buffers. The SO_RCVBUF setting may also be used
* by the network implementation to determine the maximum size
--- a/src/java.base/share/classes/java/net/Inet4Address.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/net/Inet4Address.java Mon Oct 30 17:49:33 2017 -0700
@@ -143,7 +143,7 @@
/**
* Prior to 1.4 an InetAddress was created with a family
* based on the platform AF_INET value (usually 2).
- * For compatibility reasons we must therefore write the
+ * For compatibility reasons we must therefore write
* the InetAddress with this family.
*/
inet.holder().family = 2;
--- a/src/java.base/share/classes/java/net/SocketImpl.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/net/SocketImpl.java Mon Oct 30 17:49:33 2017 -0700
@@ -333,7 +333,7 @@
* latency, and low latency above short connection time, then it could
* invoke this method with the values {@code (0, 1, 2)}.
*
- * By default, this method does nothing, unless it is overridden in a
+ * By default, this method does nothing, unless it is overridden in
* a sub-class.
*
* @param connectionTime
--- a/src/java.base/share/classes/java/net/SocksSocketImpl.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/net/SocksSocketImpl.java Mon Oct 30 17:49:33 2017 -0700
@@ -657,7 +657,7 @@
/**
* Sends the Bind request to the SOCKS proxy. In the SOCKS protocol, bind
- * means "accept incoming connection from", so the SocketAddress is the
+ * means "accept incoming connection from", so the SocketAddress is
* the one of the host we do accept connection from.
*
* @param saddr the Socket address of the remote host.
--- a/src/java.base/share/classes/java/net/URLConnection.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/net/URLConnection.java Mon Oct 30 17:49:33 2017 -0700
@@ -785,7 +785,7 @@
* required to make the connection. By default, this method
* returns {@code java.security.AllPermission}. Subclasses
* should override this method and return the permission
- * that best represents the permission required to make a
+ * that best represents the permission required to make
* a connection to the URL. For example, a {@code URLConnection}
* representing a {@code file:} URL would return a
* {@code java.io.FilePermission} object.
--- a/src/java.base/share/classes/java/nio/channels/AsynchronousFileChannel.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/nio/channels/AsynchronousFileChannel.java Mon Oct 30 17:49:33 2017 -0700
@@ -165,7 +165,7 @@
* <tr>
* <th scope="row" > {@link StandardOpenOption#DELETE_ON_CLOSE DELETE_ON_CLOSE} </th>
* <td> When this option is present then the implementation makes a
- * <em>best effort</em> attempt to delete the file when closed by the
+ * <em>best effort</em> attempt to delete the file when closed by
* the {@link #close close} method. If the {@code close} method is not
* invoked then a <em>best effort</em> attempt is made to delete the file
* when the Java virtual machine terminates. </td>
--- a/src/java.base/share/classes/java/nio/channels/FileChannel.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/nio/channels/FileChannel.java Mon Oct 30 17:49:33 2017 -0700
@@ -216,7 +216,7 @@
* <tr>
* <th scope="row" > {@link StandardOpenOption#DELETE_ON_CLOSE DELETE_ON_CLOSE} </th>
* <td> When this option is present then the implementation makes a
- * <em>best effort</em> attempt to delete the file when closed by the
+ * <em>best effort</em> attempt to delete the file when closed by
* the {@link #close close} method. If the {@code close} method is not
* invoked then a <em>best effort</em> attempt is made to delete the file
* when the Java virtual machine terminates. </td>
--- a/src/java.base/share/classes/java/nio/file/Files.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/nio/file/Files.java Mon Oct 30 17:49:33 2017 -0700
@@ -3301,7 +3301,7 @@
}
/**
- * Writes bytes to a file. The {@code options} parameter specifies how the
+ * Writes bytes to a file. The {@code options} parameter specifies how
* the file is created or opened. If no options are present then this method
* works as if the {@link StandardOpenOption#CREATE CREATE}, {@link
* StandardOpenOption#TRUNCATE_EXISTING TRUNCATE_EXISTING}, and {@link
--- a/src/java.base/share/classes/java/security/KeyPairGenerator.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/security/KeyPairGenerator.java Mon Oct 30 17:49:33 2017 -0700
@@ -84,7 +84,7 @@
* exists (e.g., so-called <i>community parameters</i> in DSA), there are two
* {@link #initialize(java.security.spec.AlgorithmParameterSpec)
* initialize} methods that have an {@code AlgorithmParameterSpec}
- * argument. One also has a {@code SecureRandom} argument, while the
+ * argument. One also has a {@code SecureRandom} argument, while
* the other uses the {@code SecureRandom}
* implementation of the highest-priority installed provider as the source
* of randomness. (If none of the installed providers supply an implementation
--- a/src/java.base/share/classes/java/time/format/DateTimeFormatterBuilder.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/time/format/DateTimeFormatterBuilder.java Mon Oct 30 17:49:33 2017 -0700
@@ -4775,7 +4775,7 @@
//-----------------------------------------------------------------------
/**
* Prints or parses a localized pattern from a localized field.
- * The specific formatter and parameters is not selected until the
+ * The specific formatter and parameters is not selected until
* the field is to be printed or parsed.
* The locale is needed to select the proper WeekFields from which
* the field for day-of-week, week-of-month, or week-of-year is selected.
--- a/src/java.base/share/classes/java/time/temporal/WeekFields.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/time/temporal/WeekFields.java Mon Oct 30 17:49:33 2017 -0700
@@ -311,7 +311,7 @@
* the new month or year.
* <p>
* WeekFields instances are singletons; for each unique combination
- * of {@code firstDayOfWeek} and {@code minimalDaysInFirstWeek} the
+ * of {@code firstDayOfWeek} and {@code minimalDaysInFirstWeek}
* the same instance will be returned.
*
* @param firstDayOfWeek the first day of the week, not null
--- a/src/java.base/share/classes/java/util/Base64.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/util/Base64.java Mon Oct 30 17:49:33 2017 -0700
@@ -56,7 +56,7 @@
* base64 alphabet.</p></li>
*
* <li><a id="mime"><b>MIME</b></a>
- * <p> Uses the "The Base64 Alphabet" as specified in Table 1 of
+ * <p> Uses "The Base64 Alphabet" as specified in Table 1 of
* RFC 2045 for encoding and decoding operation. The encoded output
* must be represented in lines of no more than 76 characters each
* and uses a carriage return {@code '\r'} followed immediately by
--- a/src/java.base/share/classes/java/util/EventObject.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/util/EventObject.java Mon Oct 30 17:49:33 2017 -0700
@@ -43,13 +43,13 @@
/**
* The object on which the Event initially occurred.
*/
- protected transient Object source;
+ protected transient Object source;
/**
* Constructs a prototypical Event.
*
- * @param source The object on which the Event initially occurred.
- * @exception IllegalArgumentException if source is null.
+ * @param source the object on which the Event initially occurred
+ * @throws IllegalArgumentException if source is null
*/
public EventObject(Object source) {
if (source == null)
@@ -61,7 +61,7 @@
/**
* The object on which the Event initially occurred.
*
- * @return The object on which the Event initially occurred.
+ * @return the object on which the Event initially occurred
*/
public Object getSource() {
return source;
@@ -70,7 +70,7 @@
/**
* Returns a String representation of this EventObject.
*
- * @return A a String representation of this EventObject.
+ * @return a String representation of this EventObject
*/
public String toString() {
return getClass().getName() + "[source=" + source + "]";
--- a/src/java.base/share/classes/java/util/FormattableFlags.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/util/FormattableFlags.java Mon Oct 30 17:49:33 2017 -0700
@@ -26,7 +26,7 @@
package java.util;
/**
- * FomattableFlags are passed to the {@link Formattable#formatTo
+ * FormattableFlags are passed to the {@link Formattable#formatTo
* Formattable.formatTo()} method and modify the output format for {@linkplain
* Formattable Formattables}. Implementations of {@link Formattable} are
* responsible for interpreting and validating any flags.
--- a/src/java.base/share/classes/java/util/ResourceBundle.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/java/util/ResourceBundle.java Mon Oct 30 17:49:33 2017 -0700
@@ -2743,7 +2743,7 @@
* of multiple subtags separated by underscore, generate candidate
* <code>Locale</code>s by omitting the variant subtags one by one, then
* insert them after every occurrence of <code> Locale</code>s with the
- * full variant value in the original list. For example, if the
+ * full variant value in the original list. For example, if
* the variant consists of two subtags <em>V1</em> and <em>V2</em>:
*
* <ul>
--- a/src/java.base/share/classes/jdk/internal/logger/BootstrapLogger.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/jdk/internal/logger/BootstrapLogger.java Mon Oct 30 17:49:33 2017 -0700
@@ -238,7 +238,7 @@
// This way we could simply do things like:
// push((logger) -> logger.log(level, msg));
// Unfortunately, if we come to here it means we are in the bootsraping
- // phase where using lambdas is not safe yet - so we have to use a
+ // phase where using lambdas is not safe yet - so we have to use
// a data object instead...
//
static final class LogEvent {
--- a/src/java.base/share/classes/sun/net/www/protocol/http/HttpURLConnection.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/sun/net/www/protocol/http/HttpURLConnection.java Mon Oct 30 17:49:33 2017 -0700
@@ -2888,7 +2888,7 @@
/*
* If we have an input stream this means we received a response
* from the server. That stream may have been read to EOF and
- * dependening on the stream type may already be closed or the
+ * depending on the stream type may already be closed or
* the http client may be returned to the keep-alive cache.
* If the http client has been returned to the keep-alive cache
* it may be closed (idle timeout) or may be allocated to
--- a/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/ParameterizedTypeImpl.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/ParameterizedTypeImpl.java Mon Oct 30 17:49:33 2017 -0700
@@ -66,7 +66,7 @@
/**
* Static factory. Given a (generic) class, actual type arguments
* and an owner type, creates a parameterized type.
- * This class can be instantiated with a a raw type that does not
+ * This class can be instantiated with a raw type that does not
* represent a generic type, provided the list of actual type
* arguments is empty.
* If the ownerType argument is null, the declaring class of the
--- a/src/java.base/share/classes/sun/security/provider/AuthPolicyFile.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/sun/security/provider/AuthPolicyFile.java Mon Oct 30 17:49:33 2017 -0700
@@ -411,7 +411,7 @@
certs = null;
}
- // only add if we had no signer or we had a
+ // only add if we had no signer or we had
// a signer and found the keys for it.
if (certs != null || pe.signedBy == null) {
Permission perm = new UnresolvedPermission(
--- a/src/java.base/share/classes/sun/security/provider/PolicyFile.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/sun/security/provider/PolicyFile.java Mon Oct 30 17:49:33 2017 -0700
@@ -789,7 +789,7 @@
certs = null;
}
- // only add if we had no signer or we had a
+ // only add if we had no signer or we had
// a signer and found the keys for it.
if (certs != null || pe.signedBy == null) {
Permission perm = new UnresolvedPermission(
--- a/src/java.base/share/classes/sun/security/provider/SubjectCodeSource.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/sun/security/provider/SubjectCodeSource.java Mon Oct 30 17:49:33 2017 -0700
@@ -154,7 +154,7 @@
*
* @param codesource the <code>CodeSource</code> to compare against.
*
- * @return true if this <code>SubjectCodeSource</code> implies the
+ * @return true if this <code>SubjectCodeSource</code> implies
* the specified <code>CodeSource</code>.
*/
public boolean implies(CodeSource codesource) {
--- a/src/java.base/share/classes/sun/security/ssl/DTLSInputRecord.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/sun/security/ssl/DTLSInputRecord.java Mon Oct 30 17:49:33 2017 -0700
@@ -539,7 +539,7 @@
// Should be repacked for suitable fragment length.
//
- // Note that the acquiring processes will reassemble the
+ // Note that the acquiring processes will reassemble
// the fragments later.
return compareToSequence(o.recordEpoch, o.recordSeq);
}
--- a/src/java.base/share/classes/sun/security/x509/X509CertImpl.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/sun/security/x509/X509CertImpl.java Mon Oct 30 17:49:33 2017 -0700
@@ -1485,7 +1485,7 @@
}
/**
- * Get the certificate constraints path length from the
+ * Get the certificate constraints path length from
* the critical BasicConstraints extension, (oid = 2.5.29.19).
* @return the length of the constraint.
*/
--- a/src/java.base/share/classes/sun/util/logging/PlatformLogger.java Mon Oct 30 17:32:38 2017 -0700
+++ b/src/java.base/share/classes/sun/util/logging/PlatformLogger.java Mon Oct 30 17:49:33 2017 -0700
@@ -45,7 +45,7 @@
*
* If the logging facility is not enabled, the platform loggers
* will output log messages per the default logging configuration
- * (see below). In this implementation, it does not log the
+ * (see below). In this implementation, it does not log
* the stack frame information issuing the log message.
*
* When the logging facility is enabled (at startup or runtime),