diff --git a/src/runs.c b/src/runs.c
index b9d7a70..e4e9842 100644
--- a/src/runs.c
+++ b/src/runs.c
@@ -1,5 +1,8 @@
 /**
- * @file runs.c Originally contained only procedures related to runs, but has grown
+ * @file runs.c 
+ * \brief run related logic.
+ *
+ * Originally contained only procedures related to runs, but has grown
  * somewhat over time.
  */
 #include <stdlib.h>
diff --git a/src/terms.c b/src/terms.c
index bd76703..2d47bdb 100644
--- a/src/terms.c
+++ b/src/terms.c
@@ -1,3 +1,10 @@
+/**
+ * @file terms.c 
+ * \brief Term related base functions.
+ *
+ * Intended to be a standalone file, however during development it turned out that a termlist structure was needed
+ * to define term types, so there is now a dependency loop with termlists.c.
+ */
 #include <stdlib.h>
 #include <stdio.h>
 #include <limits.h>