Cherry-pick: ticket:12010: Fixed some minor API doc issues.

http://bugs.icu-project.org/trac/changeset/38097

Change-Id: I31c7caf4792298486b5bc4216c99b7d2d2e830e9
diff --git a/icu4j/main/classes/collate/src/com/ibm/icu/text/CollationKey.java b/icu4j/main/classes/collate/src/com/ibm/icu/text/CollationKey.java
index 101ac08..e58fd1f 100644
--- a/icu4j/main/classes/collate/src/com/ibm/icu/text/CollationKey.java
+++ b/icu4j/main/classes/collate/src/com/ibm/icu/text/CollationKey.java
@@ -1,6 +1,6 @@
 /**
 *******************************************************************************
-* Copyright (C) 1996-2014, International Business Machines Corporation and
+* Copyright (C) 1996-2015, International Business Machines Corporation and
 * others. All Rights Reserved.
 *******************************************************************************
 */
@@ -23,7 +23,7 @@
  * <p>Both the method
  * <code>CollationKey.compareTo(CollationKey)</code> and the method
  * <code>Collator.compare(String, String)</code> compare two strings
- * and returns their relative order.  The performance characterictics
+ * and returns their relative order.  The performance characteristics
  * of these two approaches can differ.
  * Note that collation keys are often less efficient than simply doing comparison. 
  * For more details, see the ICU User Guide.
@@ -46,7 +46,7 @@
  * compared only once.</p>
  * 
  * <p>More information about the composition of the bit sequence can
- * be found in the 
+ * be found in the
  * <a href="http://www.icu-project.org/userguide/Collate_ServiceArchitecture.html">
  * user guide</a>.</p>
  *
diff --git a/icu4j/main/classes/collate/src/com/ibm/icu/text/Collator.java b/icu4j/main/classes/collate/src/com/ibm/icu/text/Collator.java
index bb42de2..a68f980 100644
--- a/icu4j/main/classes/collate/src/com/ibm/icu/text/Collator.java
+++ b/icu4j/main/classes/collate/src/com/ibm/icu/text/Collator.java
@@ -35,7 +35,7 @@
 * subclass, RuleBasedCollator, allows customization of the collation
 * ordering by the use of rule sets.</p>
 *
-* <p>A Collator is thread-safe only when frozen. See {{@link #isFrozen()} and {@link Freezable}.
+* <p>A Collator is thread-safe only when frozen. See {@link #isFrozen()} and {@link Freezable}.
 *
 * <p>Following the <a href=http://www.unicode.org>Unicode
 * Consortium</a>'s specifications for the
diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/DateIntervalInfo.java b/icu4j/main/classes/core/src/com/ibm/icu/text/DateIntervalInfo.java
index b841b76..876abd1 100644
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/DateIntervalInfo.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/DateIntervalInfo.java
@@ -41,7 +41,7 @@
  * <P>
  * For power users, who want to create their own date interval patterns,
  * or want to re-set date interval patterns, they could do so by
- * directly creating DateIntervalInfo and manupulating it.
+ * directly creating DateIntervalInfo and manipulating it.
  *
  * <P>
  * Logically, the interval patterns are mappings
@@ -195,7 +195,10 @@
         private final boolean fFirstDateInPtnIsLaterDate;
 
         /**
-         * constructor
+         * Constructs a <code>PatternInfo</code> object.
+         * @param firstPart     The first part of interval pattern.
+         * @param secondPart    The second part of interval pattern.
+         * @param firstDateInPtnIsLaterDate Whether the first date in interval patter is later date or not.
          * @stable ICU 4.0
          */
         public PatternInfo(String firstPart, String secondPart,
@@ -206,7 +209,8 @@
         }
 
         /**
-         * accessor
+         * Returns the first part of interval pattern.
+         * @return The first part of interval pattern.
          * @stable ICU 4.0
          */
         public String getFirstPart() {
@@ -214,7 +218,8 @@
         }
 
         /**
-         * accessor
+         * Returns the second part of interval pattern.
+         * @return The second part of interval pattern.
          * @stable ICU 4.0
          */
         public String getSecondPart() {
@@ -222,7 +227,8 @@
         }
 
         /**
-         * accessor
+         * Returns whether the first date in interval patter is later date or not.
+         * @return Whether the first date in interval patter is later date or not.
          * @stable ICU 4.0
          */
         public boolean firstDateInPtnIsLaterDate() {
@@ -230,7 +236,9 @@
         }
 
         /**
-         * Override equals
+         * Compares the specified object with this <code>PatternInfo</code> for equality.
+         * @param a The object to be compared.
+         * @returns <code>true</code> if the specified object is equal to this <code>PatternInfo</code>.
          * @stable ICU 4.0
          */
         public boolean equals(Object a) {
@@ -244,7 +252,8 @@
         }
 
         /**
-         * Override hashcode
+         * Returns the hash code of this <code>PatternInfo</code>.
+         * @return A hash code value for this object.
          * @stable ICU 4.0
          */
         public int hashCode() {
@@ -814,7 +823,7 @@
 
 
     /**
-     * Boilerplate. Clone this object.
+     * Clone this object.
      * @return     a copy of the object
      * @stable ICU4.0
      */
@@ -873,7 +882,8 @@
 
     
     /**
-     * Boilerplate for Freezable
+     * {@inheritDoc}
+     *
      * @stable ICU 4.0
      */
     public boolean isFrozen() {
@@ -881,7 +891,8 @@
     }
     
     /**
-     * Boilerplate for Freezable
+     * {@inheritDoc}
+     *
      * @stable ICU 4.4
      */
     public DateIntervalInfo freeze() {
@@ -891,7 +902,8 @@
     }
     
     /**
-     * Boilerplate for Freezable
+     * {@inheritDoc}
+     *
      * @stable ICU 4.4
      */
     public DateIntervalInfo cloneAsThawed() {
diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/DateTimePatternGenerator.java b/icu4j/main/classes/core/src/com/ibm/icu/text/DateTimePatternGenerator.java
index 67dc056..a53a69f 100644
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/DateTimePatternGenerator.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/DateTimePatternGenerator.java
@@ -1052,7 +1052,7 @@
     }
 
     /**
-     * Boilerplate for Freezable
+     * {@inheritDoc}
      * @stable ICU 3.6
      */
     public boolean isFrozen() {
@@ -1060,7 +1060,7 @@
     }
 
     /**
-     * Boilerplate for Freezable
+     * {@inheritDoc}
      * @stable ICU 4.4
      */
     public DateTimePatternGenerator freeze() {
@@ -1069,7 +1069,7 @@
     }
 
     /**
-     * Boilerplate for Freezable
+     * {@inheritDoc}
      * @stable ICU 4.4
      */
     public DateTimePatternGenerator cloneAsThawed() {
@@ -1079,7 +1079,8 @@
     }
 
     /**
-     * Boilerplate
+     * Returns a copy of this <code>DateTimePatternGenerator</code> object.
+     * @return A copy of this <code>DateTimePatternGenerator</code> object.
      * @stable ICU 3.6
      */
     @SuppressWarnings("unchecked")