1 files changed, 7 insertions, 0 deletions
diff --git a/parse.c b/parse.c
index 42a5a8f..80aeb88 100644
--- a/parse.c
+++ b/parse.c
@@ -14,6 +14,13 @@
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.           *
  ****************************************************************************/
 
+/**
+ * The command line parser.  Expressions are parsed by recursive descent, with a
+ * grammar described in the comments of the parse_*() functions.  The parser
+ * also accepts flags and paths at any point in the expression, by treating
+ * flags like always-true options, and skipping over paths wherever they appear.
+ */
+
 #include "bfs.h"
 #include "cmdline.h"
 #include "diag.h"