From: JinYong Park <j4939.park@samsung.com>
Date: Thu, 26 Oct 2017 08:35:41 +0000 (+0900)
Subject: add doxygen description from upstream
X-Git-Tag: accepted/tizen/unified/20171102.061557~8
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=refs%2Fchanges%2F94%2F157794%2F4;p=platform%2Fupstream%2Felementary.git

add doxygen description from upstream

Change-Id: I7b9bc81bb9f71973046b2e358cc520fa69c85305
Signed-off-by: JinYong Park <j4939.park@samsung.com>
---

diff --git a/src/lib/elm_box.eo b/src/lib/elm_box.eo
index b1aca07..3ea3d9d 100644
--- a/src/lib/elm_box.eo
+++ b/src/lib/elm_box.eo
@@ -168,7 +168,7 @@ class Elm.Box (Elm.Widget)
               \@elseif WEARABLE \@since_tizen 2.3.1
               \@endif
             ]]
-            return: free(own(list<Evas.Object*>*), eina_list_free) @warn_unused;
+            return: free(own(list<Evas.Object*>*), eina_list_free) @warn_unused; [[List of children]]
          }
       }
       pack_end {
diff --git a/src/lib/elm_calendar.eo b/src/lib/elm_calendar.eo
index decd995..44baed4 100644
--- a/src/lib/elm_calendar.eo
+++ b/src/lib/elm_calendar.eo
@@ -365,7 +365,7 @@ class Elm.Calendar (Elm.Layout, Elm_Interface_Atspi_Widget_Action)
               \@if MOBILE \@since_tizen 2.4
               \@endif
             ]]
-            return: const(list<Elm.Calendar.Mark*>)*;
+            return: const(list<Elm.Calendar.Mark*>)*; [[List with all calendar marks]]
          }
       }
       selected_time_set {
@@ -452,7 +452,7 @@ class Elm.Calendar (Elm.Layout, Elm_Interface_Atspi_Widget_Action)
             * elm_calendar_marks_draw(cal);
             * @endcode
             */
-         return: Elm_Calendar_Mark *;
+         return: Elm_Calendar_Mark *; [[The newly added calendar mark]]
          params {
             @in mark_type: const(char)*; [[A string used to define the type of mark. It will be
             emitted to the theme, that should display a related modification on these
diff --git a/src/lib/elm_colorselector_common.h b/src/lib/elm_colorselector_common.h
index 29f2076..0c74d4d 100644
--- a/src/lib/elm_colorselector_common.h
+++ b/src/lib/elm_colorselector_common.h
@@ -23,6 +23,11 @@ struct _Elm_Custom_Palette
 /* TIZEN_ONLY(20160705): Move Elm_Colorselector_Mode enum to
                          elm_colorselector_common.h to mark enum members
                          as deprecated. */
+/**
+ * @brief Different modes supported by Colorselector
+ *
+ * See also @ref elm_colorselector_mode_set, @ref elm_colorselector_mode_get.
+ */
 typedef enum
 {
    ELM_COLORSELECTOR_PALETTE = 0, /**< Only color palette is displayed, default */
diff --git a/src/lib/elm_config.c b/src/lib/elm_config.c
index 075fa3f..72804a1 100644
--- a/src/lib/elm_config.c
+++ b/src/lib/elm_config.c
@@ -2669,11 +2669,11 @@ elm_config_language_auto_mirrored_get(void)
 }
 
 EAPI void
-elm_config_language_auto_mirrored_set(Eina_Bool automatic)
+elm_config_language_auto_mirrored_set(Eina_Bool auto_mirrored)
 {
-   automatic = !!automatic;
-   if (_elm_config->language_auto_mirrored == automatic) return;
-   _elm_config->language_auto_mirrored = automatic;
+   auto_mirrored = !!auto_mirrored;
+   if (_elm_config->language_auto_mirrored == auto_mirrored) return;
+   _elm_config->language_auto_mirrored = auto_mirrored;
    _elm_rescale();
 }
 //
diff --git a/src/lib/elm_config.h b/src/lib/elm_config.h
index efd618c..5519338 100644
--- a/src/lib/elm_config.h
+++ b/src/lib/elm_config.h
@@ -802,11 +802,11 @@ EAPI double       elm_config_scroll_thumbscroll_smooth_amount_get(void);
  * Scrolling with your finger can be smoothed out and the amount to smooth
  * is determined by this parameter. 0.0 means to not smooth at all and
  * 1.0 is to smoth as much as possible.
- * 
- * @param the amount to smooth from 0.0 to 1.0 with 0.0 being none
+ *
+ * @param amount the amount to smooth from 0.0 to 1.0 with 0.0 being none
  *
  * @see elm_config_thumbscroll_acceleration_threshold_set()
- * 
+ *
  * @since 1.16
  * @ingroup Elm_Scrolling
  *
@@ -2250,7 +2250,7 @@ EAPI Eina_Bool elm_config_language_auto_mirrored_get(void);
  * Set the system auto mirrored mode.
  * This determines whether the mirrored mode is determined automatically by the locale or not.
  *
- * @param mirrored @c EINA_TRUE to set auto mirrored mode, @c EINA_FALSE to unset it.
+ * @param auto_mirrored @c EINA_TRUE to set auto mirrored mode, @c EINA_FALSE to unset it.
  *
  * @since_tizen 4.0
  */