diff --git a/src/common/execio.h b/src/common/execio.h
--- a/src/common/execio.h
+++ b/src/common/execio.h
@@ -57,9 +57,14 @@ int execio_open(struct execio **rem, con
 int execio_read(struct execio *eio, void *buf, size_t len, size_t *bytesread);
 int execio_write(struct execio *eio, void *buf, size_t len, size_t *bytesread);
 
+/*
+  use this function to determine if the using program should keep trying to read/write
+ */
 enum execio_state execio_state(struct execio *eio);
 
-/* nonzero return on error */
+/* 
+   nonzero return on error 
+*/
 int execio_close(struct execio *eio);
 
 #endif