diff --git a/src/client/distren.h b/src/client/distren.h
--- a/src/client/distren.h
+++ b/src/client/distren.h
@@ -36,10 +36,15 @@ typedef struct distren_job *distren_job_
 int distren_init(distren_t *handle);
 
 /**
- Submits a file to distren.
- @param job must not refer to a valid job.
- @TODO create a stream-based interface
-*/
+ * Submits a file to distren.
+ *
+ * Blocks.
+ *
+ * @param handle distren handle.
+ * @param job must not refer to a valid job.
+ * @param filename path to a tarball representing a job.
+ * @return 0 on success, 1 on error.
+ */
 int distren_submit_file(distren_t handle, distren_job_t *job, const char *filename);
 
 /**