diff --git a/status/libio.h b/status/libio.h
index d744541..9a73bf8 100644
--- a/status/libio.h
+++ b/status/libio.h
@@ -1,3 +1,8 @@
 /* 2025 DTB. Public Domain. */
+
+/* libio is a microscopic library that exists to separate less relevant code
+ * from status(1). It should not be used in critical applications for lack of
+ * recoverability (as opposed to <stdio.h> on its own). */
+
 void drop(void);   /* Set the buffer to NULL. */
 void out(char *s); /* Print the buffer if not NULL and replace it with s. */
diff --git a/status/libkeyval.h b/status/libkeyval.h
index d73a78a..1b0a6cc 100644
--- a/status/libkeyval.h
+++ b/status/libkeyval.h
@@ -1,5 +1,10 @@
 /* 2025 DTB. Public domain. */
 
+/* libkeyval is a key/value store library to be used for nonessential
+ * applications due to lack of recoverability (errors fail assert(3)).
+ * libkeyval deals with pointers and pointers only, and an effort has been made
+ * to reflect the simplicity of the procedure in the code itself. */
+
 /* keyval store */
 #ifndef state_settings_size
 #	define state_settings_size 100