From 2be84072663b852d0c49958d6cd073fbde17a7c4 Mon Sep 17 00:00:00 2001
From: Hamlin Li <mli@openjdk.org>
Date: Tue, 14 Mar 2017 19:23:37 -0700
Subject: [PATCH] 8176566: @since value errors in types of java.base module

Reviewed-by: martin, psandoz
---
 jdk/src/java.base/share/classes/java/lang/invoke/CallSite.java  | 1 +
 .../share/classes/java/lang/invoke/ConstantCallSite.java        | 1 +
 .../classes/java/lang/invoke/LambdaConversionException.java     | 2 ++
 .../share/classes/java/lang/invoke/LambdaMetafactory.java       | 1 +
 .../java.base/share/classes/java/lang/invoke/MethodHandle.java  | 1 +
 .../share/classes/java/lang/invoke/MethodHandleProxies.java     | 2 ++
 .../java.base/share/classes/java/lang/invoke/MethodType.java    | 1 +
 .../share/classes/java/lang/invoke/MutableCallSite.java         | 1 +
 .../share/classes/java/lang/invoke/SerializedLambda.java        | 1 +
 .../java.base/share/classes/java/lang/invoke/SwitchPoint.java   | 1 +
 .../share/classes/java/lang/invoke/VolatileCallSite.java        | 1 +
 .../share/classes/java/nio/file/ClosedFileSystemException.java  | 2 ++
 .../classes/java/nio/file/ClosedWatchServiceException.java      | 2 ++
 .../classes/java/nio/file/FileSystemAlreadyExistsException.java | 2 ++
 .../classes/java/nio/file/FileSystemNotFoundException.java      | 2 ++
 .../share/classes/java/nio/file/InvalidPathException.java       | 2 ++
 .../share/classes/java/nio/file/ProviderMismatchException.java  | 2 ++
 .../share/classes/java/nio/file/ProviderNotFoundException.java  | 2 ++
 .../classes/java/nio/file/ReadOnlyFileSystemException.java      | 2 ++
 jdk/src/java.base/share/classes/java/util/zip/ZipException.java | 2 +-
 20 files changed, 30 insertions(+), 1 deletion(-)

diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/CallSite.java b/jdk/src/java.base/share/classes/java/lang/invoke/CallSite.java
index 53899611f59..031e18a759a 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/CallSite.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/CallSite.java
@@ -82,6 +82,7 @@ private static CallSite bootstrapDynamic(MethodHandles.Lookup caller, String nam
 }
 }</pre></blockquote>
  * @author John Rose, JSR 292 EG
