From: Jonathan Aillet <jonathan.aillet@iot.bzh>
Date: Fri, 20 Jul 2018 10:43:19 +0000 (+0200)
Subject: Enhance 'wrap_json_clone_depth' description
X-Git-Tag: 6.99.3~7
X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=commitdiff_plain;h=5e68dd976b6710a28955368b0b67fbbcd6cce371;p=src%2Flibafb-helpers.git

Enhance 'wrap_json_clone_depth' description

Enhance 'wrap_json_clone_depth' description by adding details about
clone depth using this function.

Change-Id: Iede8fa6a697f12e8a32c1e15afdcef445edbcfe4
Signed-off-by: Jonathan Aillet <jonathan.aillet@iot.bzh>
---

diff --git a/wrap-json.c b/wrap-json.c
index 6e60476..0633991 100644
--- a/wrap-json.c
+++ b/wrap-json.c
@@ -992,9 +992,13 @@ struct json_object *wrap_json_clone_depth(struct json_object *item, int depth)
 }
 
 /**
- * Clones the 'object': returns a copy of it. But doen't clones
+ * Clones the 'object': returns a copy of it. But doesn't clones
  * the content. Synonym of wrap_json_clone_depth(object, 1).
  *
+ * Be aware that this implementation doesn't clones content that is deeper
+ * than 1 but it does link these contents to the original object and
+ * increments their use count. So, everything deeper that 1 is still available.
+ *
  * @param object the object to clone
  *
  * @return a copy of the object.