[gnunet] branch master updated (475003c4e -> c117e2f4e)

[gnunet]

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

grothoff pushed a change to branch master
in repository gnunet.

    from 475003c4e towards test package for v0.21.0
     new 3bee1012a stringify operation is already defined in gnunet_util_lib.h, 
do not define twicde
     new c117e2f4e -improve comments

The 2 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails.  The revisions
listed as "add" were already present in the repository and have only
been added to this reference.


Summary of changes:
 po/POTFILES.in                      |  1 +
 src/include/gnunet_testing_ng_lib.h | 42 ++++++++++++++++++++++++-------------
 2 files changed, 29 insertions(+), 14 deletions(-)

diff --git a/po/POTFILES.in b/po/POTFILES.in
index 4afcf48db..8f6b8b46d 100644
--- a/po/POTFILES.in
+++ b/po/POTFILES.in
@@ -102,6 +102,7 @@ src/contrib/service/set/ibf_sim.c
 src/contrib/service/set/plugin_block_set_test.c
 src/contrib/service/set/set_api.c
 src/contrib/service/template/gnunet-service-template.c
+src/gana/gnunet-error-codes/gnunet_error_codes.c
 src/lib/block/bg_bf.c
 src/lib/block/block.c
 src/lib/curl/curl.c
diff --git a/src/include/gnunet_testing_ng_lib.h 
b/src/include/gnunet_testing_ng_lib.h
index 07cdac962..991eddbe4 100644
--- a/src/include/gnunet_testing_ng_lib.h
+++ b/src/include/gnunet_testing_ng_lib.h
@@ -1,6 +1,6 @@
 /*
       This file is part of GNUnet
-      Copyright (C) 2021 GNUnet e.V.
+      Copyright (C) 2021, 2023 GNUnet e.V.
 
       GNUnet is free software: you can redistribute it and/or modify it
       under the terms of the GNU Affero General Public License as published
@@ -31,14 +31,6 @@
 #include "gnunet_util_lib.h"
 #include "gnunet_testing_lib.h"
 
-/**
- * Stringify operator.
- *
- * @param a some expression to stringify. Must NOT be a macro.
- * @return same expression as a constant string.
- */
-#define GNUNET_S(a) #a
-
 /**
  * Maximum length of label in command
  */
@@ -97,15 +89,38 @@ struct GNUNET_TESTING_AsyncContext
 };
 
 
+/**
+ * Signature of a function used to start executing a command
+ * of a test.
+ *
+ * @param cls closure
+ * @param is interpreter running the command
+ */
 typedef void
 (*GNUNET_TESTING_CommandRunRoutine)(void *cls,
                                     struct GNUNET_TESTING_Interpreter *is);
 
 
+/**
+ * Signature of a function used to clean up resources allocated
+ * by a command.
+ *
+ * @param cls closure
+ */
 typedef void
 (*GNUNET_TESTING_CommandCleanupRoutine)(void *cls);
 
 
+/**
+ * Signature of a function used to extract traits exposed by a
+ * command.
+ *
+ * @param cls closure
+ * @param[out] ret where to return the trait data
+ * @param trait name of the trait to return
+ * @param index index of the trait (for traits that are indexed)
+ * @return #GNUNET_OK on success
+ */
 typedef enum GNUNET_GenericReturnValue
 (*GNUNET_TESTING_CommandGetTraits) (void *cls,
                                     const void **ret,
@@ -433,7 +448,7 @@ GNUNET_TESTING_main (struct GNUNET_TESTING_Command 
*commands,
  * FIXME: Unused function.
  *
  * @param command The command to check.
- * @return GNUNET_NO if the command is not running, GNUNET_YES if it is 
running.
+ * @return #GNUNET_NO if the command is not running, #GNUNET_YES if it is 
running.
  */
 enum GNUNET_GenericReturnValue
 GNUNET_TESTING_running (const struct GNUNET_TESTING_Command *command);
@@ -444,7 +459,7 @@ GNUNET_TESTING_running (const struct GNUNET_TESTING_Command 
*command);
  * FIXME: Unused function
  *
  * @param command The command to check.
- * @return GNUNET_NO if the command is not finished, GNUNET_YES if it is 
finished.
+ * @return #GNUNET_NO if the command is not finished, #GNUNET_YES if it is 
finished.
  */
 enum GNUNET_GenericReturnValue
 GNUNET_TESTING_finished (const struct GNUNET_TESTING_Command *command);
@@ -495,7 +510,6 @@ GNUNET_TESTING_cmd_batch (const char *label,
 
 /**
  * Performance counter.
- * // FIXME: this might not belong here!
  */
 struct GNUNET_TESTING_Timer
 {
@@ -556,7 +570,7 @@ GNUNET_TESTING_get_peer (unsigned int num,
 /**
  * Obtain performance data from the interpreter.
  *
- * @param timers what commands (by label) to obtain runtimes for
+ * @param[in,out] timers what commands (by label) to obtain runtimes for
  * @return the command
  */
 struct GNUNET_TESTING_Command
@@ -626,7 +640,7 @@ GNUNET_TESTING_get_trait (const struct GNUNET_TESTING_Trait 
*traits,
 
 typedef void *
 (*GNUNET_TESTING_notify_connect_cb) (struct GNUNET_TESTING_Interpreter *is,
-                                       const struct GNUNET_PeerIdentity *peer);
+                                     const struct GNUNET_PeerIdentity *peer);
 
 /**
  * Struct to store information needed in callbacks.

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