+ * @since 1.7
  */
 abstract
 public class CallSite {
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/ConstantCallSite.java b/jdk/src/java.base/share/classes/java/lang/invoke/ConstantCallSite.java
index f27d0e7bbd2..f7d87ba45ac 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/ConstantCallSite.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/ConstantCallSite.java
@@ -30,6 +30,7 @@ package java.lang.invoke;
  * An {@code invokedynamic} instruction linked to a {@code ConstantCallSite} is permanently
  * bound to the call site's target.
  * @author John Rose, JSR 292 EG
+ * @since 1.7
  */
 public class ConstantCallSite extends CallSite {
     private final boolean isFrozen;
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/LambdaConversionException.java b/jdk/src/java.base/share/classes/java/lang/invoke/LambdaConversionException.java
index e1123da59d8..2dc8f22c01d 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/LambdaConversionException.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/LambdaConversionException.java
@@ -27,6 +27,8 @@ package java.lang.invoke;
 
 /**
  * LambdaConversionException
+ *
+ * @since 1.8
  */
 public class LambdaConversionException extends Exception {
     private static final long serialVersionUID = 292L + 8L;
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/LambdaMetafactory.java b/jdk/src/java.base/share/classes/java/lang/invoke/LambdaMetafactory.java
index b6ef976c515..b09744cba7d 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/LambdaMetafactory.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/LambdaMetafactory.java
@@ -211,6 +211,7 @@ import java.util.Arrays;
  * theory, any method handle could be used. Currently supported are direct method
  * handles representing invocation of virtual, interface, constructor and static
  * methods.
+ * @since 1.8
  */
 public class LambdaMetafactory {
 
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/MethodHandle.java b/jdk/src/java.base/share/classes/java/lang/invoke/MethodHandle.java
index 6265b874175..3ec8b63bcbd 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/MethodHandle.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/MethodHandle.java
@@ -423,6 +423,7 @@ mh.invokeExact(System.out, "Hello, world.");
  * @see MethodType
  * @see MethodHandles
  * @author John Rose, JSR 292 EG
+ * @since 1.7
  */
 public abstract class MethodHandle {
 
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/MethodHandleProxies.java b/jdk/src/java.base/share/classes/java/lang/invoke/MethodHandleProxies.java
index 09db4f93512..fce6e0fef01 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/MethodHandleProxies.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/MethodHandleProxies.java
@@ -38,6 +38,8 @@ import static java.lang.invoke.MethodHandleStatics.*;
 /**
  * This class consists exclusively of static methods that help adapt
  * method handles to other JVM types, such as interfaces.
+ *
+ * @since 1.7
  */
 public class MethodHandleProxies {
 
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/MethodType.java b/jdk/src/java.base/share/classes/java/lang/invoke/MethodType.java
index 53e88de34f2..860ef23f019 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/MethodType.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/MethodType.java
@@ -88,6 +88,7 @@ import sun.invoke.util.VerifyType;
  * (But the classes need not be initialized, as is the case with a {@code CONSTANT_Class}.)
  * This loading may occur at any time before the {@code MethodType} object is first derived.
  * @author John Rose, JSR 292 EG
+ * @since 1.7
  */
 public final
 class MethodType implements java.io.Serializable {
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/MutableCallSite.java b/jdk/src/java.base/share/classes/java/lang/invoke/MutableCallSite.java
index 6e5d350495d..2d32abde706 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/MutableCallSite.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/MutableCallSite.java
@@ -81,6 +81,7 @@ assertEquals("Wilma, dear?", (String) worker2.invokeExact());
  * For target values which will be frequently updated, consider using
  * a {@linkplain VolatileCallSite volatile call site} instead.
  * @author John Rose, JSR 292 EG
+ * @since 1.7
  */
 public class MutableCallSite extends CallSite {
     /**
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/SerializedLambda.java b/jdk/src/java.base/share/classes/java/lang/invoke/SerializedLambda.java
index d9f94f39e77..0566e6b483e 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/SerializedLambda.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/SerializedLambda.java
@@ -54,6 +54,7 @@ import java.util.Objects;
  * lambda actually captured by that class.
  *
  * @see LambdaMetafactory
+ * @since 1.8
  */
 public final class SerializedLambda implements Serializable {
     private static final long serialVersionUID = 8025925345765570181L;
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/SwitchPoint.java b/jdk/src/java.base/share/classes/java/lang/invoke/SwitchPoint.java
index 5d9b3bfe843..83b4d49cd42 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/SwitchPoint.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/SwitchPoint.java
@@ -108,6 +108,7 @@ package java.lang.invoke;
  * }
  * }</pre>
  * @author Remi Forax, JSR 292 EG
+ * @since 1.7
  */
 public class SwitchPoint {
     private static final MethodHandle
diff --git a/jdk/src/java.base/share/classes/java/lang/invoke/VolatileCallSite.java b/jdk/src/java.base/share/classes/java/lang/invoke/VolatileCallSite.java
index de88f36bbb3..1046e72edf6 100644
--- a/jdk/src/java.base/share/classes/java/lang/invoke/VolatileCallSite.java
+++ b/jdk/src/java.base/share/classes/java/lang/invoke/VolatileCallSite.java
@@ -40,6 +40,7 @@ package java.lang.invoke;
  * with {@code MutableCallSite}.
  * @see MutableCallSite
  * @author John Rose, JSR 292 EG
+ * @since 1.7
  */
 public class VolatileCallSite extends CallSite {
     /**
diff --git a/jdk/src/java.base/share/classes/java/nio/file/ClosedFileSystemException.java b/jdk/src/java.base/share/classes/java/nio/file/ClosedFileSystemException.java
index 82cf096c848..60d4551419f 100644
--- a/jdk/src/java.base/share/classes/java/nio/file/ClosedFileSystemException.java
+++ b/jdk/src/java.base/share/classes/java/nio/file/ClosedFileSystemException.java
@@ -28,6 +28,8 @@ package java.nio.file;
 /**
  * Unchecked exception thrown when an attempt is made to invoke an operation on
  * a file and the file system is closed.
+ *
+ * @since 1.7
  */
 
 public class ClosedFileSystemException
diff --git a/jdk/src/java.base/share/classes/java/nio/file/ClosedWatchServiceException.java b/jdk/src/java.base/share/classes/java/nio/file/ClosedWatchServiceException.java
index 3995b6def60..4990a7aca3f 100644
--- a/jdk/src/java.base/share/classes/java/nio/file/ClosedWatchServiceException.java
+++ b/jdk/src/java.base/share/classes/java/nio/file/ClosedWatchServiceException.java
@@ -28,6 +28,8 @@ package java.nio.file;
 /**
  * Unchecked exception thrown when an attempt is made to invoke an operation on
  * a watch service that is closed.
+ *
+ * @since 1.7
  */
 
 public class ClosedWatchServiceException
diff --git a/jdk/src/java.base/share/classes/java/nio/file/FileSystemAlreadyExistsException.java b/jdk/src/java.base/share/classes/java/nio/file/FileSystemAlreadyExistsException.java
index e305542508f..5877410473e 100644
--- a/jdk/src/java.base/share/classes/java/nio/file/FileSystemAlreadyExistsException.java
+++ b/jdk/src/java.base/share/classes/java/nio/file/FileSystemAlreadyExistsException.java
@@ -28,6 +28,8 @@ package java.nio.file;
 /**
  * Runtime exception thrown when an attempt is made to create a file system that
  * already exists.
+ *
+ * @since 1.7
  */
 
 public class FileSystemAlreadyExistsException
diff --git a/jdk/src/java.base/share/classes/java/nio/file/FileSystemNotFoundException.java b/jdk/src/java.base/share/classes/java/nio/file/FileSystemNotFoundException.java
index 1c0ee4cb731..e50eafb5d6d 100644
--- a/jdk/src/java.base/share/classes/java/nio/file/FileSystemNotFoundException.java
+++ b/jdk/src/java.base/share/classes/java/nio/file/FileSystemNotFoundException.java
@@ -27,6 +27,8 @@ package java.nio.file;
 
 /**
  * Runtime exception thrown when a file system cannot be found.
+ *
+ * @since 1.7
  */
 
 public class FileSystemNotFoundException
diff --git a/jdk/src/java.base/share/classes/java/nio/file/InvalidPathException.java b/jdk/src/java.base/share/classes/java/nio/file/InvalidPathException.java
index 0502d7ba809..2dc3597ded8 100644
--- a/jdk/src/java.base/share/classes/java/nio/file/InvalidPathException.java
+++ b/jdk/src/java.base/share/classes/java/nio/file/InvalidPathException.java
@@ -29,6 +29,8 @@ package java.nio.file;
  * Unchecked exception thrown when path string cannot be converted into a
  * {@link Path} because the path string contains invalid characters, or
  * the path string is invalid for other file system specific reasons.
+ *
+ * @since 1.7
  */
 
 public class InvalidPathException
diff --git a/jdk/src/java.base/share/classes/java/nio/file/ProviderMismatchException.java b/jdk/src/java.base/share/classes/java/nio/file/ProviderMismatchException.java
index 0220d6e173f..9e628cbdfc7 100644
--- a/jdk/src/java.base/share/classes/java/nio/file/ProviderMismatchException.java
+++ b/jdk/src/java.base/share/classes/java/nio/file/ProviderMismatchException.java
@@ -29,6 +29,8 @@ package java.nio.file;
  * Unchecked exception thrown when an attempt is made to invoke a method on an
  * object created by one file system provider with a parameter created by a
  * different file system provider.
+ *
+ * @since 1.7
  */
 public class ProviderMismatchException
     extends java.lang.IllegalArgumentException
diff --git a/jdk/src/java.base/share/classes/java/nio/file/ProviderNotFoundException.java b/jdk/src/java.base/share/classes/java/nio/file/ProviderNotFoundException.java
index 8fa0cefaf3b..41f9819aacb 100644
--- a/jdk/src/java.base/share/classes/java/nio/file/ProviderNotFoundException.java
+++ b/jdk/src/java.base/share/classes/java/nio/file/ProviderNotFoundException.java
@@ -27,6 +27,8 @@ package java.nio.file;
 
 /**
  * Runtime exception thrown when a provider of the required type cannot be found.
+ *
+ * @since 1.7
  */
 
 public class ProviderNotFoundException
diff --git a/jdk/src/java.base/share/classes/java/nio/file/ReadOnlyFileSystemException.java b/jdk/src/java.base/share/classes/java/nio/file/ReadOnlyFileSystemException.java
index 9b25e5f054b..0b9d42a2bbb 100644
--- a/jdk/src/java.base/share/classes/java/nio/file/ReadOnlyFileSystemException.java
+++ b/jdk/src/java.base/share/classes/java/nio/file/ReadOnlyFileSystemException.java
@@ -28,6 +28,8 @@ package java.nio.file;
 /**
  * Unchecked exception thrown when an attempt is made to update an object
  * associated with a {@link FileSystem#isReadOnly() read-only} {@code FileSystem}.
+ *
+ * @since 1.7
  */
 
 public class ReadOnlyFileSystemException
diff --git a/jdk/src/java.base/share/classes/java/util/zip/ZipException.java b/jdk/src/java.base/share/classes/java/util/zip/ZipException.java
index 7031292d282..588611f1e0e 100644
--- a/jdk/src/java.base/share/classes/java/util/zip/ZipException.java
+++ b/jdk/src/java.base/share/classes/java/util/zip/ZipException.java
@@ -32,7 +32,7 @@ import java.io.IOException;
  *
  * @author  unascribed
  * @see     java.io.IOException
- * @since   1.0
+ * @since   1.1
  */
 
 public