From: Shinwoo Kim <cinoo.kim@samsung.com>
Date: Thu, 3 Aug 2017 06:24:31 +0000 (+0900)
Subject: atspi: enhance elm_atspi_gesture_cb_set document
X-Git-Tag: submit/tizen_3.0/20170810.044042~10
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=90edcb861d5833dae63fab574ccd82cbfa8a5113;p=platform%2Fupstream%2Felementary.git

atspi: enhance elm_atspi_gesture_cb_set document

Change-Id: I887c08230b1de0404357d1b3717f4b3e14c08365
---

diff --git a/src/lib/elm_interface_atspi_accessible.eo b/src/lib/elm_interface_atspi_accessible.eo
index 2a5d4f386..03c0c62ab 100644
--- a/src/lib/elm_interface_atspi_accessible.eo
+++ b/src/lib/elm_interface_atspi_accessible.eo
@@ -226,6 +226,10 @@ mixin Elm_Interface_Atspi_Accessible ()
          set {
             [[Sets gesture callback to give widget.
 
+              Warning: Please do not abuse this API. The purpose of this API is
+              to support special application such as screen-reader guidance.
+              Before using this API, please check if there is another way.
+
               \@if WEARABLE \@since_tizen 3.0
               \@endif
             ]]
diff --git a/src/lib/elm_interface_atspi_accessible.h b/src/lib/elm_interface_atspi_accessible.h
index 550667ce2..e3cf86fcd 100644
--- a/src/lib/elm_interface_atspi_accessible.h
+++ b/src/lib/elm_interface_atspi_accessible.h
@@ -77,6 +77,13 @@ enum _Elm_Atspi_Gesture_Type
 /**
  * Type of gesture that is emitted on assistive technology client side.
  *
+ * @warning do not use ELM_ATSPI_GESTURE_TWO_FINGERS_FLICK_*, and
+ * ELM_ATSPI_GESTURE_TWO_FINGERS_HOVER. These gestures are not emitted on
+ * assistive technology client side. The window manager emits mouse event
+ * directly. So if you need to check these gestures, you have to handle mouse
+ * events. If you want to make highlighted object to get mouse events directly,
+ * then please use elm_atspi_accessible_attribute_append as below.
+ *
  * @if WEARABLE @since_tizen 3.0
  * @endif
  */