diff options
author | Jose Bollo <jose.bollo@iot.bzh> | 2019-02-25 11:27:48 +0100 |
---|---|---|
committer | José Bollo <jose.bollo@iot.bzh> | 2019-03-22 12:21:54 +0100 |
commit | 64ca02ceed8acd4b55e423de6b586a143f5a3c64 (patch) | |
tree | d89a9e9e8738e0368f50511b182868471e3115ae /include/afb/afb-api-x3.h | |
parent | 0e2b5f5b7fa3a09abf61c8253efce7c7f2b4c444 (diff) |
doc: Improve comment on asynchronous calls
Following remarks of fellow developpers, the status
the object received by the callback function
needed to be more explained.
Change-Id: I0e6bcd51849bbc5af92af08675949a901bfd683e
Signed-off-by: Jose Bollo <jose.bollo@iot.bzh>
Diffstat (limited to 'include/afb/afb-api-x3.h')
-rw-r--r-- | include/afb/afb-api-x3.h | 4 |
1 files changed, 3 insertions, 1 deletions
diff --git a/include/afb/afb-api-x3.h b/include/afb/afb-api-x3.h index fc72d070..ca92bb59 100644 --- a/include/afb/afb-api-x3.h +++ b/include/afb/afb-api-x3.h @@ -814,6 +814,9 @@ int afb_api_x3_event_handler_del( * 4. 'info' a string handling some info (can be NULL) * 5. 'api' the api * + * NOTE: For convenience, *json_object_put* is called on 'object' after the + * callback returns. So, it is wrong to call *json_object_put* in the callback. + * * @param api The api that makes the call * @param apiname The api name of the method to call * @param verb The verb name of the method to call @@ -821,7 +824,6 @@ int afb_api_x3_event_handler_del( * @param callback The to call on completion * @param closure The closure to pass to the callback * - * * @see afb_req_subcall * @see afb_req_subcall_sync * @see afb_api_x3_call_sync |