changeset 16864:8ac762a3d4a4

8176566: @since value errors in types of java.base module Reviewed-by: martin, psandoz
author mli
date Tue, 14 Mar 2017 19:23:37 -0700
parents 6bb7ec151fd4
children fccdf07c7c67
files src/java.base/share/classes/java/lang/invoke/CallSite.java src/java.base/share/classes/java/lang/invoke/ConstantCallSite.java src/java.base/share/classes/java/lang/invoke/LambdaConversionException.java src/java.base/share/classes/java/lang/invoke/LambdaMetafactory.java src/java.base/share/classes/java/lang/invoke/MethodHandle.java src/java.base/share/classes/java/lang/invoke/MethodHandleProxies.java src/java.base/share/classes/java/lang/invoke/MethodType.java src/java.base/share/classes/java/lang/invoke/MutableCallSite.java src/java.base/share/classes/java/lang/invoke/SerializedLambda.java src/java.base/share/classes/java/lang/invoke/SwitchPoint.java src/java.base/share/classes/java/lang/invoke/VolatileCallSite.java src/java.base/share/classes/java/nio/file/ClosedFileSystemException.java src/java.base/share/classes/java/nio/file/ClosedWatchServiceException.java src/java.base/share/classes/java/nio/file/FileSystemAlreadyExistsException.java src/java.base/share/classes/java/nio/file/FileSystemNotFoundException.java src/java.base/share/classes/java/nio/file/InvalidPathException.java src/java.base/share/classes/java/nio/file/ProviderMismatchException.java src/java.base/share/classes/java/nio/file/ProviderNotFoundException.java src/java.base/share/classes/java/nio/file/ReadOnlyFileSystemException.java src/java.base/share/classes/java/util/zip/ZipException.java
diffstat 20 files changed, 30 insertions(+), 1 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.base/share/classes/java/lang/invoke/CallSite.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/CallSite.java	Tue Mar 14 19:23:37 2017 -0700
@@ -82,6 +82,7 @@
 }
 }</pre></blockquote>
  * @author John Rose, JSR 292 EG
+ * @since 1.7
  */
 abstract
 public class CallSite {
--- a/src/java.base/share/classes/java/lang/invoke/ConstantCallSite.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/ConstantCallSite.java	Tue Mar 14 19:23:37 2017 -0700
@@ -30,6 +30,7 @@
  * 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;
--- a/src/java.base/share/classes/java/lang/invoke/LambdaConversionException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/LambdaConversionException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -27,6 +27,8 @@
 
 /**
  * LambdaConversionException
+ *
+ * @since 1.8
  */
 public class LambdaConversionException extends Exception {
     private static final long serialVersionUID = 292L + 8L;
--- a/src/java.base/share/classes/java/lang/invoke/LambdaMetafactory.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/LambdaMetafactory.java	Tue Mar 14 19:23:37 2017 -0700
@@ -211,6 +211,7 @@
  * 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 {
 
--- a/src/java.base/share/classes/java/lang/invoke/MethodHandle.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/MethodHandle.java	Tue Mar 14 19:23:37 2017 -0700
@@ -423,6 +423,7 @@
  * @see MethodType
  * @see MethodHandles
  * @author John Rose, JSR 292 EG
+ * @since 1.7
  */
 public abstract class MethodHandle {
 
--- a/src/java.base/share/classes/java/lang/invoke/MethodHandleProxies.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/MethodHandleProxies.java	Tue Mar 14 19:23:37 2017 -0700
@@ -38,6 +38,8 @@
 /**
  * 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 {
 
--- a/src/java.base/share/classes/java/lang/invoke/MethodType.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/MethodType.java	Tue Mar 14 19:23:37 2017 -0700
@@ -88,6 +88,7 @@
  * (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 {
--- a/src/java.base/share/classes/java/lang/invoke/MutableCallSite.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/MutableCallSite.java	Tue Mar 14 19:23:37 2017 -0700
@@ -81,6 +81,7 @@
  * 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 {
     /**
--- a/src/java.base/share/classes/java/lang/invoke/SerializedLambda.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/SerializedLambda.java	Tue Mar 14 19:23:37 2017 -0700
@@ -54,6 +54,7 @@
  * lambda actually captured by that class.
  *
  * @see LambdaMetafactory
+ * @since 1.8
  */
 public final class SerializedLambda implements Serializable {
     private static final long serialVersionUID = 8025925345765570181L;
--- a/src/java.base/share/classes/java/lang/invoke/SwitchPoint.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/SwitchPoint.java	Tue Mar 14 19:23:37 2017 -0700
@@ -108,6 +108,7 @@
  * }
  * }</pre>
  * @author Remi Forax, JSR 292 EG
+ * @since 1.7
  */
 public class SwitchPoint {
     private static final MethodHandle
--- a/src/java.base/share/classes/java/lang/invoke/VolatileCallSite.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/lang/invoke/VolatileCallSite.java	Tue Mar 14 19:23:37 2017 -0700
@@ -40,6 +40,7 @@
  * with {@code MutableCallSite}.
  * @see MutableCallSite
  * @author John Rose, JSR 292 EG
+ * @since 1.7
  */
 public class VolatileCallSite extends CallSite {
     /**
--- a/src/java.base/share/classes/java/nio/file/ClosedFileSystemException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/nio/file/ClosedFileSystemException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -28,6 +28,8 @@
 /**
  * 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
--- a/src/java.base/share/classes/java/nio/file/ClosedWatchServiceException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/nio/file/ClosedWatchServiceException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -28,6 +28,8 @@
 /**
  * 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
--- a/src/java.base/share/classes/java/nio/file/FileSystemAlreadyExistsException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/nio/file/FileSystemAlreadyExistsException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -28,6 +28,8 @@
 /**
  * Runtime exception thrown when an attempt is made to create a file system that
  * already exists.
+ *
+ * @since 1.7
  */
 
 public class FileSystemAlreadyExistsException
--- a/src/java.base/share/classes/java/nio/file/FileSystemNotFoundException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/nio/file/FileSystemNotFoundException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -27,6 +27,8 @@
 
 /**
  * Runtime exception thrown when a file system cannot be found.
+ *
+ * @since 1.7
  */
 
 public class FileSystemNotFoundException
--- a/src/java.base/share/classes/java/nio/file/InvalidPathException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/nio/file/InvalidPathException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -29,6 +29,8 @@
  * 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
--- a/src/java.base/share/classes/java/nio/file/ProviderMismatchException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/nio/file/ProviderMismatchException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -29,6 +29,8 @@
  * 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
--- a/src/java.base/share/classes/java/nio/file/ProviderNotFoundException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/nio/file/ProviderNotFoundException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -27,6 +27,8 @@
 
 /**
  * Runtime exception thrown when a provider of the required type cannot be found.
+ *
+ * @since 1.7
  */
 
 public class ProviderNotFoundException
--- a/src/java.base/share/classes/java/nio/file/ReadOnlyFileSystemException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/nio/file/ReadOnlyFileSystemException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -28,6 +28,8 @@
 /**
  * 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
--- a/src/java.base/share/classes/java/util/zip/ZipException.java	Wed Mar 15 08:09:43 2017 +0800
+++ b/src/java.base/share/classes/java/util/zip/ZipException.java	Tue Mar 14 19:23:37 2017 -0700
@@ -32,7 +32,7 @@
  *
  * @author  unascribed
  * @see     java.io.IOException
- * @since   1.0
+ * @since   1.1
  */
 
 public