1 files changed, 27 insertions, 15 deletions

diff --git a/src/testing/testing_api_cmd_netjail_start.c b/src/testing/testing_api_cmd_netjail_start.c
index c82392a08..536b356a6 100644
--- a/src/testing/testing_api_cmd_netjail_start.c
+++ b/src/testing/testing_api_cmd_netjail_start.c
@@ -29,12 +29,19 @@
 
 #define NETJAIL_START_SCRIPT "./../testing/netjail_start.sh"
 
+/**
+ * Struct to hold information for callbacks.
+ *
+ */
 struct NetJailState
 {
+  // Child Wait handle
   struct GNUNET_ChildWaitHandle *cwh;
 
+  // Number of local nodes in each namespace.
   char *local_m;
 
+  // The number of namespaces.
   char *global_n;
 
   /**
@@ -42,16 +49,15 @@ struct NetJailState
    */
   struct GNUNET_OS_Process *start_proc;
 
+  // Flag indication if the script finished.
   unsigned int finished;
 };
 
 
 /**
-*
-*
-* @param cls closure
-* @param cmd current CMD being cleaned up.
-*/
+ * The cleanup function of this cmd frees resources the cmd allocated.
+ *
+ */
 static void
 netjail_start_cleanup (void *cls,
                        const struct GNUNET_TESTING_Command *cmd)
@@ -81,14 +87,9 @@ netjail_start_cleanup (void *cls,
 
 
 /**
-*
-*
-* @param cls closure.
-* @param[out] ret result
-* @param trait name of the trait.
-* @param index index number of the object to offer.
-* @return #GNUNET_OK on success.
-*/
+ * Trait function of this cmd does nothing.
+ *
+ */
 static int
 netjail_start_traits (void *cls,
                       const void **ret,
@@ -98,6 +99,11 @@ netjail_start_traits (void *cls,
   return GNUNET_OK;
 }
 
+
+/**
+ * Callback which will be called if the setup script finished.
+ *
+ */
 static void
 child_completed_callback (void *cls,
                           enum GNUNET_OS_ProcessStatusType type,
@@ -122,7 +128,7 @@ child_completed_callback (void *cls,
 
 
 /**
-* Run the "hello world" CMD.
+* The run method starts the script which setup the network namespaces.
 *
 * @param cls closure.
 * @param cmd CMD being run.
@@ -171,6 +177,11 @@ netjail_start_run (void *cls,
   GNUNET_break (NULL != ns->cwh);
 }
 
+
+/**
+ * This function checks the flag NetJailState#finished, if this cmd finished.
+ *
+ */
 static int
 netjail_start_finish (void *cls,
                       GNUNET_SCHEDULER_TaskCallback cont,
@@ -189,7 +200,8 @@ netjail_start_finish (void *cls,
  * Create command.
  *
  * @param label name for command.
- * @param binaryname to start.
+ * @param local_m Number of local nodes in each namespace.
+ * @param global_n The number of namespaces.
  * @return command.
  */
 struct GNUNET_TESTING_Command