From a7b2b6fdc0ce67fb2eb1e96c139e64ea07470110 Mon Sep 17 00:00:00 2001
From: Stefan Schmidt <stefan@osg.samsung.com>
Date: Thu, 24 Nov 2016 15:12:20 +0100
Subject: [PATCH] docs: elm: fill gaps in button, color, combobox and
 conformant eo file documentation

---
 src/lib/elementary/elm_button_internal_part.eo |  1 +
 src/lib/elementary/elm_color_item.eo           |  9 +++++----
 src/lib/elementary/elm_combobox.eo             | 15 ++++++++-------
 src/lib/elementary/elm_conformant.eo           | 10 +++++-----
 4 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/src/lib/elementary/elm_button_internal_part.eo b/src/lib/elementary/elm_button_internal_part.eo
index 99b57dd6be..fb1e59866f 100644
--- a/src/lib/elementary/elm_button_internal_part.eo
+++ b/src/lib/elementary/elm_button_internal_part.eo
@@ -1,5 +1,6 @@
 class Elm.Button.Internal.Part (Elm.Layout.Internal.Part)
 {
+   [[Elementary button internal part class]]
    data: null;
    implements {
       Efl.Container.content.set;
diff --git a/src/lib/elementary/elm_color_item.eo b/src/lib/elementary/elm_color_item.eo
index 00928c379f..0ce92942f2 100644
--- a/src/lib/elementary/elm_color_item.eo
+++ b/src/lib/elementary/elm_color_item.eo
@@ -1,5 +1,6 @@
 class Elm.Color.Item(Elm.Widget.Item)
 {
+   [[Elementary color item class]]
    legacy_prefix: elm_color_item;
    eo_prefix: elm_obj_color_item;
    methods {
@@ -11,10 +12,10 @@ class Elm.Color.Item(Elm.Widget.Item)
             [[Set Palette item's color.]]
          }
          values {
-            r: int; [[red-value of color]]
-            g: int; [[green-value of color]]
-            b: int; [[blue-value of color]]
-            a: int; [[alpha-value of color]]
+            r: int; [[Red-value of color]]
+            g: int; [[Green-value of color]]
+            b: int; [[Blue-value of color]]
+            a: int; [[Alpha-value of color]]
          }
       }
       @property selected {
diff --git a/src/lib/elementary/elm_combobox.eo b/src/lib/elementary/elm_combobox.eo
index 9302421fd5..6107f07673 100644
--- a/src/lib/elementary/elm_combobox.eo
+++ b/src/lib/elementary/elm_combobox.eo
@@ -2,6 +2,7 @@ class Elm.Combobox (Elm.Button, Efl.Ui.Selectable,
                     Elm.Interface.Atspi_Widget_Action,
                     Elm.Entry, Elm.Genlist, Elm.Hover)
 {
+   [[Elementary combobox class]]
    legacy_prefix: elm_combobox;
    eo_prefix: elm_obj_combobox;
    event_prefix: elm_combobox;
@@ -15,7 +16,7 @@ class Elm.Combobox (Elm.Button, Efl.Ui.Selectable,
 
               @since 1.17
             ]]
-            return: bool;
+            return: bool; [[$true if combobox is expenaded, $false otherwise]]
          }
       }
       hover_begin {
@@ -50,11 +51,11 @@ class Elm.Combobox (Elm.Button, Efl.Ui.Selectable,
       Elm.Interface.Atspi_Widget_Action.elm_actions.get;
    }
    events {
-      dismissed;
-      expanded;
-      clicked;
-      item,selected;
-      item,pressed;
-      filter,done;
+      dismissed; [[Called when combobox was dismissed]]
+      expanded; [[Called when combobox was expanded]]
+      clicked; [[Called when combobox was clicked]]
+      item,selected; [[Called when combobox item was selected]]
+      item,pressed; [[Called when combobox item was pressed]]
+      filter,done; [[Called when combobox filter was done]]
    }
 }
diff --git a/src/lib/elementary/elm_conformant.eo b/src/lib/elementary/elm_conformant.eo
index 73cb09f5fd..e257183cfa 100644
--- a/src/lib/elementary/elm_conformant.eo
+++ b/src/lib/elementary/elm_conformant.eo
@@ -1,5 +1,6 @@
 class Elm.Conformant (Elm.Layout)
 {
+   [[Elementary conformant class]]
    legacy_prefix: elm_conformant;
    eo_prefix: elm_obj_conformant;
    event_prefix: elm_conformant;
@@ -13,10 +14,9 @@ class Elm.Conformant (Elm.Layout)
       Elm.Layout.content_aliases.get;
    }
    events {
-      virtualkeypad,state,on;
-      virtualkeypad,state,off;
-      clipboard,state,on;
-      clipboard,state,off;
+      virtualkeypad,state,on; [[Called when virtualkeypad was enabled]]
+      virtualkeypad,state,off; [[Called when virtualkeypad was disabled]]
+      clipboard,state,on; [[Called when clipboard was enabled]]
+      clipboard,state,off; [[Called when clipboard was disabled]]
    }
-
 }