Documented ARGS_ handling in args().

1 files changed, 15 insertions, 0 deletions

diff --git a/mdoc_argv.c b/mdoc_argv.c
index adafc7b1..447126ef 100644
--- a/mdoc_argv.c
+++ b/mdoc_argv.c
@@ -375,6 +375,21 @@ args(struct mdoc *m, int line, int *pos,
 	int		  i;
 	char		 *p, *pp;
 
+	/*
+	 * Parse out the terms (like `val' in `.Xx -arg val' or simply
+	 * `.Xx val'), which can have all sorts of properties:
+	 *
+	 *   ARGS_DELIM: use special handling if encountering trailing
+	 *   delimiters in the form of [[::delim::][ ]+]+.
+	 *
+	 *   ARGS_NOWARN: don't post warnings.  This is only used when
+	 *   re-parsing delimiters, as the warnings have already been
+	 *   posted.
+	 *
+	 *   ARGS_TABSEP: use special handling for tab/`Ta' separated
+	 *   phrases like in `Bl -column'.
+	 */
+
 	assert(*pos);
 	assert(' ' != buf[*pos]);