X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=include%2Fafb%2Fafb-api-x3.h;h=ca92bb59397ceb37c0ca090b246a440288bb8b4e;hb=64ca02ceed8acd4b55e423de6b586a143f5a3c64;hp=fc72d0707baf2abca3960623dcbfd418b1e88830;hpb=0e2b5f5b7fa3a09abf61c8253efce7c7f2b4c444;p=src%2Fapp-framework-binder.git

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