8175094: Mark the deprecated java.security.acl APIs with forRemoval=true
authormullan
Tue, 14 Nov 2017 09:15:12 -0500
changeset 47745 e6e6ed17abbe
parent 47733 fbfe06b70e16
child 47746 94f362b5f4dd
8175094: Mark the deprecated java.security.acl APIs with forRemoval=true Reviewed-by: weijun
src/java.base/share/classes/java/security/acl/Acl.java
src/java.base/share/classes/java/security/acl/AclEntry.java
src/java.base/share/classes/java/security/acl/AclNotFoundException.java
src/java.base/share/classes/java/security/acl/Group.java
src/java.base/share/classes/java/security/acl/LastOwnerException.java
src/java.base/share/classes/java/security/acl/NotOwnerException.java
src/java.base/share/classes/java/security/acl/Owner.java
src/java.base/share/classes/java/security/acl/Permission.java
src/java.base/share/classes/java/security/acl/package-info.java
--- a/src/java.base/share/classes/java/security/acl/Acl.java	Mon Nov 13 14:03:36 2017 +0530
+++ b/src/java.base/share/classes/java/security/acl/Acl.java	Tue Nov 14 09:15:12 2017 -0500
@@ -84,11 +84,13 @@
  * @author Satish Dharmaraj
  * @since 1.1
  *
- * @deprecated This package has been replaced by {@code java.security.Policy}
- *      and related classes since 1.2.
+ * @deprecated This class is deprecated and subject to removal in a future
+ *     version of Java SE. It has been replaced by {@code java.security.Policy}
+ *     and related classes since 1.2.
  */
 
