HBASE-4829 Fix javadoc warnings in 0.92 branch

git-svn-id: https://svn.apache.org/repos/asf/hbase/trunk@1204094 13f79535-47bb-0310-9956-ffa450edef68

src/main/java/org/apache/hadoop/hbase/client/Result.java

@@ -60,8 +60,8 @@ import org.apache.hadoop.io.Writable;
  * A Result is backed by an array of {@link KeyValue} objects, each representing
  * an HBase cell defined by the row, family, qualifier, timestamp, and value.<p>
  *
- * The underlying {@link KeyValue} objects can be accessed through the methods
+ * The underlying {@link KeyValue} objects can be accessed through the method {@link #list()}.
- * {@link #sorted()} and {@link #list()}.  Each KeyValue can then be accessed
+ * Each KeyValue can then be accessed
  * through {@link KeyValue#getRow()}, {@link KeyValue#getFamily()}, {@link KeyValue#getQualifier()},
  * {@link KeyValue#getTimestamp()}, and {@link KeyValue#getValue()}.
  */

src/main/java/org/apache/hadoop/hbase/ipc/RequestContext.java

@@ -46,7 +46,7 @@ public class RequestContext {
   /**
    * Returns the user credentials associated with the current RPC request or
    * <code>null</code> if no credentials were provided.
-   * @return
+   * @return A User
    */
   public static User getRequestUser() {
     RequestContext ctx = instance.get();

src/main/java/org/apache/hadoop/hbase/mapreduce/TableInputFormat.java

@@ -168,7 +168,6 @@ implements Configurable {
    * Overrides previous calls to addFamily for any families in the input.
    *
    * @param columns array of columns, formatted as <pre>family:qualifier</pre>
-   * @return this
    */
   public static void addColumns(Scan scan, byte [][] columns) {
     for (byte[] column : columns) {

src/main/java/org/apache/hadoop/hbase/security/User.java

@@ -149,7 +149,7 @@ public abstract class User {
   /**
    * Wraps an underlying {@code UserGroupInformation} instance.
    * @param ugi The base Hadoop user
-   * @return
+   * @return User
    */
   public static User create(UserGroupInformation ugi) {
     if (ugi == null) {

src/main/java/org/apache/hadoop/hbase/util/FSUtils.java

@@ -151,7 +151,6 @@ public abstract class FSUtils {
   /**
    * Check whether dfs is in safemode. 
    * @param conf
-   * @return true if dfs is in safemode.
    * @throws IOException
    */
   public static void checkDfsSafeMode(final Configuration conf) 

src/main/java/org/apache/hadoop/hbase/zookeeper/ZKLeaderManager.java

@@ -28,9 +28,9 @@ import org.apache.zookeeper.KeeperException;
 
 /**
  * Handles coordination of a single "leader" instance among many possible
- * candidates.  The first {@code ZKLeaderManager} to successfully create
+ * candidates.  The first {@link ZKLeaderManager} to successfully create
  * the given znode becomes the leader, allowing the instance to continue
- * with whatever processing must be protected.  Other {@ZKLeaderManager}
+ * with whatever processing must be protected.  Other {@link ZKLeaderManager}
  * instances will wait to be notified of changes to the leader znode.
  * If the current master instance fails, the ephemeral leader znode will
  * be removed, and all waiting instances will be notified, with the race

src/main/java/org/apache/hadoop/hbase/zookeeper/ZKUtil.java

@@ -580,7 +580,7 @@ public class ZKUtil {
    * children, an empty list will be returned.
    *
    * @param zkw zk reference
-   * @param znode path of node to list and watch children of
+   * @param baseNode path of node to list and watch children of
    * @return list of data of children of the specified node, an empty list if the node
    *          exists but has no children, and null if the node does not exist
    * @throws KeeperException if unexpected zookeeper exception