more comments

diff --git a/spawn.c b/spawn.c
index 870d79b60002baa7528833372d5d84c826c384fa..060d6a3e9ad4944378f231dc9147de2ea97cfc84 100644 (file)
--- a/spawn.c
+++ b/spawn.c
@@ -42,7 +42,9 @@ typedef struct spawn {
 } spawn_t;
 
 
-
+/**
+ * Structs for reading back output from a spawn via a pipe
+ */
 TAILQ_HEAD(spawn_output_buf_queue, spawn_output_buf);
 
 #define MAX_SOB_SIZE 4000
@@ -131,8 +133,12 @@ spawn_enq(const char *name, int pid)
 
 
 
-
-
+/**
+ * Execute the given program and return its output in a malloc()ed buffer
+ * 
+ * *outp will point to the allocated buffer
+ * The function will return the size of the buffer
+ */
 int
 spawn_and_store_stdout(const char *prog, char **outp)
 {