From ff3a723003dae41b71998535d29aeb44831e9357 Mon Sep 17 00:00:00 2001
From: Jean-Philippe Andre <jp.andre@samsung.com>
Date: Tue, 29 Aug 2017 13:50:56 +0900
Subject: [PATCH] widget: Improve access_info doc

Ref T5363
---
 src/lib/elementary/elm_widget.eo | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/lib/elementary/elm_widget.eo b/src/lib/elementary/elm_widget.eo
index e9e760189a..8ca1bd3a9b 100644
--- a/src/lib/elementary/elm_widget.eo
+++ b/src/lib/elementary/elm_widget.eo
@@ -241,9 +241,16 @@ abstract Elm.Widget (Efl.Canvas.Group, Elm.Interface.Atspi_Accessible,
 
       /* Accessibility */
       @property access_info {
-         [[Accessibility information]]
+         [[Accessibility information.
+
+           This is a replacement string to be read by the accessibility
+           text-to-speech engine, if accessibility is enabled by configuration.
+           This will take precedence over the default text for this object,
+           which means for instance that the label of a button won't be read
+           out loud, instead $txt will be read out.
+         ]]
          values {
-            txt: string @nullable; [[Accessibility text description]]
+            txt: string @nullable; [[Accessibility text description.]]
          }
       }
       on_access_activate @protected @beta {