From 15b0d0dd125effe83659b427d10242704c3ae70e Mon Sep 17 00:00:00 2001 From: Marcel Hollerbach Date: Fri, 10 Feb 2017 18:49:36 +0100 Subject: [PATCH] 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 5866cacf34..9994db6df2 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 {