bu5hm4n pushed a commit to branch master.

http://git.enlightenment.org/core/efl.git/commit/?id=15b0d0dd125effe83659b427d10242704c3ae70e

commit 15b0d0dd125effe83659b427d10242704c3ae70e
Author: Marcel Hollerbach <[email protected]>
Date:   Fri Feb 10 18:49:36 2017 +0100

    efl_object: document when callbacks are called
---
 src/lib/eo/efl_object.eo | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/lib/eo/efl_object.eo b/src/lib/eo/efl_object.eo
index 5866cac..9994db6 100644
--- a/src/lib/eo/efl_object.eo
+++ b/src/lib/eo/efl_object.eo
@@ -322,6 +322,8 @@ abstract Efl.Object ()
 
            callbacks of the same priority are called in reverse order of
            creation.
+
+           A callback is only executed on events emitted after this call 
finished.
          ]]
          return: bool; [[Return $true when the callback has been successfully 
added.]]
          params {
@@ -332,7 +334,10 @@ abstract Efl.Object ()
          }
       }
       event_callback_del {
-         [[Delete a callback with a specific data associated to it for an 
event.]]
+         [[Delete a callback with a specific data associated to it for an 
event.
+
+           The callback will never be emitted again after this call, even if a 
event emission is going on.
+         ]]
          return: bool; [[Return $true when the callback has been successfully 
removed.]]
          params {
             @in desc: ptr(const(Efl.Event.Description)); [[The description of 
the event to listen to]]
@@ -347,6 +352,8 @@ abstract Efl.Object ()
 
            callbacks of the same priority are called in reverse order of
            creation.
+
+           A callback from the array is only executed on events emitted  after 
this call finished.
          ]]
          return: bool; [[Return $true when the callback has been successfully 
added.]]
          params {
@@ -358,6 +365,7 @@ abstract Efl.Object ()
       event_callback_array_del {
          [[Del a callback array with a specific data associated to it for an
            event.
+           The callbacks from the array will never be emitted again after this 
call, even if a event emission is going on.
          ]]
          return: bool; [[Return $true when the callback has been successfully 
removed.]]
          params {

-- 


Reply via email to