HBASE-9181 Fix javadoc warnings introduce by namespaces

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

hbase-client/src/main/java/org/apache/hadoop/hbase/client/HBaseAdmin.java

@@ -2110,7 +2110,7 @@ public class HBaseAdmin implements Abortable, Closeable {
   /**
    * Get a namespace descriptor by name
    * @param name name of namespace descriptor
-   * @return
+   * @return A descriptor
    * @throws IOException
    */
   public NamespaceDescriptor getNamespaceDescriptor(final String name) throws IOException {
@@ -2128,7 +2128,7 @@ public class HBaseAdmin implements Abortable, Closeable {
 
   /**
    * List available namespace descriptors
-   * @return
+   * @return List of descriptors
    * @throws IOException
    */
   public NamespaceDescriptor[] listNamespaceDescriptors() throws IOException {
@@ -2152,7 +2152,7 @@ public class HBaseAdmin implements Abortable, Closeable {
   /**
    * Get list of table descriptors by namespace
    * @param name namespace name
-   * @return
+   * @return A descriptor
    * @throws IOException
    */
   public HTableDescriptor[] getTableDescriptorsByNamespace(final String name) throws IOException {
@@ -2270,7 +2270,7 @@ public class HBaseAdmin implements Abortable, Closeable {
 
   /**
    * Get tableDescriptors
-   * @param tableNames List of table names
+   * @param names List of table names
    * @return HTD[] the tableDescriptor
    * @throws IOException if a remote or network exception occurs
    */
@@ -2453,8 +2453,7 @@ public class HBaseAdmin implements Abortable, Closeable {
     * snapshot with the same name (even a different type or with different parameters) will fail with
     * a {@link SnapshotCreationException} indicating the duplicate naming.
     * <p>
-    * Snapshot names follow the same naming constraints as tables in HBase. See
-    * {@link HTableDescriptor#isLegalTableName(byte[])}.
+    * Snapshot names follow the same naming constraints as tables in HBase.
     * @param snapshotName name of the snapshot to be created
     * @param tableName name of the table for which snapshot is created
     * @throws IOException if a remote or network exception occurs

hbase-client/src/main/java/org/apache/hadoop/hbase/protobuf/RequestConverter.java

@@ -461,10 +461,10 @@ public final class RequestConverter {
     builder.setScannerId(scannerId);
     return builder.build();
   }
-  
+
   /**
    * Create a protocol buffer ScanRequest for a scanner id
-   * 
+   *
    * @param scannerId
    * @param numberOfRows
    * @param closeScanner
@@ -1073,7 +1073,7 @@ public final class RequestConverter {
   /**
    * Creates a protocol buffer ModifyTableRequest
    *
-   * @param table
+   * @param tableName
    * @param hTableDesc
    * @return a ModifyTableRequest
    */

hbase-server/src/main/java/org/apache/hadoop/hbase/master/MasterServices.java

@@ -215,14 +215,14 @@ public interface MasterServices extends Server {
   /**
    * Get a namespace descriptor by name
    * @param name name of namespace descriptor
-   * @return
+   * @return A descriptor
    * @throws IOException
    */
   public NamespaceDescriptor getNamespaceDescriptor(String name) throws IOException;
 
   /**
    * List available namespace descriptors
-   * @return
+   * @return A descriptor
    * @throws IOException
    */
   public List<NamespaceDescriptor> listNamespaceDescriptors() throws IOException;
@@ -230,7 +230,7 @@ public interface MasterServices extends Server {
   /**
    * Get list of table descriptors by namespace
    * @param name namespace name
-   * @return
+   * @return A descriptor
    * @throws IOException
    */
   public List<HTableDescriptor> getTableDescriptorsByNamespace(String name) throws IOException;

hbase-server/src/main/java/org/apache/hadoop/hbase/master/TableNamespaceManager.java

@@ -51,7 +51,7 @@ import org.apache.hadoop.hbase.util.FSUtils;
 
 /**
  * This is a helper class used to manage the namespace
- * metadata that is stored in {@see HConstants.NAMESPACE_TABLE_NAME}
+ * metadata that is stored in TableName.NAMESPACE_TABLE_NAME
  * It also mirrors updates to the ZK store by forwarding updates to
  * {@link org.apache.hadoop.hbase.ZKNamespaceManager}
  */

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

@@ -1136,7 +1136,6 @@ public abstract class FSUtils {
    * the table directory under
    * path rootdir
    *
-   * @param rootdir qualified path of HBase root directory
    * @param tablePath path of table
    * @return {@link org.apache.hadoop.fs.Path} for table
    */