From f742c8488c5f45f1c7161c05052d6e31f5e1ca04 Mon Sep 17 00:00:00 2001
From: Stefan Schmidt <stefan@osg.samsung.com>
Date: Fri, 4 Nov 2016 10:47:46 +0100
Subject: [PATCH] docs: efl_ui*: add docs for interfaces and events

---
 src/lib/evas/canvas/efl_ui_clickable.eo  | 17 +++++++++--------
 src/lib/evas/canvas/efl_ui_draggable.eo  |  3 ++-
 src/lib/evas/canvas/efl_ui_scrollable.eo |  1 +
 src/lib/evas/canvas/efl_ui_selectable.eo |  1 +
 src/lib/evas/canvas/efl_ui_zoomable.eo   |  7 ++++---
 5 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/src/lib/evas/canvas/efl_ui_clickable.eo b/src/lib/evas/canvas/efl_ui_clickable.eo
index 1d977012a6..5cfaa89a35 100644
--- a/src/lib/evas/canvas/efl_ui_clickable.eo
+++ b/src/lib/evas/canvas/efl_ui_clickable.eo
@@ -1,14 +1,15 @@
 interface Efl.Ui.Clickable ()
 {
+   [[Efl UI clickable interface]]
    event_prefix: efl_ui;
    events {
-      clicked;
-      clicked,double;
-      clicked,triple;
-      clicked,right;
-      pressed;
-      unpressed;
-      longpressed;
-      repeated;
+      clicked; [[Called when object was clicked]]
+      clicked,double; [[Called when object received a double click]]
+      clicked,triple; [[Called when object received a triple click]]
+      clicked,right; [[Called when object received a right click]]
+      pressed; [[Called when the object was pressed]]
+      unpressed; [[Called when the object is now longer pressed]]
+      longpressed; [[Called when the object received a longpress]]
+      repeated; [[Called when the object received repeated presses/clicks]]
    }
 }
diff --git a/src/lib/evas/canvas/efl_ui_draggable.eo b/src/lib/evas/canvas/efl_ui_draggable.eo
index d3f7c55903..27a8ff3a89 100644
--- a/src/lib/evas/canvas/efl_ui_draggable.eo
+++ b/src/lib/evas/canvas/efl_ui_draggable.eo
@@ -1,9 +1,10 @@
 interface Efl.Ui.Draggable ()
 {
+   [[Efl UI draggable interface]]
    event_prefix: efl_ui;
    methods {
         @property drag_target {
-             [[Contrtol whether the object's content is changed by drag and drop.
+             [[Control whether the object's content is changed by drag and drop.
 
                If $drag_target is true, the object can be target of dragging
                object and the content of this object can be changed into
diff --git a/src/lib/evas/canvas/efl_ui_scrollable.eo b/src/lib/evas/canvas/efl_ui_scrollable.eo
index c356492efb..7de6a85c89 100644
--- a/src/lib/evas/canvas/efl_ui_scrollable.eo
+++ b/src/lib/evas/canvas/efl_ui_scrollable.eo
@@ -1,5 +1,6 @@
 interface Efl.Ui.Scrollable ()
 {
+   [[Efl UI scrollable interface]]
    event_prefix: efl_ui;
    events {
       scroll;
diff --git a/src/lib/evas/canvas/efl_ui_selectable.eo b/src/lib/evas/canvas/efl_ui_selectable.eo
index b2421e34c3..16b6a8847a 100644
--- a/src/lib/evas/canvas/efl_ui_selectable.eo
+++ b/src/lib/evas/canvas/efl_ui_selectable.eo
@@ -1,5 +1,6 @@
 interface Efl.Ui.Selectable ()
 {
+   [[Efl UI selectable interface]]
    event_prefix: efl_ui;
    events {
       selected;
diff --git a/src/lib/evas/canvas/efl_ui_zoomable.eo b/src/lib/evas/canvas/efl_ui_zoomable.eo
index 325948dcfb..ae315c6639 100644
--- a/src/lib/evas/canvas/efl_ui_zoomable.eo
+++ b/src/lib/evas/canvas/efl_ui_zoomable.eo
@@ -1,9 +1,10 @@
 interface Efl.Ui.Zoomable ()
 {
+   [[Efl UI zoomable interface]]
    event_prefix: efl_ui;
    events {
-      zoom,start;
-      zoom,stop;
-      zoom,change;
+      zoom,start; [[Called when zooming started]]
+      zoom,stop; [[Called when zooming stopped]]
+      zoom,change; [[Called when zooming changed]]
    }
 }