doc: Improve comment on asynchronous calls

[src/app-framework-binder.git] / docs / reference-v3 / func-req.md

diff --git a/docs/reference-v3/func-req.md b/docs/reference-v3/func-req.md
index 2564405..a91508d 100644 (file)
--- a/docs/reference-v3/func-req.md
+++ b/docs/reference-v3/func-req.md
@@ -436,6 +436,9 @@ void afb_req_reply_f(
  *  4. 'info'    a string handling some info (can be NULL)
  *  5. 'req'     the req
  *
+ * 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 req      The request
  * @param api      The api name of the method to call
  * @param verb     The verb name of the method to call