===================================================================
RCS file: /cvs/mandoc/Attic/validate.c,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -p -r1.43 -r1.44
--- mandoc/Attic/validate.c	2009/01/20 12:51:28	1.43
+++ mandoc/Attic/validate.c	2009/01/20 13:44:05	1.44
@@ -1,4 +1,4 @@
-/* $Id: validate.c,v 1.43 2009/01/20 12:51:28 kristaps Exp $ */
+/* $Id: validate.c,v 1.44 2009/01/20 13:44:05 kristaps Exp $ */
 /*
  * Copyright (c) 2008 Kristaps Dzonsons <kristaps@kth.se>
  *
@@ -20,6 +20,14 @@
 #include <stdlib.h>
 
 #include "private.h"
+
+/*
+ * Pre- and post-validate macros as they're parsed.  Pre-validation
+ * occurs when the macro has been detected and its arguments parsed.
+ * Post-validation occurs when all child macros have also been parsed.
+ * In the ELEMENT case, this is simply the parameters of the macro; in
+ * the BLOCK case, this is the HEAD, BODY, TAIL and so on.
+ */
 
 typedef	int	(*v_pre)(struct mdoc *, struct mdoc_node *);
 typedef	int	(*v_post)(struct mdoc *);