[json-glib/doc-fixes: 10/17] Update the documentation of the utility API

[Emmanuele Bassi <ebassi src gnome org>]

commit e1860032be34d2fa7083e97ebcf298aabc85fa70
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Wed Jun 9 12:48:17 2021 +0100

    Update the documentation of the utility API

 json-glib/json-utils.c | 13 ++++++-------
 1 file changed, 6 insertions(+), 7 deletions(-)
---
diff --git a/json-glib/json-utils.c b/json-glib/json-utils.c
index dda4602..72c78e5 100644
--- a/json-glib/json-utils.c
+++ b/json-glib/json-utils.c
@@ -28,13 +28,12 @@
  * @str: a valid UTF-8 string containing JSON data
  * @error: return location for a #GError
  *
- * Parses the string in @str and returns a #JsonNode representing
- * the JSON tree.
+ * Parses the given string and returns the corresponding JSON tree.
  *
- * If @str is empty, this function will return %NULL.
+ * If the string is empty, this function will return `NULL`.
  *
- * In case of parsing error, this function returns %NULL and sets
- * @error appropriately.
+ * In case of parsing error, this function returns `NULL` and sets
+ * the error appropriately.
  *
  * Returns: (transfer full) (nullable): the root node of the JSON tree
  *
@@ -65,11 +64,11 @@ json_from_string (const char  *str,
 
 /**
  * json_to_string:
- * @node: a #JsonNode
+ * @node: a JSON tree
  * @pretty: whether the output should be prettyfied for printing
  *
  * Generates a stringified JSON representation of the contents of
- * the passed @node.
+ * the given `node`.
  *
  * Returns: (transfer full): the string representation of the node
  *