[Base-utils][AlphabeticIndex][Measure] Fix Doxygen docs 11/83011/3 accepted/tizen/common/20160817.133137 submit/tizen/20160817.050926
authorJakub Siewierski <j.siewierski@samsung.com>
Mon, 8 Aug 2016 12:47:48 +0000 (14:47 +0200)
committerHyunjee Kim <hj0426.kim@samsung.com>
Wed, 17 Aug 2016 05:04:18 +0000 (14:04 +0900)
Fix Doxygen group for Alphabetic Index
Remove Doxygen warnings for Measure and Alphabetic Index
Other fixes

Change-Id: If2afd0c32caad842d06fe7a9fa159149fe4a639b
Signed-off-by: Jakub Siewierski <j.siewierski@samsung.com>
Signed-off-by: Hyunjee Kim <hj0426.kim@samsung.com>
17 files changed:
src/include/mobile/utils_i18n.h
src/include/mobile/utils_i18n_alpha_idx.h
src/include/mobile/utils_i18n_field_position.h
src/include/mobile/utils_i18n_format.h
src/include/mobile/utils_i18n_formattable.h
src/include/mobile/utils_i18n_measure_format.h
src/include/mobile/utils_i18n_types.h
src/include/mobile/utils_i18n_ulocale.h
src/include/mobile/utils_i18n_ustring.h
src/include/wearable/utils_i18n.h
src/include/wearable/utils_i18n_alpha_idx.h
src/include/wearable/utils_i18n_field_position.h
src/include/wearable/utils_i18n_format.h
src/include/wearable/utils_i18n_formattable.h
src/include/wearable/utils_i18n_measure_format.h
src/include/wearable/utils_i18n_types.h
src/include/wearable/utils_i18n_ulocale.h

