From 5214323d82cc09b15c25e348707f2639977ea763 Mon Sep 17 00:00:00 2001 From: Jose Bollo Date: Mon, 25 Feb 2019 11:27:48 +0100 Subject: doc: Improve comment on asynchronous calls Following the remarks of fellow developers, the status of the object received by the callback function needs to be explained better. Change-Id: I0e6bcd51849bbc5af92af08675949a901bfd683e Signed-off-by: Jose Bollo --- docs/reference-v3/func-api.md | 3 +++ 1 file changed, 3 insertions(+) (limited to 'docs/reference-v3/func-api.md') diff --git a/docs/reference-v3/func-api.md b/docs/reference-v3/func-api.md index aa28932a..454bc0f6 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 -- cgit 1.2.3-korg