===================================================================
RCS file: /cvs/mandoc/Attic/argv.c,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -p -r1.19 -r1.20
--- mandoc/Attic/argv.c	2009/01/20 13:05:28	1.19
+++ mandoc/Attic/argv.c	2009/01/20 13:44:05	1.20
@@ -1,4 +1,4 @@
-/* $Id: argv.c,v 1.19 2009/01/20 13:05:28 kristaps Exp $ */
+/* $Id: argv.c,v 1.20 2009/01/20 13:44:05 kristaps Exp $ */
 /*
  * Copyright (c) 2008 Kristaps Dzonsons <kristaps@kth.se>
  *
@@ -25,9 +25,14 @@
 
 #include "private.h"
 
+/*
+ * Parse arguments and parameters of macros.  Arguments follow the
+ * syntax of `-arg [val [valN...]]', while parameters are free-form text
+ * following arguments (if any).  This file must correctly handle the
+ * strange punctuation rules dictated by groff.
+ */
+
 /* FIXME: .It called with -column and quoted arguments. */
-/* FIXME: if arguments are quoted, they should not be later parsed for
- * macros. */
 
 static	int		 lookup(int, const char *);
 static	int		 parse(struct mdoc *, int,