summaryrefslogtreecommitdiff
path: root/json-glib/json-node.c
diff options
context:
space:
mode:
authorEmmanuele Bassi <ebassi@linux.intel.com>2009-11-12 11:28:17 +0000
committerEmmanuele Bassi <ebassi@linux.intel.com>2009-11-12 11:28:17 +0000
commit30d4efb775cb416212c00e3ececb0f0147739f40 (patch)
tree1e8d338133325e1ec85bdf4836f04a79a4563073 /json-glib/json-node.c
parent47cd2f678a8321faac0e2d00a3538181e7bc1cbf (diff)
downloadjson-glib-30d4efb775cb416212c00e3ececb0f0147739f40.tar.gz
Update Introspection annotations
• Fix the transfer rules for JsonNode, JsonObject and JsonArray getters. • Annotate the methods returning lists
Diffstat (limited to 'json-glib/json-node.c')
-rw-r--r--json-glib/json-node.c15
1 files changed, 8 insertions, 7 deletions
diff --git a/json-glib/json-node.c b/json-glib/json-node.c
index a21d587..6a79c4c 100644
--- a/json-glib/json-node.c
+++ b/json-glib/json-node.c
@@ -125,7 +125,7 @@ json_node_new (JsonNodeType type)
* Copies @node. If the node contains complex data types then the reference
* count of the objects is increased.
*
- * Return value: the copied #JsonNode
+ * Return value: (transfer full): the copied #JsonNode
*/
JsonNode *
json_node_copy (JsonNode *node)
@@ -220,7 +220,7 @@ json_node_take_object (JsonNode *node,
*
* Retrieves the #JsonObject stored inside a #JsonNode
*
- * Return value: the #JsonObject
+ * Return value: (transfer none): the #JsonObject
*/
JsonObject *
json_node_get_object (JsonNode *node)
@@ -238,7 +238,7 @@ json_node_get_object (JsonNode *node)
* Retrieves the #JsonObject inside @node. The reference count of
* the returned object is increased.
*
- * Return value: the #JsonObject
+ * Return value: (transfer full): the #JsonObject
*/
JsonObject *
json_node_dup_object (JsonNode *node)
@@ -305,7 +305,7 @@ json_node_take_array (JsonNode *node,
*
* Retrieves the #JsonArray stored inside a #JsonNode
*
- * Return value: the #JsonArray
+ * Return value: (transfer none): the #JsonArray
*/
JsonArray *
json_node_get_array (JsonNode *node)
@@ -323,7 +323,8 @@ json_node_get_array (JsonNode *node)
* Retrieves the #JsonArray stored inside a #JsonNode and returns it
* with its reference count increased by one.
*
- * Return value: the #JsonArray with its reference count increased.
+ * Return value: (transfer full): the #JsonArray with its reference
+ * count increased.
*/
JsonArray *
json_node_dup_array (JsonNode *node)
@@ -597,8 +598,8 @@ json_node_get_string (JsonNode *node)
*
* Gets a copy of the string value stored inside a #JsonNode
*
- * Return value: a newly allocated string containing a copy of
- * the #JsonNode contents
+ * Return value: (transfer full): a newly allocated string containing a copy
+ * of the #JsonNode contents. Use g_free() to free the allocated resources
*/
gchar *
json_node_dup_string (JsonNode *node)