diff --git a/hledger-lib/Hledger/Utils/Regex.hs b/hledger-lib/Hledger/Utils/Regex.hs
index 37219347b..43be1595a 100644
--- a/hledger-lib/Hledger/Utils/Regex.hs
+++ b/hledger-lib/Hledger/Utils/Regex.hs
@@ -1,16 +1,22 @@
 {-# LANGUAGE ScopedTypeVariables #-}
-{-
+{-|
 
-Easy regular expression helpers.
+Easy regular expression helpers, based on regex-tdfa and regexpr. These should
 
-These should
 - have mnemonic names
+
 - have simple monomorphic types
+
 - work with strings
+
 - support extended regular expressions
+
 - support replacement
+
 - support splitting
+
 - support unicode
+
 - be cross-platform, not requiring C libraries
 
 -}