HADOOP-8269. Fix some javadoc warnings on branch-1. Contributed by Eli Collins

git-svn-id: https://svn.apache.org/repos/asf/hadoop/common/branches/branch-1@1325057 13f79535-47bb-0310-9956-ffa450edef68

CHANGES.txt

@@ -214,6 +214,8 @@ Release 1.1.0 - unreleased
     MAPREDUCE-4003. log.index (No such file or directory) AND Task process 
     exit with nonzero status of 126. (Koji Noguchi via tgraves)
 
+    HADOOP-8269. Fix some javadoc warnings on branch-1.
+
 Release 1.0.3 - unreleased
 
   NEW FEATURES

src/core/org/apache/hadoop/net/DNS.java

@@ -119,7 +119,7 @@ public class DNS {
   }
 
   /**
-   * Like {@link DNS#getIPs(String, boolean), but returns all
+   * Like {@link DNS#getIPs(String, boolean)}, but returns all
    * IPs associated with the given interface and its subinterfaces.
    */
   public static String[] getIPs(String strInterface)

src/core/org/apache/hadoop/net/NetUtils.java

@@ -486,7 +486,7 @@ public class NetUtils {
    * also takes a local address and port to bind the socket to. 
    * 
    * @param socket
-   * @param address the remote address
+   * @param endpoint the remote address
    * @param localAddr the local address to bind the socket to
    * @param timeout timeout in milliseconds
    */

src/core/org/apache/hadoop/util/StringUtils.java

@@ -737,7 +737,7 @@ public class StringUtils {
    * Concatenates objects, using a separator.
    *
    * @param separator to join with
-   * @param object to join
+   * @param objects to join
    * @return the joined string
    */
   public static String join(CharSequence separator, Object[] objects) {

src/mapred/org/apache/hadoop/mapreduce/lib/partition/KeyFieldBasedComparator.java

@@ -44,8 +44,8 @@ import org.apache.hadoop.mapreduce.lib.partition.KeyFieldHelper.KeyDescription;
  *  character. If '.c' is omitted from pos1, it defaults to 1 (the beginning
  *  of the field); if omitted from pos2, it defaults to 0 (the end of the
  *  field). opts are ordering options (any of 'nr' as described above). 
- * We assume that the fields in the key are separated by 
- * {@link JobContext#MAP_OUTPUT_KEY_FIELD_SEPERATOR}.
+ * We assume that the fields in the key are separated by
+ * mapreduce.map.output.key.field.separator.
  */
 @InterfaceAudience.Public
 @InterfaceStability.Stable