From: Woochan Lee <wc0917.lee@samsung.com>
Date: Tue, 24 Oct 2017 07:31:08 +0000 (+0900)
Subject: Fix documentation warning.
X-Git-Tag: accepted/tizen/unified/20171027.152008~3
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=835ccd105927f9e5b01dc44f0fe7cde3e5289928;p=platform%2Fupstream%2Felementary.git

Fix documentation warning.

@tizen_fix

Change-Id: I4ad34b704f64e3382ca6d52852715c5a16f1c844
---

diff --git a/src/lib/elm_flip.eo b/src/lib/elm_flip.eo
index 02ad9a1..4e838f4 100644
--- a/src/lib/elm_flip.eo
+++ b/src/lib/elm_flip.eo
@@ -1,28 +1,29 @@
 enum Elm.Flip.Mode
 {
-   [[]]
+   [[Elm flip mode]]
    legacy: elm_flip;
-   rotate_y_center_axis,
-   rotate_x_center_axis,
-   rotate_xz_center_axis,
-   rotate_yz_center_axis,
-   cube_left,
-   cube_right,
-   cube_up,
-   cube_down,
-   page_left,
-   page_right,
-   page_up,
-   page_down
+   rotate_y_center_axis, [[Rotate Y center axis flip mode]]
+   rotate_x_center_axis, [[Rotate X center axis flip mode]]
+   rotate_xz_center_axis, [[Rotate XZ center axis flip mode]]
+   rotate_yz_center_axis, [[Rotate YZ center axis flip mode]]
+   cube_left, [[Cube left flip mode]]
+   cube_right, [[Cube right flip mode]]
+   cube_up, [[Cube up flip mode]]
+   cube_down, [[Cube down flip mode]]
+   page_left, [[Page left flip mode]]
+   page_right, [[Page right flip mode]]
+   page_up, [[Page up flip mode]]
+   page_down, [[Page down flip mode]]
 }
 
 enum Elm.Flip.Interaction
 {
-   [[]]
-   none,
-   rotate,
-   cube,
-   page
+   [[Elm flip flip interaction]]
+   none, [[No interaction]]
+   rotate, [[Rotate interaction]]
+   cube, [[Cube interaction]]
+   page [[Page interaction]]
+
 }
 
 enum Elm.Flip.Direction
@@ -48,7 +49,7 @@ class Elm.Flip (Elm.Container)
               and cause it to flip). By default a flip is not interactive.
               You may also need to set which sides of the flip are "active"
               for flipping and how much space they use (a minimum of a
-              finger size) with \@ref @.interaction_direction_enabled_set
+              finger size) with @.interaction_direction_enabled_set
               and @.interaction_direction_hitsize_set.
 
               The four available mode of interaction are
diff --git a/src/lib/elm_flipselector.eo b/src/lib/elm_flipselector.eo
index d93d3de..b69216e 100644
--- a/src/lib/elm_flipselector.eo
+++ b/src/lib/elm_flipselector.eo
@@ -68,7 +68,7 @@ class Elm.Flipselector (Elm.Layout, Elm_Interface_Atspi_Widget_Action,
               \@if MOBILE \@since_tizen 2.4
               \@endif
             ]]
-            return: const(list<Elm.Object.Item*>)*;
+            return: const(list<Elm.Object.Item*>)*; [[List of items]]
          }
       }
       @property first_item {
@@ -141,7 +141,7 @@ class Elm.Flipselector (Elm.Layout, Elm_Interface_Atspi_Widget_Action,
            \@if MOBILE \@since_tizen 2.4
            \@endif
          ]]
-         return: Elm.Widget_Item *;
+         return: Elm.Widget_Item *; [[Handle to prepended item]]
          params {
             @in label: const(char)*; [[The (text) label of the new item.]]
             @in func: Evas_Smart_Cb @optional; [[Convenience callback function to take place when
@@ -182,7 +182,7 @@ class Elm.Flipselector (Elm.Layout, Elm_Interface_Atspi_Widget_Action,
            \@if MOBILE \@since_tizen 2.4
            \@endif
          ]]
-         return: Elm.Widget_Item *;
+         return: Elm.Widget_Item *; [[Handle to appended item]]
          params {
             @in label: const(char)*; [[The (text) label of the new item.]]
             @in func: Evas_Smart_Cb @optional; [[Convenience callback function to take place when
diff --git a/src/lib/elm_focus_item.h b/src/lib/elm_focus_item.h
index 09fadc6..b5b262b 100644
--- a/src/lib/elm_focus_item.h
+++ b/src/lib/elm_focus_item.h
@@ -9,8 +9,7 @@
  * The focused item can be unfocused with function
  * elm_object_item_focus_set().
  *
- * see @elm_object_item_focus_set()
- * see @elm_object_item_focus_get()
+ * @see elm_object_item_focus_set(), elm_object_item_focus_get()
  *
  * @ingroup Elm_Focus
  * @since 1.10