X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=docs%2Freference-v3%2Ffunc-api.md;h=66dd4c9d5c781565bf70f2f10f19a67f3217833d;hb=5b5968815dc672467f40ed6b49f05a590bdb8b4d;hp=aa28932adb7f55a9c3f53daa725b844bb729379f;hpb=6492d061bf5753bb3bb67b771fc2f9ce0c910c2b;p=src%2Fapp-framework-binder.git

diff --git a/docs/reference-v3/func-api.md b/docs/reference-v3/func-api.md
index aa28932a..66dd4c9d 100644
--- a/docs/reference-v3/func-api.md
+++ b/docs/reference-v3/func-api.md
@@ -293,6 +293,9 @@ struct json_object *afb_api_settings(
  *  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
@@ -425,7 +428,7 @@ int afb_api_queue_job(
  * @param name the event name suffix
  * @param object the object that comes with the event
  *
- * @return the count of clients that received the event.
+ * @return 0 in case of success or -1 in case of error
  */
 int afb_api_broadcast_event(
 			afb_api_t api,