-@Deprecated(since="9")
+@Deprecated(since="9", forRemoval=true)
+@SuppressWarnings("removal")
 public interface Acl extends Owner {
 
     /**
--- a/src/java.base/share/classes/java/security/acl/AclEntry.java	Mon Nov 13 14:03:36 2017 +0530
+++ b/src/java.base/share/classes/java/security/acl/AclEntry.java	Tue Nov 14 09:15:12 2017 -0500
@@ -52,10 +52,12 @@
  * @author      Satish Dharmaraj
  * @since 1.1
  *
- * @deprecated This package has been replaced by {@code java.security.Policy}
- *      and related classes since 1.2.
+ * @deprecated This class is deprecated and subject to removal in a future
+ *     version of Java SE. It has been replaced by {@code java.security.Policy}
+ *     and related classes since 1.2.
  */
-@Deprecated(since="9")
+@Deprecated(since="9", forRemoval=true)
+@SuppressWarnings("removal")
 public interface AclEntry extends Cloneable {
 
     /**
--- a/src/java.base/share/classes/java/security/acl/AclNotFoundException.java	Mon Nov 13 14:03:36 2017 +0530
+++ b/src/java.base/share/classes/java/security/acl/AclNotFoundException.java	Tue Nov 14 09:15:12 2017 -0500
@@ -32,10 +32,11 @@
  * @author      Satish Dharmaraj
  * @since 1.1
  *
- * @deprecated This package has been replaced by {@code java.security.Policy}
- *      and related classes since 1.2.
+ * @deprecated This class is deprecated and subject to removal in a future
+ *     version of Java SE. It has been replaced by {@code java.security.Policy}
+ *     and related classes since 1.2.
  */
-@Deprecated(since="9")
+@Deprecated(since="9", forRemoval=true)
 public class AclNotFoundException extends Exception {
 
     private static final long serialVersionUID = 5684295034092681791L;
--- a/src/java.base/share/classes/java/security/acl/Group.java	Mon Nov 13 14:03:36 2017 +0530
+++ b/src/java.base/share/classes/java/security/acl/Group.java	Tue Nov 14 09:15:12 2017 -0500
@@ -41,10 +41,11 @@
  * @author      Satish Dharmaraj
  * @since 1.1
  *
- * @deprecated This package has been replaced by {@code java.security.Policy}
- *      and related classes since 1.2.
+ * @deprecated This class is deprecated and subject to removal in a future
+ *     version of Java SE. It has been replaced by {@code java.security.Policy}
+ *     and related classes since 1.2.
  */
-@Deprecated(since="9")
+@Deprecated(since="9", forRemoval=true)
 public interface Group extends Principal {
 
     /**
--- a/src/java.base/share/classes/java/security/acl/LastOwnerException.java	Mon Nov 13 14:03:36 2017 +0530
+++ b/src/java.base/share/classes/java/security/acl/LastOwnerException.java	Tue Nov 14 09:15:12 2017 -0500
@@ -34,10 +34,11 @@
  * @author Satish Dharmaraj
  * @since 1.1
  *
- * @deprecated This package has been replaced by {@code java.security.Policy}
- *      and related classes since 1.2.
+ * @deprecated This class is deprecated and subject to removal in a future
+ *     version of Java SE. It has been replaced by {@code java.security.Policy}
+ *     and related classes since 1.2.
  */
-@Deprecated(since="9")
+@Deprecated(since="9", forRemoval=true)
 public class LastOwnerException extends Exception {
 
     private static final long serialVersionUID = -5141997548211140359L;
--- a/src/java.base/share/classes/java/security/acl/NotOwnerException.java	Mon Nov 13 14:03:36 2017 +0530
+++ b/src/java.base/share/classes/java/security/acl/NotOwnerException.java	Tue Nov 14 09:15:12 2017 -0500
@@ -33,10 +33,11 @@
  * @author      Satish Dharmaraj
  * @since 1.1
  *
- * @deprecated This package has been replaced by {@code java.security.Policy}
- *      and related classes since 1.2.
+ * @deprecated This class is deprecated and subject to removal in a future
+ *     version of Java SE. It has been replaced by {@code java.security.Policy}
+ *     and related classes since 1.2.
  */
-@Deprecated(since="9")
+@Deprecated(since="9", forRemoval=true)
 public class NotOwnerException extends Exception {
 
     private static final long serialVersionUID = -5555597911163362399L;
--- a/src/java.base/share/classes/java/security/acl/Owner.java	Mon Nov 13 14:03:36 2017 +0530
+++ b/src/java.base/share/classes/java/security/acl/Owner.java	Tue Nov 14 09:15:12 2017 -0500
@@ -37,10 +37,12 @@
  * @since 1.1
  * @see java.security.acl.Acl
  *
- * @deprecated This package has been replaced by {@code java.security.Policy}
- *      and related classes since 1.2.
+ * @deprecated This class is deprecated and subject to removal in a future
+ *     version of Java SE. It has been replaced by {@code java.security.Policy}
+ *     and related classes since 1.2.
  */
-@Deprecated(since="9")
+@Deprecated(since="9", forRemoval=true)
+@SuppressWarnings("removal")
 public interface Owner {
 
     /**
--- a/src/java.base/share/classes/java/security/acl/Permission.java	Mon Nov 13 14:03:36 2017 +0530
+++ b/src/java.base/share/classes/java/security/acl/Permission.java	Tue Nov 14 09:15:12 2017 -0500
@@ -33,10 +33,11 @@
  * @author Satish Dharmaraj
  * @since 1.1
  *
- * @deprecated This package has been replaced by {@code java.security.Policy}
- *      and related classes since 1.2.
+ * @deprecated This class is deprecated and subject to removal in a future
+ *     version of Java SE. It has been replaced by {@code java.security.Policy}
+ *     and related classes since 1.2.
  */
-@Deprecated(since="9")
+@Deprecated(since="9", forRemoval=true)
 public interface Permission {
 
     /**
--- a/src/java.base/share/classes/java/security/acl/package-info.java	Mon Nov 13 14:03:36 2017 +0530
+++ b/src/java.base/share/classes/java/security/acl/package-info.java	Tue Nov 14 09:15:12 2017 -0500
@@ -27,7 +27,8 @@
  * The classes and interfaces in this package have been deprecated. New
  * classes should not be added to this package. The {@code java.security}
  * package contains suitable replacements. See {@link java.security.Policy}
- * and related classes for details.
+ * and related classes for details. This package is subject to removal in a
+ * future version of Java SE.
  *
  * @since 1.1
  */