index 63d9a12..aedf168 100644 (file)
@@ -161,11 +161,11 @@ extern "C" {
  *       <td>The Measure Format module represents a formatter for measure objects.</td>
  * </tr>
  * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_FIELD_POSITION</td>
+ *       <td>@ref CAPI_BASE_UTILS_I18N_FIELD_POSITION_MODULE</td>
  *       <td>The Field Position module is used to identify fields in a formatted output.</td>
  * </tr>
  * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_PARSE_POSITION</td>
+ *       <td>@ref CAPI_BASE_UTILS_I18N_PARSE_POSITION_MODULE</td>
  *       <td>The Parse Position module used by Format and its subclasses to keep track of the current position during parsing.</td>
  * </tr>
  * </table>
@@ -2120,7 +2120,7 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_get_available_types</td>
+ *       <td>#i18n_measure_unit_foreach_available_type</td>
  *       <td>getAvailableTypes</td>
  * </tr>
  * <tr>
@@ -2155,11 +2155,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_revolution_angle</td>
- *       <td>createRevolutionAngle</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_acre</td>
  *       <td>createAcre</td>
  * </tr>
@@ -2210,26 +2205,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_milligram_per_deciliter</td>
- *       <td>createMilligramPerDeciliter</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_millimole_per_liter</td>
- *       <td>createMillimolePerLiter</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_part_per_million</td>
- *       <td>createPartPerMillion</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_liter_per_100_kilometers</td>
- *       <td>createLiterPer100Kilometers</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_liter_per_kilometer</td>
  *       <td>createLiterPerKilometer</td>
  * </tr>
@@ -2240,11 +2215,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_mile_per_gallon_imperial</td>
- *       <td>createMilePerGallonImperial</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_bit</td>
  *       <td>createBit</td>
  * </tr>
@@ -2284,7 +2254,6 @@ extern "C" {
  *       <td>createMegabyte</td>
  * </tr>
  * <tr>
- * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_terabit</td>
  *       <td>createTerabit</td>
@@ -2296,11 +2265,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_century</td>
- *       <td>createCentury</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_day</td>
  *       <td>createDay</td>
  * </tr>
@@ -2481,11 +2445,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_mile_scandinavian</td>
- *       <td>createMileScandinavian</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_millimeter</td>
  *       <td>createMillimeter</td>
  * </tr>
@@ -2636,11 +2595,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_knot</td>
- *       <td>createKnot</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_meter_per_second</td>
  *       <td>createMeterPerSecond</td>
  * </tr>
@@ -2661,11 +2615,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_generic_temperature</td>
- *       <td>createGenericTemperature</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_kelvin</td>
  *       <td>createKelvin</td>
  * </tr>
@@ -2726,11 +2675,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_cup_metric</td>
- *       <td>createCupMetric</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_deciliter</td>
  *       <td>createDeciliter</td>
  * </tr>
@@ -2746,11 +2690,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_gallon_imperial</td>
- *       <td>createGallonImperial</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_hectoliter</td>
  *       <td>createHectoliter</td>
  * </tr>
@@ -2776,11 +2715,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_pint_metric</td>
- *       <td>createPintMetric</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_quart</td>
  *       <td>createQuart</td>
  * </tr>
index dffeaf5..b3f3022 100644 (file)
@@ -219,7 +219,7 @@ const void *i18n_alpha_idx_get_record_data(i18n_alpha_idx_h index);
 /**
  * @brief Gets the default label used for abbreviated buckets between other index characters.
  * @details For example, consider the labels when Latin and Greek are used:
- *          X Y Z ... &#x0391; &#x0392; &#x0393;
+ *          X Y Z ... &\#x0391; &\#x0392; &\#x0393;
  * @since_tizen 3.0
  * @remarks The obtained @a label should be released by the caller with the free() function.
  *
index 62c639f..0fe580c 100644 (file)
@@ -185,7 +185,7 @@ int i18n_field_position_set_begin_index(i18n_field_position_h field_position, in
  * @since_tizen 3.0
  *
  * @param[in] field_position  The field_position object
- * @param[in] end_position    The new value of the end index
+ * @param[in] end_index       The new value of the end index
  *
  * @return @c 0 on success, otherwise a negative error value
  * @retval #I18N_ERROR_NONE Successful
index 202eb98..9390cac 100644 (file)
@@ -90,7 +90,7 @@ int i18n_format_clone(i18n_format_h format, i18n_format_h *clone);
  *
  * @param[in] format         The format object
  * @param[in] formattable    The object to format
- * @param[in/out] append_to  An output parameter to receive the result.
+ * @param[out] append_to     An input/output parameter to receive the result.
  *                           The result is appended to the existing contents.
  *
  * @return @c 0 on success, otherwise a negative error value
@@ -108,9 +108,9 @@ int i18n_format_format(i18n_format_h format, i18n_formattable_h formattable, cha
  *
  * @param[in] format              The format object
  * @param[in] formattable         The object to format
- * @param[in/out] append_to       Output parameter to receive the result.
+ * @param[out] append_to          Input/output parameter to receive the result.
  *                                The result is appended to the existing contents.
- * @param[in/out] field_position  On input: an alignment field, if desired.
+ * @param[out] field_position     On input: an alignment field, if desired.
  *                                On output: the offsets of the alignment field.
  *
  * @return @c 0 on success, otherwise a negative error value
@@ -145,7 +145,7 @@ int i18n_format_parse_object(i18n_format_h format, const char *source, i18n_form
  *
  * @param[in] format              The format object
  * @param[in] source              The string to be parsed into an object
- * @param[in/out] parse_position  The position to start parsing at. Upon return this parameter is set
+ * @param[out] parse_position     The position to start parsing at. Upon return this parameter is set
  *                                to the position after the last character successfully parsed. If the source
  *                                is not parsed successfully, this parameter will remain unchanged.
  * @param[out] result             The formattable object to be set to the parse result.
index 7ad3aa9..b8e3286 100644 (file)
@@ -272,12 +272,12 @@ int i18n_formattable_get_int64(i18n_formattable_h formattable, int64_t *value);
 /**
  * @brief Gets the long value of the given formattable object.
  * @details If the magnitude is too large to fit in a long, then the maximum or
- *          minimum long value, as appropriate, is set to @value variable and
- *          the #I18N_ERROR_INVALID_FORMAT error code is returned by the
+ *          minimum long value, as appropriate, is set to @a value
+ *          and the #I18N_ERROR_INVALID_FORMAT error code is returned by the
  *          function.
  * @since_tizen 3.0
  *
- * @param[in] formattable  A handle to the formattable object
+ * @param[in] formattable   A handle to the formattable object
  * @param[out] value        A pointer to a int32_t variable which will be filled
  *                          with the value obtained from the given formattable object
  *
index 823752c..827699f 100644 (file)
@@ -103,10 +103,10 @@ int i18n_measure_format_clone(i18n_measure_format_h measure_format, i18n_format_
  *
  * @param[in]  measure_format  The format object
  * @param[in]  formattable     The object to format
- * @param[in/out] append_to    Output parameter to receive the result.
+ * @param[out] append_to       Input/output parameter to receive the result.
  *                             The result is appended to the existing contents.
- * @param[in/out]  field_position  On input: an alignment field, if desired.
- *                                 On output: the offsets of the alignment field.
+ * @param[out] field_position  On input: an alignment field, if desired.
+ *                             On output: the offsets of the alignment field.
  *
  * @return @c 0 on success, otherwise a negative error value
  * @retval #I18N_ERROR_NONE Successful
@@ -124,7 +124,7 @@ int i18n_measure_format_format(i18n_measure_format_h measure_format, i18n_format
  *
  * @param[in]  measure_format      The format object
  * @param[in]  source              The string to be parsed into an object
- * @param[in/out]  parse_position  The position to start parsing at. Upon return
+ * @param[out]  parse_position     The position to start parsing at. Upon return
  *                                 this parameter is set to the position after the
  *                                 last character successfully parsed. If the
  *                                 source is not parsed successfully, this parameter
index e9bbd1f..ab709d6 100644 (file)
@@ -2930,11 +2930,11 @@ typedef bool (*i18n_measure_unit_types_cb)(const char *type_id, void *user_data)
  */
 
 /**
- * @addtogroup CAPI_BASE_UTILS_I18N_ALPHABETIC_INDEX_MODULE
+ * @addtogroup CAPI_BASE_UTILS_I18N_ALPHA_IDX_MODULE
  * @{
  */
 
-/*
+/**
  * @brief The Alphabetic index handle.
  * @since_tizen 3.0
  */
index e12a790..b4078cf 100644 (file)
@@ -641,10 +641,10 @@ int32_t i18n_ulocale_get_keyword_value(const char *locale_id, const char *keywor
  *
  * Below code prints following logs in SDK:
  *
- * Locale and keywords: en_US@abc=12;def=34
- * keyword1: abc
- * keyword2: def
- * Locale: en_US
+ * Locale and keywords: en_US\@abc=12;def=34 \n
+ * keyword1: abc \n
+ * keyword2: def \n
+ * Locale: en_US \n
  * Keyword1 value: 12
  *
  * @code
index e6c0d64..a89153a 100644 (file)
@@ -1161,7 +1161,7 @@ i18n_uchar *i18n_ustring_from_UTF8(i18n_uchar *dest, int32_t dest_capacity, int3
  * A substitution character can be any valid Unicode code point (up to U+10FFFF) except for surrogate code points (U+D800..U+DFFF).
  * The recommended value is U+FFFD "REPLACEMENT CHARACTER".
  * @param[out] num_substitutions Output parameter receiving the number of substitutions if sub_char>=0. Set to 0 if no substitutions occur or sub_char<0. num_substitutions can be NULL.
- * @param[out] error_codeMust be a valid pointer to an error code value,
+ * @param[out] error_code Must be a valid pointer to an error code value,
  * which must not indicate a failure before the function call.
  * @return The pointer to destination buffer.
  * @exception #I18N_ERROR_NONE Success
index 1f2441f..1e2e8bd 100644 (file)
@@ -161,11 +161,11 @@ extern "C" {
  *       <td>The Measure Format module represents a formatter for measure objects.</td>
  * </tr>
  * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_FIELD_POSITION</td>
+ *       <td>@ref CAPI_BASE_UTILS_I18N_FIELD_POSITION_MODULE</td>
  *       <td>The Field Position module is used to identify fields in a formatted output.</td>
  * </tr>
  * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_PARSE_POSITION</td>
+ *       <td>@ref CAPI_BASE_UTILS_I18N_PARSE_POSITION_MODULE</td>
  *       <td>The Parse Position module used by Format and its subclasses to keep track of the current position during parsing.</td>
  * </tr>
  * </table>
@@ -2120,7 +2120,7 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_get_available_types</td>
+ *       <td>#i18n_measure_unit_foreach_available_type</td>
  *       <td>getAvailableTypes</td>
  * </tr>
  * <tr>
@@ -2155,11 +2155,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_revolution_angle</td>
- *       <td>createRevolutionAngle</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_acre</td>
  *       <td>createAcre</td>
  * </tr>
@@ -2210,36 +2205,11 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_milligram_per_deciliter</td>
- *       <td>createMilligramPerDeciliter</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_millimole_per_liter</td>
- *       <td>createMillimolePerLiter</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_part_per_million</td>
- *       <td>createPartPerMillion</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_liter_per_100_kilometers</td>
- *       <td>createLiterPer100Kilometers</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_liter_per_kilometer</td>
  *       <td>createLiterPerKilometer</td>
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_mile_per_gallon</td>
- *       <td>createMilePerGallon</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_mile_per_gallon_imperial</td>
  *       <td>createMilePerGallonImperial</td>
  * </tr>
@@ -2296,11 +2266,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_century</td>
- *       <td>createCentury</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_day</td>
  *       <td>createDay</td>
  * </tr>
@@ -2481,11 +2446,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_mile_scandinavian</td>
- *       <td>createMileScandinavian</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_millimeter</td>
  *       <td>createMillimeter</td>
  * </tr>
@@ -2636,11 +2596,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_knot</td>
- *       <td>createKnot</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_meter_per_second</td>
  *       <td>createMeterPerSecond</td>
  * </tr>
@@ -2661,11 +2616,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_generic_temperature</td>
- *       <td>createGenericTemperature</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_kelvin</td>
  *       <td>createKelvin</td>
  * </tr>
@@ -2726,11 +2676,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_cup_metric</td>
- *       <td>createCupMetric</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_deciliter</td>
  *       <td>createDeciliter</td>
  * </tr>
@@ -2746,11 +2691,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_gallon_imperial</td>
- *       <td>createGallonImperial</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_hectoliter</td>
  *       <td>createHectoliter</td>
  * </tr>
@@ -2776,11 +2716,6 @@ extern "C" {
  * </tr>
  * <tr>
  *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
- *       <td>#i18n_measure_unit_create_pint_metric</td>
- *       <td>createPintMetric</td>
- * </tr>
- * <tr>
- *       <td>@ref CAPI_BASE_UTILS_I18N_MEASURE_UNIT_MODULE</td>
  *       <td>#i18n_measure_unit_create_quart</td>
  *       <td>createQuart</td>
  * </tr>
index 1955f79..937386c 100644 (file)
@@ -219,7 +219,7 @@ const void *i18n_alpha_idx_get_record_data(i18n_alpha_idx_h index);
 /**
  * @brief Gets the default label used for abbreviated buckets between other index characters.
  * @details For example, consider the labels when Latin and Greek are used:
- *          X Y Z ... &#x0391; &#x0392; &#x0393;
+ *          X Y Z ... &\#x0391; &\#x0392; &\#x0393;
  * @since_tizen 2.3.2
  * @remarks The obtained @a label should be released by the caller with the free() function.
  *
index 85a37f1..6909173 100644 (file)
@@ -185,7 +185,7 @@ int i18n_field_position_set_begin_index(i18n_field_position_h field_position, in
  * @since_tizen 2.3.2
  *
  * @param[in] field_position  The field_position object
- * @param[in] end_position    The new value of the end index
+ * @param[in] end_index       The new value of the end index
  *
  * @return @c 0 on success, otherwise a negative error value
  * @retval #I18N_ERROR_NONE Successful
index 335be03..66231e7 100644 (file)
@@ -90,7 +90,7 @@ int i18n_format_clone(i18n_format_h format, i18n_format_h *clone);
  *
  * @param[in] format         The format object
  * @param[in] formattable    The object to format
- * @param[in/out] append_to  An output parameter to receive the result.
+ * @param[out] append_to     An input/output parameter to receive the result.
  *                           The result is appended to the existing contents.
  *
  * @return @c 0 on success, otherwise a negative error value
@@ -108,9 +108,9 @@ int i18n_format_format(i18n_format_h format, i18n_formattable_h formattable, cha
  *
  * @param[in] format              The format object
  * @param[in] formattable         The object to format
- * @param[in/out] append_to       Output parameter to receive the result.
+ * @param[out] append_to          Input/output parameter to receive the result.
  *                                The result is appended to the existing contents.
- * @param[in/out] field_position  On input: an alignment field, if desired.
+ * @param[out] field_position     On input: an alignment field, if desired.
  *                                On output: the offsets of the alignment field.
  *
  * @return @c 0 on success, otherwise a negative error value
@@ -145,7 +145,7 @@ int i18n_format_parse_object(i18n_format_h format, const char *source, i18n_form
  *
  * @param[in] format              The format object
  * @param[in] source              The string to be parsed into an object
- * @param[in/out] parse_position  The position to start parsing at. Upon return this parameter is set
+ * @param[out] parse_position     The position to start parsing at. Upon return this parameter is set
  *                                to the position after the last character successfully parsed. If the source
  *                                is not parsed successfully, this parameter will remain unchanged.
  * @param[out] result             The formattable object to be set to the parse result.
index f091bcb..3d3727d 100644 (file)
@@ -272,12 +272,12 @@ int i18n_formattable_get_int64(i18n_formattable_h formattable, int64_t *value);
 /**
  * @brief Gets the long value of the given formattable object.
  * @details If the magnitude is too large to fit in a long, then the maximum or
- *          minimum long value, as appropriate, is set to @value variable and
- *          the #I18N_ERROR_INVALID_FORMAT error code is returned by the
+ *          minimum long value, as appropriate, is set to @a value
+ *          and the #I18N_ERROR_INVALID_FORMAT error code is returned by the
  *          function.
  * @since_tizen 2.3.2
  *
- * @param[in] formattable  A handle to the formattable object
+ * @param[in] formattable   A handle to the formattable object
  * @param[out] value        A pointer to a int32_t variable which will be filled
  *                          with the value obtained from the given formattable object
  *
index 9bcd4a4..332a995 100644 (file)
@@ -103,10 +103,10 @@ int i18n_measure_format_clone(i18n_measure_format_h measure_format, i18n_format_
  *
  * @param[in]  measure_format  The format object
  * @param[in]  formattable     The object to format
- * @param[in/out] append_to    Output parameter to receive the result.
+ * @param[out] append_to       Input/output parameter to receive the result.
  *                             The result is appended to the existing contents.
- * @param[in/out]  field_position  On input: an alignment field, if desired.
- *                                 On output: the offsets of the alignment field.
+ * @param[out] field_position  On input: an alignment field, if desired.
+ *                             On output: the offsets of the alignment field.
  *
  * @return @c 0 on success, otherwise a negative error value
  * @retval #I18N_ERROR_NONE Successful
@@ -124,7 +124,7 @@ int i18n_measure_format_format(i18n_measure_format_h measure_format, i18n_format
  *
  * @param[in]  measure_format      The format object
  * @param[in]  source              The string to be parsed into an object
- * @param[in/out]  parse_position  The position to start parsing at. Upon return
+ * @param[out]  parse_position     The position to start parsing at. Upon return
  *                                 this parameter is set to the position after the
  *                                 last character successfully parsed. If the
  *                                 source is not parsed successfully, this parameter
index 2a217bd..bd9d3eb 100644 (file)
@@ -2930,11 +2930,11 @@ typedef bool (*i18n_measure_unit_types_cb)(const char *type_id, void *user_data)
  */
 
 /**
- * @addtogroup CAPI_BASE_UTILS_I18N_ALPHABETIC_INDEX_MODULE
+ * @addtogroup CAPI_BASE_UTILS_I18N_ALPHA_IDX_MODULE
  * @{
  */
 
-/*
+/**
  * @brief The Alphabetic index handle.
  * @since_tizen 2.3.2
  */
index e12a790..b4078cf 100644 (file)
@@ -641,10 +641,10 @@ int32_t i18n_ulocale_get_keyword_value(const char *locale_id, const char *keywor
  *
  * Below code prints following logs in SDK:
  *
- * Locale and keywords: en_US@abc=12;def=34
- * keyword1: abc
- * keyword2: def
- * Locale: en_US
+ * Locale and keywords: en_US\@abc=12;def=34 \n
+ * keyword1: abc \n
+ * keyword2: def \n
+ * Locale: en_US \n
  * Keyword1 value: 12
  *
  * @code