8344788: Specify that the access control context parameters of Subject.doAsPrivileged are ignored

Reviewed-by: alanb

Author: seanjmullan

src/java.base/share/classes/javax/security/auth/Subject.java

@@ -474,8 +474,8 @@ public static <T> T doAs(final Subject subject,
     /**
      * Perform privileged work as a particular {@code Subject}.
      *
-     * <p> This method ignores the {@code acc} argument, launches {@code action},
-     * and binds {@code subject} to the period of its execution.
+     * <p> This method launches {@code action} and binds {@code subject} to
+     * the period of its execution.
      *
      * @param subject the {@code Subject} that the specified
      *                  {@code action} will run as.  This parameter
@@ -487,8 +487,7 @@ public static <T> T doAs(final Subject subject,
      * @param action the code to be run as the specified
      *                  {@code Subject}.
      *
-     * @param acc the {@code AccessControlContext} to be tied to the
-     *                  specified <i>subject</i> and <i>action</i>.
+     * @param acc ignored
      *
      * @return the value returned by the PrivilegedAction's
      *                  {@code run} method.
@@ -540,8 +539,8 @@ public static <T> T doAsPrivileged(final Subject subject,
     /**
      * Perform privileged work as a particular {@code Subject}.
      *
-     * <p> This method ignores the {@code acc} argument, launches {@code action},
-     * and binds {@code subject} to the period of its execution.
+     * <p> This method launches {@code action} and binds {@code subject} to
+     * the period of its execution.
      *
      * @param subject the {@code Subject} that the specified
      *                  {@code action} will run as.  This parameter
@@ -553,8 +552,7 @@ public static <T> T doAsPrivileged(final Subject subject,
      * @param action the code to be run as the specified
      *                  {@code Subject}.
      *
-     * @param acc the {@code AccessControlContext} to be tied to the
-     *                  specified <i>subject</i> and <i>action</i>.
+     * @param acc ignored
      *
      * @return the value returned by the
      *                  PrivilegedExceptionAction's {@code run} method.