javadoc warnings

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

src/main/java/org/apache/hadoop/hbase/regionserver/HRegionServer.java

@@ -1350,7 +1350,7 @@ public class HRegionServer implements HRegionInterface, HBaseRPCErrorHandler,
 
   /**
    * Return a reference to the metrics instance used for counting RPC calls.
-   * @return
+   * @return Metrics instance.
    */
   public HBaseRpcMetrics getRpcMetrics() {
     return server.getRpcMetrics();

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

@@ -125,7 +125,7 @@ public abstract class User {
    *
    * <p><strong>This is only applicable when
    * running on secure Hadoop</strong> -- see
-   * {@link org.apache.hadoop.security.SecurityUtil#login(Configuration,String,String,String)}.
+   * org.apache.hadoop.security.SecurityUtil#login(Configuration,String,String,String).
    * On regular Hadoop (without security features), this will safely be ignored.
    * </p>
    *

src/main/xslt/configuration_to_docbook_section.xsl

@@ -40,7 +40,7 @@ version="5.0" xmlns="http://docbook.org/ns/docbook"
 <glossary xmlns='http://docbook.org/ns/docbook' xml:id="hbase.default.configuration">
 <title>HBase Default Configuration</title>
 <para>
-This documentation is generated using the default hbase configuration file,
+The documentation below is generated using the default hbase configuration file,
 <filename>hbase-default.xml</filename>, as source.
 </para>