Make ImmutablePair final; Minor fixes

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/lang/trunk@1127544 13f79535-47bb-0310-9956-ffa450edef68

src/main/java/org/apache/commons/lang3/tuple/ImmutablePair.java

@@ -26,13 +26,13 @@
  * 
  * <p>#ThreadSafe# if the objects are threadsafe</p>
  *
- * @param <L> the first element type
- * @param <R> the second element type
+ * @param <L> the left element type
+ * @param <R> the right element type
  *
  * @since Lang 3.0
  * @version $Id$
  */
-public class ImmutablePair<L, R> extends Pair<L, R> {
+public final class ImmutablePair<L, R> extends Pair<L, R> {
 
     /** Serialization version */
     private static final long serialVersionUID = 4954918890077093841L;

src/main/java/org/apache/commons/lang3/tuple/MutablePair.java

@@ -21,8 +21,8 @@
  * 
  * <p>Not #ThreadSafe#</p>
  *
- * @param <L> the first element type
- * @param <R> the second element type
+ * @param <L> the left element type
+ * @param <R> the right element type
  *
  * @since Lang 3.0
  * @version $Id$
@@ -82,7 +82,7 @@ public L getLeft() {
     }
 
     /**
-     * Set the left element of the pair.
+     * Sets the left element of the pair.
      * 
      * @param left  the new value of the left element, may be null
      */
@@ -99,9 +99,9 @@ public R getRight() {
     }
 
     /**
-     * Set the right element of the pair.
+     * Sets the right element of the pair.
      * 
-     * @param right  the value of the right element
+     * @param right  the new value of the right element, may be null
      */
     public void setRight(R right) {
         this.right = right;

src/main/java/org/apache/commons/lang3/tuple/Pair.java

@@ -36,8 +36,8 @@
  * However, there is no restriction on the type of the stored objects that may be stored.
  * If mutable objects are stored in the pair, then the pair itself effectively becomes mutable.</p>
  *
- * @param <L> the first element type
- * @param <R> the second element type
+ * @param <L> the left element type
+ * @param <R> the right element type
  *
  * @since Lang 3.0
  * @version $Id$
@@ -113,7 +113,7 @@ public R getValue() {
 
     //-----------------------------------------------------------------------
     /**
-     * <p>Compares the pair based on the first element followed by the second element.
+     * <p>Compares the pair based on the left element followed by the right element.
      * The types must be {@code Comparable}.</p>
      * 
      * @param other  the other pair, not null