Add Javadoc links to deprecated methods in UGI and SecurityUtil

Author: stoty

hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/security/SecurityUtil.java

@@ -514,6 +514,7 @@ public static Text buildTokenService(URI uri) {
    * @param action action.
    * @param <T> generic type T.
    * @return generic type T.
+   * @deprecated Use {@link #callAsLoginUserOrFatalNoException()} instead
    */
   @Deprecated
   public static <T> T doAsLoginUserOrFatal(PrivilegedAction<T> action) { 
@@ -596,6 +597,7 @@ public static <T> T callAsLoginUser(Callable<T> action)
    * @param <T> Generics Type T.
    * @return the result of the action
    * @throws IOException in the event of error
+   * @deprecated Use {@link #callAsLoginUser()} instead
    */
   @Deprecated
   public static <T> T doAsLoginUser(PrivilegedExceptionAction<T> action)
@@ -629,6 +631,7 @@ public static <T> T callAsCurrentUser(Callable<T> action)
    * @param <T> generic type T.
    * @return the result of the action
    * @throws IOException in the event of error
+   * @deprecated Use {@link #callAsCurrentUser()} instead
    */
   @Deprecated
   public static <T> T doAsCurrentUser(PrivilegedExceptionAction<T> action)

hadoop-common-project/hadoop-common/src/main/java/org/apache/hadoop/security/UserGroupInformation.java

@@ -2006,6 +2006,7 @@ public <T> T callAsNoException(Callable<T> action) {
    * @param <T> the return type of the run method
    * @param action the method to execute
    * @return the value from the run method
+   * @deprecated Use {@link #callAs()} or {@link #callAsNoException()} instead.
    */
   @InterfaceAudience.Public
   @InterfaceStability.Evolving
@@ -2026,6 +2027,7 @@ public <T> T doAs(PrivilegedAction<T> action) {
    * @throws RuntimeException if the action throws a RuntimeException
    * @throws InterruptedException if the action throws an InterruptedException
    * @throws UndeclaredThrowableException if the action throws something else
+   * @deprecated Use {@link #callAs()} instead.
    */
   @InterfaceAudience.Public
   @InterfaceStability.Evolving