docs: Clarify how Gesture objects are used

Ref T8502

8 files changed, 16 insertions, 0 deletions

diff --git a/src/lib/evas/gesture/efl_canvas_gesture_double_tap.eo b/src/lib/evas/gesture/efl_canvas_gesture_double_tap.eo
index 87b93ccd9c..c154500244 100644
--- a/src/lib/evas/gesture/efl_canvas_gesture_double_tap.eo
+++ b/src/lib/evas/gesture/efl_canvas_gesture_double_tap.eo
@@ -3,6 +3,8 @@ class @beta Efl.Canvas.Gesture_Double_Tap extends Efl.Canvas.Gesture
    [[Double-tap gesture class holding state information.
      See @Efl.Canvas.Gesture to see what this state is and
      @[Efl.Gesture.Events.gesture,double_tap] for a description of the Double-tap gesture.
+
+     Application developers receive these objects inside a gesture event and do not typically need to create their own.
    ]]
    data: null;
    c_prefix: efl_gesture_double_tap;
diff --git a/src/lib/evas/gesture/efl_canvas_gesture_flick.eo b/src/lib/evas/gesture/efl_canvas_gesture_flick.eo
index afc8391550..125a538cc9 100644
--- a/src/lib/evas/gesture/efl_canvas_gesture_flick.eo
+++ b/src/lib/evas/gesture/efl_canvas_gesture_flick.eo
@@ -5,6 +5,8 @@ class @beta Efl.Canvas.Gesture_Flick extends Efl.Canvas.Gesture
    [[Flick gesture class holding state information.
      See @Efl.Canvas.Gesture to see what this state is and
      @[Efl.Gesture.Events.gesture,flick] for a description of the Flick gesture.
+
+     Application developers receive these objects inside a gesture event and do not typically need to create their own.
    ]]
    c_prefix: efl_gesture_flick;
    methods {
diff --git a/src/lib/evas/gesture/efl_canvas_gesture_long_tap.eo b/src/lib/evas/gesture/efl_canvas_gesture_long_tap.eo
index 6c0d0c979d..c182697a58 100644
--- a/src/lib/evas/gesture/efl_canvas_gesture_long_tap.eo
+++ b/src/lib/evas/gesture/efl_canvas_gesture_long_tap.eo
@@ -3,6 +3,8 @@ class @beta Efl.Canvas.Gesture_Long_Tap extends Efl.Canvas.Gesture
    [[Long-tap gesture class holding state information.
      See @Efl.Canvas.Gesture to see what this state is and
      @[Efl.Gesture.Events.gesture,long_tap] for a description of the Long-tap gesture.
+
+     Application developers receive these objects inside a gesture event and do not typically need to create their own.
    ]]
    data: null;
    c_prefix: efl_gesture_long_tap;
diff --git a/src/lib/evas/gesture/efl_canvas_gesture_momentum.eo b/src/lib/evas/gesture/efl_canvas_gesture_momentum.eo
index 0f78ad69aa..df0e0720db 100644
--- a/src/lib/evas/gesture/efl_canvas_gesture_momentum.eo
+++ b/src/lib/evas/gesture/efl_canvas_gesture_momentum.eo
@@ -5,6 +5,8 @@ class @beta Efl.Canvas.Gesture_Momentum extends Efl.Canvas.Gesture
    [[Momentum gesture class holding state information.
      See @Efl.Canvas.Gesture to see what this state is and
      @[Efl.Gesture.Events.gesture,momentum] for a description of the Momentum gesture.
+
+     Application developers receive these objects inside a gesture event and do not typically need to create their own.
    ]]
    c_prefix: efl_gesture_momentum;
    methods {
diff --git a/src/lib/evas/gesture/efl_canvas_gesture_tap.eo b/src/lib/evas/gesture/efl_canvas_gesture_tap.eo
index 0e940608d3..238c487e61 100644
--- a/src/lib/evas/gesture/efl_canvas_gesture_tap.eo
+++ b/src/lib/evas/gesture/efl_canvas_gesture_tap.eo
@@ -3,6 +3,8 @@ class @beta Efl.Canvas.Gesture_Tap extends Efl.Canvas.Gesture
    [[Tap gesture class holding state information.
      See @Efl.Canvas.Gesture to see what this state is and
      @[Efl.Gesture.Events.gesture,tap] for a description of the Tap gesture.
+
+     Application developers receive these objects inside a gesture event and do not typically need to create their own.
    ]]
    data: null;
    c_prefix: efl_gesture_tap;
diff --git a/src/lib/evas/gesture/efl_canvas_gesture_triple_tap.eo b/src/lib/evas/gesture/efl_canvas_gesture_triple_tap.eo
index abedc442d4..a85bf6b671 100644
--- a/src/lib/evas/gesture/efl_canvas_gesture_triple_tap.eo
+++ b/src/lib/evas/gesture/efl_canvas_gesture_triple_tap.eo
@@ -3,6 +3,8 @@ class @beta Efl.Canvas.Gesture_Triple_Tap extends Efl.Canvas.Gesture
    [[Triple-tap gesture class holding state information.
      See @Efl.Canvas.Gesture to see what this state is and
      @[Efl.Gesture.Events.gesture,triple_tap] for a description of the Triple-tap gesture.
+
+     Application developers receive these objects inside a gesture event and do not typically need to create their own.
    ]]
    data: null;
    c_prefix: efl_gesture_triple_tap;
diff --git a/src/lib/evas/gesture/efl_canvas_gesture_zoom.eo b/src/lib/evas/gesture/efl_canvas_gesture_zoom.eo
index c41610bf77..4620225db0 100644
--- a/src/lib/evas/gesture/efl_canvas_gesture_zoom.eo
+++ b/src/lib/evas/gesture/efl_canvas_gesture_zoom.eo
@@ -3,6 +3,8 @@ class @beta Efl.Canvas.Gesture_Zoom extends Efl.Canvas.Gesture
    [[Zoom gesture class holding state information.
      See @Efl.Canvas.Gesture to see what this state is and
      @[Efl.Gesture.Events.gesture,zoom] for a description of the Zoom gesture.
+
+     Application developers receive these objects inside a gesture event and do not typically need to create their own.
    ]]
    c_prefix: efl_gesture_zoom;
    methods {
diff --git a/src/lib/evas/gesture/efl_gesture_events.eo b/src/lib/evas/gesture/efl_gesture_events.eo
index d80c0bbb77..0a436695fc 100644
--- a/src/lib/evas/gesture/efl_gesture_events.eo
+++ b/src/lib/evas/gesture/efl_gesture_events.eo
@@ -1,5 +1,7 @@
 interface @beta Efl.Gesture.Events
 {
+   [[Interface for objects capable of emitting gesture events, like @Efl.Canvas.Object.
+   ]]
    event_c_prefix: efl;
    events {
       gesture,tap: Efl.Canvas.Gesture_Tap; [[Emitted when a Tap gesture has been detected.