[gnunet] branch master updated: explain GNUNET_JSON_parse_free() better

[gnunet]

This is an automated email from the git hooks/post-receive script.

grothoff pushed a commit to branch master
in repository gnunet.

The following commit(s) were added to refs/heads/master by this push:
     new c24030b2d explain GNUNET_JSON_parse_free() better
c24030b2d is described below

commit c24030b2d9b47c7c3d9076d46e1a5efa71d2270e
Author: Christian Grothoff <christian@grothoff.org>
AuthorDate: Wed Jan 17 19:38:50 2024 +0100

    explain GNUNET_JSON_parse_free() better
---
 contrib/gana                    | 2 +-
 contrib/handbook                | 2 +-
 src/include/gnunet_json_lib.h   | 8 +++++++-
 src/service/testing/Makefile.am | 2 +-
 4 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/contrib/gana b/contrib/gana
index 9eddc2cf7..0ff4edfe7 160000
--- a/contrib/gana
+++ b/contrib/gana
@@ -1 +1 @@
-Subproject commit 9eddc2cf7b65bb43d285c75ef22fd9bc9cc7020e
+Subproject commit 0ff4edfe76be77a59d4ebff5031feb50f3ba07d8
diff --git a/contrib/handbook b/contrib/handbook
index e5b42badb..5c20e0aaa 160000
--- a/contrib/handbook
+++ b/contrib/handbook
@@ -1 +1 @@
-Subproject commit e5b42badb7450aee5367e70294a0f8b1595945eb
+Subproject commit 5c20e0aaa95c7cebc225d02231221d18fdcbdb53
diff --git a/src/include/gnunet_json_lib.h b/src/include/gnunet_json_lib.h
index c3204026b..203976b5c 100644
--- a/src/include/gnunet_json_lib.h
+++ b/src/include/gnunet_json_lib.h
@@ -142,7 +142,13 @@ GNUNET_JSON_parse (const json_t *root,
 
 /**
  * Frees all elements allocated during a #GNUNET_JSON_parse()
- * operation.
+ * operation.  Convenience function to be called if cleaning
+ * up all heap-allocated data from a #GNUNET_JSON_parse() is
+ * desired. The function does not have to be called if no data
+ * was heap-allocated (e.g. only integers, strings and fixed-sized
+ * data was used), or if the application calls the respective
+ * code to free the heap (not always #GNUNET_free(), depends
+ * on the data type!) on the returned heap-allocated data itself.
  *
  * @param spec specification of the parse operation
  */
diff --git a/src/service/testing/Makefile.am b/src/service/testing/Makefile.am
index 3bad23f95..5cd4aae9b 100644
--- a/src/service/testing/Makefile.am
+++ b/src/service/testing/Makefile.am
@@ -96,7 +96,7 @@ test_testing_start_with_config_SOURCES = \
 test_testing_start_with_config_LDADD = \
  libgnunettesting.la \
  $(top_builddir)/src/lib/util/libgnunetutil.la \
- $(top_builddir)/src/lib/hello/libgnunethello.la 
+ $(top_builddir)/src/lib/hello/libgnunethello.la
 
 test_testing_portreservation_SOURCES = \
  test_testing_portreservation.c

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.