ICU-4053 Fix some doxygen warnings.

X-SVN-Rev: 16719

icu4c/source/common/unicode/docmain.h

@@ -166,7 +166,7 @@
  *   </tr>
  *   <tr>
  *     <td>Regular Expressions</td>
- *     <td>N/A</td>
+ *     <td>uregex.h</td>
  *     <td>RegexPattern, RegexMatcher</td>
  *   </tr>
  *   <tr>

icu4c/source/common/unicode/unistr.h

@@ -1431,13 +1431,13 @@ public:
    * @param startLength the number of characters to extract
    * @param target the target buffer for extraction, can be NULL
    *               if targetLength is 0
-   * @param targetLength the length of the target buffer
+   * @param targetCapacity the length of the target buffer
    * @param inv Signature-distinguishing paramater, use US_INV.
    * @return the output string length, not including the terminating NUL
    * @draft ICU 3.2
    */
   int32_t extract(int32_t start,
-           int32_t length,
+           int32_t startLength,
            char *target,
            int32_t targetCapacity,
            enum EInvariant inv) const;

icu4c/source/common/unicode/uset.h

@@ -387,7 +387,7 @@ uset_removeString(USet* set, const UChar* str, int32_t strLen);
  * set so that its value is the <i>asymmetric set difference</i> of
  * the two sets.
  * @param set the object from which the elements are to be removed
- * @param remove the object that defines which elements will be
+ * @param removeSet the object that defines which elements will be
  * removed from this set
  * @draft ICU 3.2
  */

icu4c/source/i18n/unicode/rbnf.h

@@ -531,7 +531,7 @@ public:
      * with the first String being the ULocale ID, and the remaining
      * Strings being the localizations of the rule set names, in the
      * same order as the initial array.  Arrays are NULL-terminated.
-     * @param description A description of the formatter's desired behavior.
+     * @param rules A description of the formatter's desired behavior.
      * See the class documentation for a complete explanation of the description
      * syntax.
      * @param localizations the localization information.
@@ -683,7 +683,8 @@ public:
   /**
    * Return the index'th display name locale.
    * @param index the index of the locale
-   * @param return the locale
+   * @param status set to a failure code when this function fails
+   * @return the locale
    * @see #getNumberOfRuleSetDisplayNameLocales
    * @draft ICU 3.2
    */

icu4c/source/i18n/unicode/uregex.h

@@ -13,6 +13,13 @@
 *   ICU Regular Expressions, API for C
 */
 
+/**
+ * \file
+ * \brief C API: Regular Expressions
+ *
+ * <p>This is a C wrapper around the C++ RegexPattern and RegexMatcher classes.</p>
+ */
+
 #ifndef UREGEX_H
 #define UREGEX_H
 

icu4c/source/i18n/unicode/utmscale.h

@@ -416,7 +416,7 @@ typedef enum UTimeScaleValue {
  * 
  * @param timeScale The time scale
  * @param value A constant representing the value to get
- * 
+ * @param status The status code. Set to <code>U_ILLEGAL_ARGUMENT_ERROR</code> if arguments are invalid.
  * @return - the value.
  * 
  * @draft ICU 3.2
@@ -445,7 +445,7 @@ U_DRAFT int64_t U_EXPORT2
 /**
  * Convert a datetime from the universal time scale to a <code>int64_t</code> in the given time scale.
  *
- * @param universal The datetime in the universal time scale
+ * @param universalTime The datetime in the universal time scale
  * @param timeScale The time scale to convert to
  * @param status The status code. Set to <code>U_ILLEGAL_ARGUMENT_ERROR</code> if the conversion is out of range.
  *