]> git.cameronkatri.com Git - mandoc.git/blobdiff - mdoc_validate.c
Add back in a check that the leading `-' exists for arguments. This
[mandoc.git] / mdoc_validate.c
index 3acab0dc5b517b5f28c6898a9d2042db7230c28d..a34a221d697a70506a1ad31f193ac37cb09dd3cf 100644 (file)
@@ -1,6 +1,7 @@
-/*     $Id: mdoc_validate.c,v 1.122 2010/11/29 12:22:28 kristaps Exp $ */
+/*     $Id: mdoc_validate.c,v 1.169 2011/04/30 10:18:24 kristaps Exp $ */
 /*
- * Copyright (c) 2008, 2009, 2010 Kristaps Dzonsons <kristaps@bsd.lv>
+ * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
+ * Copyright (c) 2010, 2011 Ingo Schwarze <schwarze@openbsd.org>
  *
  * Permission to use, copy, modify, and distribute this software for any
  * purpose with or without fee is hereby granted, provided that the above
 #include "config.h"
 #endif
 
+#ifndef        OSNAME
+#include <sys/utsname.h>
+#endif
+
 #include <sys/types.h>
 
 #include <assert.h>
@@ -26,7 +31,9 @@
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
+#include <time.h>
 
+#include "mdoc.h"
 #include "mandoc.h"
 #include "libmdoc.h"
 #include "libmandoc.h"
@@ -36,6 +43,9 @@
 #define        PRE_ARGS  struct mdoc *mdoc, struct mdoc_node *n
 #define        POST_ARGS struct mdoc *mdoc
 
+#define        NUMSIZ    32
+#define        DATESIZE  32
+
 enum   check_ineq {
        CHECK_LT,
        CHECK_GT,
@@ -45,7 +55,6 @@ enum  check_ineq {
 enum   check_lvl {
        CHECK_WARN,
        CHECK_ERROR,
-       CHECK_FATAL
 };
 
 typedef        int     (*v_pre)(PRE_ARGS);
@@ -59,43 +68,56 @@ struct      valids {
 static int      check_count(struct mdoc *, enum mdoc_type, 
                        enum check_lvl, enum check_ineq, int);
 static int      check_parent(PRE_ARGS, enum mdoct, enum mdoc_type);
-static int      check_stdarg(PRE_ARGS);
-static int      check_text(struct mdoc *, int, int, char *);
-static int      check_argv(struct mdoc *, 
+static void     check_text(struct mdoc *, int, int, char *);
+static void     check_argv(struct mdoc *, 
                        struct mdoc_node *, struct mdoc_argv *);
-static int      check_args(struct mdoc *, struct mdoc_node *);
+static void     check_args(struct mdoc *, struct mdoc_node *);
+
+static int      concat(struct mdoc *, char *, 
+                       const struct mdoc_node *, size_t);
+static enum mdoc_sec   a2sec(const char *);
+static size_t          macro2len(enum mdoct);
 
 static int      ebool(POST_ARGS);
 static int      berr_ge1(POST_ARGS);
 static int      bwarn_ge1(POST_ARGS);
-static int      eerr_eq0(POST_ARGS);
-static int      eerr_eq1(POST_ARGS);
-static int      eerr_ge1(POST_ARGS);
-static int      eerr_le1(POST_ARGS);
 static int      ewarn_eq0(POST_ARGS);
+static int      ewarn_eq1(POST_ARGS);
 static int      ewarn_ge1(POST_ARGS);
-static int      herr_eq0(POST_ARGS);
-static int      herr_ge1(POST_ARGS);
+static int      ewarn_le1(POST_ARGS);
 static int      hwarn_eq0(POST_ARGS);
 static int      hwarn_eq1(POST_ARGS);
+static int      hwarn_ge1(POST_ARGS);
 static int      hwarn_le1(POST_ARGS);
 
 static int      post_an(POST_ARGS);
 static int      post_at(POST_ARGS);
 static int      post_bf(POST_ARGS);
 static int      post_bl(POST_ARGS);
+static int      post_bl_block(POST_ARGS);
+static int      post_bl_block_width(POST_ARGS);
+static int      post_bl_block_tag(POST_ARGS);
 static int      post_bl_head(POST_ARGS);
+static int      post_bx(POST_ARGS);
+static int      post_dd(POST_ARGS);
 static int      post_dt(POST_ARGS);
+static int      post_defaults(POST_ARGS);
+static int      post_literal(POST_ARGS);
+static int      post_eoln(POST_ARGS);
 static int      post_it(POST_ARGS);
 static int      post_lb(POST_ARGS);
 static int      post_nm(POST_ARGS);
+static int      post_ns(POST_ARGS);
+static int      post_os(POST_ARGS);
+static int      post_ignpar(POST_ARGS);
+static int      post_prol(POST_ARGS);
 static int      post_root(POST_ARGS);
 static int      post_rs(POST_ARGS);
 static int      post_sh(POST_ARGS);
 static int      post_sh_body(POST_ARGS);
 static int      post_sh_head(POST_ARGS);
 static int      post_st(POST_ARGS);
-static int      post_eoln(POST_ARGS);
+static int      post_std(POST_ARGS);
 static int      post_vt(POST_ARGS);
 static int      pre_an(PRE_ARGS);
 static int      pre_bd(PRE_ARGS);
@@ -104,97 +126,105 @@ static   int      pre_dd(PRE_ARGS);
 static int      pre_display(PRE_ARGS);
 static int      pre_dt(PRE_ARGS);
 static int      pre_it(PRE_ARGS);
+static int      pre_literal(PRE_ARGS);
 static int      pre_os(PRE_ARGS);
-static int      pre_pp(PRE_ARGS);
-static int      pre_rv(PRE_ARGS);
+static int      pre_par(PRE_ARGS);
 static int      pre_sh(PRE_ARGS);
 static int      pre_ss(PRE_ARGS);
+static int      pre_std(PRE_ARGS);
 
 static v_post   posts_an[] = { post_an, NULL };
-static v_post   posts_at[] = { post_at, NULL };
-static v_post   posts_bd_bk[] = { hwarn_eq0, bwarn_ge1, NULL };
+static v_post   posts_at[] = { post_at, post_defaults, NULL };
+static v_post   posts_bd[] = { post_literal, hwarn_eq0, bwarn_ge1, NULL };
 static v_post   posts_bf[] = { hwarn_le1, post_bf, NULL };
+static v_post   posts_bk[] = { hwarn_eq0, bwarn_ge1, NULL };
 static v_post   posts_bl[] = { bwarn_ge1, post_bl, NULL };
-static v_post   posts_bool[] = { eerr_eq1, ebool, NULL };
+static v_post   posts_bx[] = { post_bx, NULL };
+static v_post   posts_bool[] = { ebool, NULL };
 static v_post   posts_eoln[] = { post_eoln, NULL };
-static v_post   posts_dt[] = { post_dt, NULL };
+static v_post   posts_defaults[] = { post_defaults, NULL };
+static v_post   posts_dd[] = { post_dd, post_prol, NULL };
+static v_post   posts_dl[] = { post_literal, bwarn_ge1, NULL };
+static v_post   posts_dt[] = { post_dt, post_prol, NULL };
 static v_post   posts_fo[] = { hwarn_eq1, bwarn_ge1, NULL };
 static v_post   posts_it[] = { post_it, NULL };
-static v_post   posts_lb[] = { eerr_eq1, post_lb, NULL };
+static v_post   posts_lb[] = { post_lb, NULL };
 static v_post   posts_nd[] = { berr_ge1, NULL };
 static v_post   posts_nm[] = { post_nm, NULL };
 static v_post   posts_notext[] = { ewarn_eq0, NULL };
-static v_post   posts_rs[] = { berr_ge1, herr_eq0, post_rs, NULL };
-static v_post   posts_sh[] = { herr_ge1, bwarn_ge1, post_sh, NULL };
-static v_post   posts_sp[] = { eerr_le1, NULL };
-static v_post   posts_ss[] = { herr_ge1, NULL };
-static v_post   posts_st[] = { eerr_eq1, post_st, NULL };
-static v_post   posts_text[] = { eerr_ge1, NULL };
-static v_post   posts_text1[] = { eerr_eq1, NULL };
+static v_post   posts_ns[] = { post_ns, NULL };
+static v_post   posts_os[] = { post_os, post_prol, NULL };
+static v_post   posts_rs[] = { post_rs, NULL };
+static v_post   posts_sh[] = { post_ignpar, hwarn_ge1, post_sh, NULL };
+static v_post   posts_sp[] = { ewarn_le1, NULL };
+static v_post   posts_ss[] = { post_ignpar, hwarn_ge1, NULL };
+static v_post   posts_st[] = { post_st, NULL };
+static v_post   posts_std[] = { post_std, NULL };
+static v_post   posts_text[] = { ewarn_ge1, NULL };
+static v_post   posts_text1[] = { ewarn_eq1, NULL };
 static v_post   posts_vt[] = { post_vt, NULL };
-static v_post   posts_wline[] = { bwarn_ge1, herr_eq0, NULL };
-static v_post   posts_wtext[] = { ewarn_ge1, NULL };
+static v_post   posts_wline[] = { bwarn_ge1, NULL };
 static v_pre    pres_an[] = { pre_an, NULL };
-static v_pre    pres_bd[] = { pre_display, pre_bd, pre_pp, NULL };
-static v_pre    pres_bl[] = { pre_bl, pre_pp, NULL };
+static v_pre    pres_bd[] = { pre_display, pre_bd, pre_literal, pre_par, NULL };
+static v_pre    pres_bl[] = { pre_bl, pre_par, NULL };
 static v_pre    pres_d1[] = { pre_display, NULL };
+static v_pre    pres_dl[] = { pre_literal, pre_display, NULL };
 static v_pre    pres_dd[] = { pre_dd, NULL };
 static v_pre    pres_dt[] = { pre_dt, NULL };
 static v_pre    pres_er[] = { NULL, NULL };
-static v_pre    pres_ex[] = { NULL, NULL };
 static v_pre    pres_fd[] = { NULL, NULL };
-static v_pre    pres_it[] = { pre_it, NULL };
+static v_pre    pres_it[] = { pre_it, pre_par, NULL };
 static v_pre    pres_os[] = { pre_os, NULL };
-static v_pre    pres_pp[] = { pre_pp, NULL };
-static v_pre    pres_rv[] = { pre_rv, NULL };
+static v_pre    pres_pp[] = { pre_par, NULL };
 static v_pre    pres_sh[] = { pre_sh, NULL };
 static v_pre    pres_ss[] = { pre_ss, NULL };
+static v_pre    pres_std[] = { pre_std, NULL };
 
-const  struct valids mdoc_valids[MDOC_MAX] = {
+static const struct valids mdoc_valids[MDOC_MAX] = {
        { NULL, NULL },                         /* Ap */
-       { pres_dd, posts_wtext },               /* Dd */
+       { pres_dd, posts_dd },                  /* Dd */
        { pres_dt, posts_dt },                  /* Dt */
-       { pres_os, NULL },                      /* Os */
+       { pres_os, posts_os },                  /* Os */
        { pres_sh, posts_sh },                  /* Sh */ 
        { pres_ss, posts_ss },                  /* Ss */ 
        { pres_pp, posts_notext },              /* Pp */ 
        { pres_d1, posts_wline },               /* D1 */
-       { pres_d1, posts_wline },               /* Dl */
-       { pres_bd, posts_bd_bk },               /* Bd */
+       { pres_dl, posts_dl },                  /* Dl */
+       { pres_bd, posts_bd },                  /* Bd */
        { NULL, NULL },                         /* Ed */
        { pres_bl, posts_bl },                  /* Bl */ 
        { NULL, NULL },                         /* El */
        { pres_it, posts_it },                  /* It */
-       { NULL, posts_text },                   /* Ad */ 
+       { NULL, NULL },                         /* Ad */ 
        { pres_an, posts_an },                  /* An */ 
-       { NULL, NULL },                         /* Ar */
-       { NULL, posts_text },                   /* Cd */ 
+       { NULL, posts_defaults },               /* Ar */
+       { NULL, NULL },                         /* Cd */ 
        { NULL, NULL },                         /* Cm */
        { NULL, NULL },                         /* Dv */ 
-       { pres_er, posts_text },                /* Er */ 
+       { pres_er, NULL },                      /* Er */ 
        { NULL, NULL },                         /* Ev */ 
-       { pres_ex, NULL },                      /* Ex */ 
+       { pres_std, posts_std },                /* Ex */ 
        { NULL, NULL },                         /* Fa */ 
-       { pres_fd, posts_wtext },               /* Fd */
+       { pres_fd, posts_text },                /* Fd */
        { NULL, NULL },                         /* Fl */
-       { NULL, posts_text },                   /* Fn */ 
-       { NULL, posts_wtext },                  /* Ft */ 
-       { NULL, posts_text },                   /* Ic */ 
+       { NULL, NULL },                         /* Fn */ 
+       { NULL, NULL },                         /* Ft */ 
+       { NULL, NULL },                         /* Ic */ 
        { NULL, posts_text1 },                  /* In */ 
-       { NULL, NULL },                         /* Li */
+       { NULL, posts_defaults },               /* Li */
        { NULL, posts_nd },                     /* Nd */
        { NULL, posts_nm },                     /* Nm */
-       { NULL, posts_wline },                  /* Op */
+       { NULL, NULL },                         /* Op */
        { NULL, NULL },                         /* Ot */
-       { NULL, NULL },                         /* Pa */
-       { pres_rv, NULL },                      /* Rv */
+       { NULL, posts_defaults },               /* Pa */
+       { pres_std, posts_std },                /* Rv */
        { NULL, posts_st },                     /* St */ 
        { NULL, NULL },                         /* Va */
        { NULL, posts_vt },                     /* Vt */ 
-       { NULL, posts_wtext },                  /* Xr */ 
+       { NULL, posts_text },                   /* Xr */ 
        { NULL, posts_text },                   /* %A */
        { NULL, posts_text },                   /* %B */ /* FIXME: can be used outside Rs/Re. */
-       { NULL, posts_text },                   /* %D */ /* FIXME: check date with mandoc_a2time(). */
+       { NULL, posts_text },                   /* %D */
        { NULL, posts_text },                   /* %I */
        { NULL, posts_text },                   /* %J */
        { NULL, posts_text },                   /* %N */
@@ -205,45 +235,45 @@ const     struct valids mdoc_valids[MDOC_MAX] = {
        { NULL, posts_text },                   /* %V */
        { NULL, NULL },                         /* Ac */
        { NULL, NULL },                         /* Ao */
-       { NULL, posts_wline },                  /* Aq */
+       { NULL, NULL },                         /* Aq */
        { NULL, posts_at },                     /* At */ 
        { NULL, NULL },                         /* Bc */
        { NULL, posts_bf },                     /* Bf */
        { NULL, NULL },                         /* Bo */
-       { NULL, posts_wline },                  /* Bq */
+       { NULL, NULL },                         /* Bq */
        { NULL, NULL },                         /* Bsx */
-       { NULL, NULL },                         /* Bx */
+       { NULL, posts_bx },                     /* Bx */
        { NULL, posts_bool },                   /* Db */
        { NULL, NULL },                         /* Dc */
        { NULL, NULL },                         /* Do */
-       { NULL, posts_wline },                  /* Dq */
+       { NULL, NULL },                         /* Dq */
        { NULL, NULL },                         /* Ec */
        { NULL, NULL },                         /* Ef */ 
        { NULL, NULL },                         /* Em */ 
        { NULL, NULL },                         /* Eo */
        { NULL, NULL },                         /* Fx */
-       { NULL, posts_text },                   /* Ms */ 
+       { NULL, NULL },                         /* Ms */ 
        { NULL, posts_notext },                 /* No */
-       { NULL, posts_notext },                 /* Ns */
+       { NULL, posts_ns },                     /* Ns */
        { NULL, NULL },                         /* Nx */
        { NULL, NULL },                         /* Ox */
        { NULL, NULL },                         /* Pc */
        { NULL, posts_text1 },                  /* Pf */
        { NULL, NULL },                         /* Po */
-       { NULL, posts_wline },                  /* Pq */
+       { NULL, NULL },                         /* Pq */
        { NULL, NULL },                         /* Qc */
-       { NULL, posts_wline },                  /* Ql */
+       { NULL, NULL },                         /* Ql */
        { NULL, NULL },                         /* Qo */
-       { NULL, posts_wline },                  /* Qq */
+       { NULL, NULL },                         /* Qq */
        { NULL, NULL },                         /* Re */
        { NULL, posts_rs },                     /* Rs */
        { NULL, NULL },                         /* Sc */
        { NULL, NULL },                         /* So */
-       { NULL, posts_wline },                  /* Sq */
+       { NULL, NULL },                         /* Sq */
        { NULL, posts_bool },                   /* Sm */ 
-       { NULL, posts_text },                   /* Sx */
-       { NULL, posts_text },                   /* Sy */
-       { NULL, posts_text },                   /* Tn */
+       { NULL, NULL },                         /* Sx */
+       { NULL, NULL },                         /* Sy */
+       { NULL, NULL },                         /* Tn */
        { NULL, NULL },                         /* Ux */
        { NULL, NULL },                         /* Xc */
        { NULL, NULL },                         /* Xo */
@@ -251,7 +281,7 @@ const       struct valids mdoc_valids[MDOC_MAX] = {
        { NULL, NULL },                         /* Fc */ 
        { NULL, NULL },                         /* Oo */
        { NULL, NULL },                         /* Oc */
-       { NULL, posts_bd_bk },                  /* Bk */
+       { NULL, posts_bk },                     /* Bk */
        { NULL, NULL },                         /* Ek */
        { NULL, posts_eoln },                   /* Bt */
        { NULL, NULL },                         /* Hf */
@@ -259,9 +289,9 @@ const       struct valids mdoc_valids[MDOC_MAX] = {
        { NULL, posts_eoln },                   /* Ud */
        { NULL, posts_lb },                     /* Lb */
        { NULL, posts_notext },                 /* Lp */ 
-       { NULL, posts_text },                   /* Lk */ 
-       { NULL, posts_text },                   /* Mt */ 
-       { NULL, posts_wline },                  /* Brq */ 
+       { NULL, NULL },                         /* Lk */ 
+       { NULL, posts_defaults },               /* Mt */ 
+       { NULL, NULL },                         /* Brq */ 
        { NULL, NULL },                         /* Bro */ 
        { NULL, NULL },                         /* Brc */ 
        { NULL, posts_text },                   /* %C */
@@ -294,6 +324,30 @@ static     const enum mdoct rsord[RSORD_MAX] = {
        MDOC__U
 };
 
+static const char * const secnames[SEC__MAX] = {
+       NULL,
+       "NAME",
+       "LIBRARY",
+       "SYNOPSIS",
+       "DESCRIPTION",
+       "IMPLEMENTATION NOTES",
+       "RETURN VALUES",
+       "ENVIRONMENT",
+       "FILES",
+       "EXIT STATUS",
+       "EXAMPLES",
+       "DIAGNOSTICS",
+       "COMPATIBILITY",
+       "ERRORS",
+       "SEE ALSO",
+       "STANDARDS",
+       "HISTORY",
+       "AUTHORS",
+       "CAVEATS",
+       "BUGS",
+       "SECURITY CONSIDERATIONS",
+       NULL
+};
 
 int
 mdoc_valid_pre(struct mdoc *mdoc, struct mdoc_node *n)
@@ -302,15 +356,25 @@ mdoc_valid_pre(struct mdoc *mdoc, struct mdoc_node *n)
        int              line, pos;
        char            *tp;
 
-       if (MDOC_TEXT == n->type) {
+       switch (n->type) {
+       case (MDOC_TEXT):
                tp = n->string;
                line = n->line;
                pos = n->pos;
-               return(check_text(mdoc, line, pos, tp));
+               check_text(mdoc, line, pos, tp);
+               /* FALLTHROUGH */
+       case (MDOC_TBL):
+               /* FALLTHROUGH */
+       case (MDOC_EQN):
+               /* FALLTHROUGH */
+       case (MDOC_ROOT):
+               return(1);
+       default:
+               break;
        }
 
-       if ( ! check_args(mdoc, n))
-               return(0);
+       check_args(mdoc, n);
+
        if (NULL == mdoc_valids[n->tok].pre)
                return(1);
        for (p = mdoc_valids[n->tok].pre; *p; p++)
@@ -329,10 +393,18 @@ mdoc_valid_post(struct mdoc *mdoc)
                return(1);
        mdoc->last->flags |= MDOC_VALID;
 
-       if (MDOC_TEXT == mdoc->last->type)
+       switch (mdoc->last->type) {
+       case (MDOC_TEXT):
+               /* FALLTHROUGH */
+       case (MDOC_EQN):
+               /* FALLTHROUGH */
+       case (MDOC_TBL):
                return(1);
-       if (MDOC_ROOT == mdoc->last->type)
+       case (MDOC_ROOT):
                return(post_root(mdoc));
+       default:
+               break;
+       }
 
        if (NULL == mdoc_valids[mdoc->last->tok].post)
                return(1);
@@ -348,6 +420,7 @@ check_count(struct mdoc *m, enum mdoc_type type,
                enum check_lvl lvl, enum check_ineq ineq, int val)
 {
        const char      *p;
+       enum mandocerr   t;
 
        if (m->last->type != type)
                return(1);
@@ -359,7 +432,7 @@ check_count(struct mdoc *m, enum mdoc_type type,
                        return(1);
                break;
        case (CHECK_GT):
-               p = "greater than ";
+               p = "more than ";
                if (m->last->nchild > val)
                        return(1);
                break;
@@ -368,26 +441,23 @@ check_count(struct mdoc *m, enum mdoc_type type,
                if (val == m->last->nchild)
                        return(1);
                break;
+       default:
+               abort();
+               /* NOTREACHED */
        }
 
-       if (CHECK_WARN == lvl) {
-               return(mdoc_vmsg(m, MANDOCERR_ARGCOUNT,
-                               m->last->line, m->last->pos,
-                               "want %s%d children (have %d)",
-                               p, val, m->last->nchild));
-       }
-
-       return(mdoc_vmsg(m, MANDOCERR_ARGCOUNT,
-                       m->last->line, m->last->pos,
-                       "require %s%d children (have %d)",
-                       p, val, m->last->nchild));
+       t = lvl == CHECK_WARN ? MANDOCERR_ARGCWARN : MANDOCERR_ARGCOUNT;
+       mandoc_vmsg(t, m->parse, m->last->line, m->last->pos,
+                       "want %s%d children (have %d)",
+                       p, val, m->last->nchild);
+       return(1);
 }
 
 static int
 berr_ge1(POST_ARGS)
 {
 
-       return(check_count(mdoc, MDOC_BODY, CHECK_FATAL, CHECK_GT, 0));
+       return(check_count(mdoc, MDOC_BODY, CHECK_ERROR, CHECK_GT, 0));
 }
 
 static int
@@ -396,30 +466,6 @@ bwarn_ge1(POST_ARGS)
        return(check_count(mdoc, MDOC_BODY, CHECK_WARN, CHECK_GT, 0));
 }
 
-static int
-eerr_eq0(POST_ARGS)
-{
-       return(check_count(mdoc, MDOC_ELEM, CHECK_FATAL, CHECK_EQ, 0));
-}
-
-static int
-eerr_eq1(POST_ARGS)
-{
-       return(check_count(mdoc, MDOC_ELEM, CHECK_FATAL, CHECK_EQ, 1));
-}
-
-static int
-eerr_ge1(POST_ARGS)
-{
-       return(check_count(mdoc, MDOC_ELEM, CHECK_FATAL, CHECK_GT, 0));
-}
-
-static int
-eerr_le1(POST_ARGS)
-{
-       return(check_count(mdoc, MDOC_ELEM, CHECK_FATAL, CHECK_LT, 2));
-}
-
 static int
 ewarn_eq0(POST_ARGS)
 {
@@ -427,21 +473,21 @@ ewarn_eq0(POST_ARGS)
 }
 
 static int
-ewarn_ge1(POST_ARGS)
+ewarn_eq1(POST_ARGS)
 {
-       return(check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_GT, 0));
+       return(check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_EQ, 1));
 }
 
 static int
-herr_eq0(POST_ARGS)
+ewarn_ge1(POST_ARGS)
 {
-       return(check_count(mdoc, MDOC_HEAD, CHECK_FATAL, CHECK_EQ, 0));
+       return(check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_GT, 0));
 }
 
 static int
-herr_ge1(POST_ARGS)
+ewarn_le1(POST_ARGS)
 {
-       return(check_count(mdoc, MDOC_HEAD, CHECK_FATAL, CHECK_GT, 0));
+       return(check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_LT, 2));
 }
 
 static int
@@ -457,97 +503,84 @@ hwarn_eq1(POST_ARGS)
 }
 
 static int
-hwarn_le1(POST_ARGS)
+hwarn_ge1(POST_ARGS)
 {
-       return(check_count(mdoc, MDOC_HEAD, CHECK_WARN, CHECK_LT, 2));
+       return(check_count(mdoc, MDOC_HEAD, CHECK_WARN, CHECK_GT, 0));
 }
 
-
 static int
-check_stdarg(PRE_ARGS)
+hwarn_le1(POST_ARGS)
 {
-
-       if (n->args && 1 == n->args->argc)
-               if (MDOC_Std == n->args->argv[0].arg)
-                       return(1);
-       return(mdoc_nmsg(mdoc, n, MANDOCERR_NOARGV));
+       return(check_count(mdoc, MDOC_HEAD, CHECK_WARN, CHECK_LT, 2));
 }
 
-
-static int
+static void
 check_args(struct mdoc *m, struct mdoc_node *n)
 {
        int              i;
 
        if (NULL == n->args)
-               return(1);
+               return;
 
        assert(n->args->argc);
        for (i = 0; i < (int)n->args->argc; i++)
-               if ( ! check_argv(m, n, &n->args->argv[i]))
-                       return(0);
-
-       return(1);
+               check_argv(m, n, &n->args->argv[i]);
 }
 
-
-static int
+static void
 check_argv(struct mdoc *m, struct mdoc_node *n, struct mdoc_argv *v)
 {
        int              i;
 
        for (i = 0; i < (int)v->sz; i++)
-               if ( ! check_text(m, v->line, v->pos, v->value[i]))
-                       return(0);
+               check_text(m, v->line, v->pos, v->value[i]);
 
-       if (MDOC_Std == v->arg) {
-               if (v->sz || m->meta.name)
-                       return(1);
-               if ( ! mdoc_nmsg(m, n, MANDOCERR_NONAME))
-                       return(0);
-       }
+       /* FIXME: move to post_std(). */
 
-       return(1);
+       if (MDOC_Std == v->arg)
+               if ( ! (v->sz || m->meta.name))
+                       mdoc_nmsg(m, n, MANDOCERR_NONAME);
 }
 
-
-static int
+static void
 check_text(struct mdoc *m, int ln, int pos, char *p)
 {
-       int              c;
+       char            *cpp, *pp;
        size_t           sz;
 
-       for ( ; *p; p++, pos++) {
+       while ('\0' != *p) {
                sz = strcspn(p, "\t\\");
+
                p += (int)sz;
+               pos += (int)sz;
 
-               if ('\0' == *p)
+               if ('\t' == *p) {
+                       if ( ! (MDOC_LITERAL & m->flags))
+                               mdoc_pmsg(m, ln, pos, MANDOCERR_BADTAB);
+                       p++;
+                       pos++;
+                       continue;
+               } else if ('\0' == *p)
                        break;
 
-               pos += (int)sz;
+               pos++;
+               pp = ++p;
 
-               if ('\t' == *p) {
-                       if (MDOC_LITERAL & m->flags)
-                               continue;
-                       if (mdoc_pmsg(m, ln, pos, MANDOCERR_BADTAB))
-                               continue;
-                       return(0);
+               if (ESCAPE_ERROR == mandoc_escape
+                               ((const char **)&pp, NULL, NULL)) {
+                       mdoc_pmsg(m, ln, pos, MANDOCERR_BADESCAPE);
+                       break;
                }
 
-               /* Check the special character. */
+               cpp = p;
+               while (NULL != (cpp = memchr(cpp, ASCII_HYPH, pp - cpp)))
+                       *cpp = '-';
 
-               c = mandoc_special(p);
-               if (c) {
-                       p += c - 1;
-                       pos += c - 1;
-               } else
-                       mdoc_pmsg(m, ln, pos, MANDOCERR_BADESCAPE);
+               pos += pp - p;
+               p = pp;
        }
-
-       return(1);
 }
 
-
 static int
 check_parent(PRE_ARGS, enum mdoct tok, enum mdoc_type t)
 {
@@ -557,10 +590,9 @@ check_parent(PRE_ARGS, enum mdoct tok, enum mdoc_type t)
                        (t == n->parent->type))
                return(1);
 
-       mdoc_vmsg(mdoc, MANDOCERR_SYNTCHILD,
-                               n->line, n->pos, "want parent %s",
-                               MDOC_ROOT == t ? "<root>" : 
-                                       mdoc_macronames[tok]);
+       mandoc_vmsg(MANDOCERR_SYNTCHILD, mdoc->parse, n->line, 
+                       n->pos, "want parent %s", MDOC_ROOT == t ? 
+                       "<root>" : mdoc_macronames[tok]);
        return(0);
 }
 
@@ -570,21 +602,18 @@ pre_display(PRE_ARGS)
 {
        struct mdoc_node *node;
 
-       /* Display elements (`Bd', `D1'...) cannot be nested. */
-
        if (MDOC_BLOCK != n->type)
                return(1);
 
-       /* LINTED */
        for (node = mdoc->last->parent; node; node = node->parent) 
                if (MDOC_BLOCK == node->type)
                        if (MDOC_Bd == node->tok)
                                break;
-       if (NULL == node)
-               return(1);
 
-       mdoc_nmsg(mdoc, n, MANDOCERR_NESTEDDISP);
-       return(0);
+       if (node)
+               mdoc_nmsg(mdoc, n, MANDOCERR_NESTEDDISP);
+
+       return(1);
 }
 
 
@@ -606,8 +635,6 @@ pre_bl(PRE_ARGS)
                assert(np);
                assert(MDOC_BLOCK == np->type);
                assert(MDOC_Bl == np->tok);
-               assert(np->data.Bl);
-               n->data.Bl = np->data.Bl;
                return(1);
        }
 
@@ -617,9 +644,6 @@ pre_bl(PRE_ARGS)
         * ones.  If we find no list type, we default to LIST_item.
         */
 
-       assert(NULL == n->data.Bl);
-       n->data.Bl = mandoc_calloc(1, sizeof(struct mdoc_bl));
-
        /* LINTED */
        for (i = 0; n->args && i < (int)n->args->argc; i++) {
                lt = LIST__NONE;
@@ -662,22 +686,21 @@ pre_bl(PRE_ARGS)
                        break;
                /* Set list arguments. */
                case (MDOC_Compact):
-                       dup = n->data.Bl->comp;
+                       dup = n->norm->Bl.comp;
                        comp = 1;
                        break;
                case (MDOC_Width):
-                       dup = (NULL != n->data.Bl->width);
+                       dup = (NULL != n->norm->Bl.width);
                        width = n->args->argv[i].value[0];
                        break;
                case (MDOC_Offset):
                        /* NB: this can be empty! */
                        if (n->args->argv[i].sz) {
                                offs = n->args->argv[i].value[0];
-                               dup = (NULL != n->data.Bl->offs);
+                               dup = (NULL != n->norm->Bl.offs);
                                break;
                        }
-                       if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_IGNARGV))
-                               return(0);
+                       mdoc_nmsg(mdoc, n, MANDOCERR_IGNARGV);
                        break;
                default:
                        continue;
@@ -685,53 +708,50 @@ pre_bl(PRE_ARGS)
 
                /* Check: duplicate auxiliary arguments. */
 
-               if (dup && ! mdoc_nmsg(mdoc, n, MANDOCERR_ARGVREP))
-                       return(0);
+               if (dup)
+                       mdoc_nmsg(mdoc, n, MANDOCERR_ARGVREP);
 
                if (comp && ! dup)
-                       n->data.Bl->comp = comp;
+                       n->norm->Bl.comp = comp;
                if (offs && ! dup)
-                       n->data.Bl->offs = offs;
+                       n->norm->Bl.offs = offs;
                if (width && ! dup)
-                       n->data.Bl->width = width;
+                       n->norm->Bl.width = width;
 
                /* Check: multiple list types. */
 
-               if (LIST__NONE != lt && n->data.Bl->type != LIST__NONE)
-                       if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_LISTREP))
-                               return(0);
+               if (LIST__NONE != lt && n->norm->Bl.type != LIST__NONE)
+                       mdoc_nmsg(mdoc, n, MANDOCERR_LISTREP);
 
                /* Assign list type. */
 
-               if (LIST__NONE != lt && n->data.Bl->type == LIST__NONE) {
-                       n->data.Bl->type = lt;
+               if (LIST__NONE != lt && n->norm->Bl.type == LIST__NONE) {
+                       n->norm->Bl.type = lt;
                        /* Set column information, too. */
                        if (LIST_column == lt) {
-                               n->data.Bl->ncols = 
+                               n->norm->Bl.ncols = 
                                        n->args->argv[i].sz;
-                               n->data.Bl->cols = (const char **)
+                               n->norm->Bl.cols = (const char **)
                                        n->args->argv[i].value;
                        }
                }
 
                /* The list type should come first. */
 
-               if (n->data.Bl->type == LIST__NONE)
-                       if (n->data.Bl->width || 
-                                       n->data.Bl->offs || 
-                                       n->data.Bl->comp)
-                               if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_LISTFIRST))
-                                       return(0);
+               if (n->norm->Bl.type == LIST__NONE)
+                       if (n->norm->Bl.width || 
+                                       n->norm->Bl.offs || 
+                                       n->norm->Bl.comp)
+                               mdoc_nmsg(mdoc, n, MANDOCERR_LISTFIRST);
 
                continue;
        }
 
        /* Allow lists to default to LIST_item. */
 
-       if (LIST__NONE == n->data.Bl->type) {
-               if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_LISTTYPE))
-                       return(0);
-               n->data.Bl->type = LIST_item;
+       if (LIST__NONE == n->norm->Bl.type) {
+               mdoc_nmsg(mdoc, n, MANDOCERR_LISTTYPE);
+               n->norm->Bl.type = LIST_item;
        }
 
        /* 
@@ -740,13 +760,12 @@ pre_bl(PRE_ARGS)
         * and must also be warned.
         */
 
-       switch (n->data.Bl->type) {
+       switch (n->norm->Bl.type) {
        case (LIST_tag):
-               if (n->data.Bl->width)
+               if (n->norm->Bl.width)
                        break;
-               if (mdoc_nmsg(mdoc, n, MANDOCERR_NOWIDTHARG))
-                       break;
-               return(0);
+               mdoc_nmsg(mdoc, n, MANDOCERR_NOWIDTHARG);
+               break;
        case (LIST_column):
                /* FALLTHROUGH */
        case (LIST_diag):
@@ -756,11 +775,9 @@ pre_bl(PRE_ARGS)
        case (LIST_inset):
                /* FALLTHROUGH */
        case (LIST_item):
-               if (NULL == n->data.Bl->width)
-                       break;
-               if (mdoc_nmsg(mdoc, n, MANDOCERR_WIDTHARG))
-                       break;
-               return(0);
+               if (n->norm->Bl.width)
+                       mdoc_nmsg(mdoc, n, MANDOCERR_IGNARGV);
+               break;
        default:
                break;
        }
@@ -787,14 +804,9 @@ pre_bd(PRE_ARGS)
                assert(np);
                assert(MDOC_BLOCK == np->type);
                assert(MDOC_Bd == np->tok);
-               assert(np->data.Bd);
-               n->data.Bd = np->data.Bd;
                return(1);
        }
 
-       assert(NULL == n->data.Bd);
-       n->data.Bd = mandoc_calloc(1, sizeof(struct mdoc_bd));
-
        /* LINTED */
        for (i = 0; n->args && i < (int)n->args->argc; i++) {
                dt = DISP__NONE;
@@ -824,15 +836,14 @@ pre_bd(PRE_ARGS)
                        /* NB: this can be empty! */
                        if (n->args->argv[i].sz) {
                                offs = n->args->argv[i].value[0];
-                               dup = (NULL != n->data.Bd->offs);
+                               dup = (NULL != n->norm->Bd.offs);
                                break;
                        }
-                       if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_IGNARGV))
-                               return(0);
+                       mdoc_nmsg(mdoc, n, MANDOCERR_IGNARGV);
                        break;
                case (MDOC_Compact):
                        comp = 1;
-                       dup = n->data.Bd->comp;
+                       dup = n->norm->Bd.comp;
                        break;
                default:
                        abort();
@@ -841,32 +852,30 @@ pre_bd(PRE_ARGS)
 
                /* Check whether we have duplicates. */
 
-               if (dup && ! mdoc_nmsg(mdoc, n, MANDOCERR_ARGVREP))
-                       return(0);
+               if (dup)
+                       mdoc_nmsg(mdoc, n, MANDOCERR_ARGVREP);
 
                /* Make our auxiliary assignments. */
 
                if (offs && ! dup)
-                       n->data.Bd->offs = offs;
+                       n->norm->Bd.offs = offs;
                if (comp && ! dup)
-                       n->data.Bd->comp = comp;
+                       n->norm->Bd.comp = comp;
 
                /* Check whether a type has already been assigned. */
 
-               if (DISP__NONE != dt && n->data.Bd->type != DISP__NONE)
-                       if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_DISPREP))
-                               return(0);
+               if (DISP__NONE != dt && n->norm->Bd.type != DISP__NONE)
+                       mdoc_nmsg(mdoc, n, MANDOCERR_DISPREP);
 
                /* Make our type assignment. */
 
-               if (DISP__NONE != dt && n->data.Bd->type == DISP__NONE)
-                       n->data.Bd->type = dt;
+               if (DISP__NONE != dt && n->norm->Bd.type == DISP__NONE)
+                       n->norm->Bd.type = dt;
        }
 
-       if (DISP__NONE == n->data.Bd->type) {
-               if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_DISPTYPE))
-                       return(0);
-               n->data.Bd->type = DISP_ragged;
+       if (DISP__NONE == n->norm->Bd.type) {
+               mdoc_nmsg(mdoc, n, MANDOCERR_DISPTYPE);
+               n->norm->Bd.type = DISP_ragged;
        }
 
        return(1);
@@ -901,10 +910,7 @@ pre_it(PRE_ARGS)
 
        if (MDOC_BLOCK != n->type)
                return(1);
-       /* 
-        * FIXME: this can probably be lifted if we make the It into
-        * something else on-the-fly?
-        */
+
        return(check_parent(mdoc, n, MDOC_Bl, MDOC_BODY));
 }
 
@@ -918,86 +924,67 @@ pre_an(PRE_ARGS)
                return(1);
        
        for (i = 1; i < (int)n->args->argc; i++)
-               if ( ! mdoc_pmsg(mdoc, n->args->argv[i].line,
-                       n->args->argv[i].pos, MANDOCERR_IGNARGV))
-                       return(0);
+               mdoc_pmsg(mdoc, n->args->argv[i].line, 
+                       n->args->argv[i].pos, MANDOCERR_IGNARGV);
 
        if (MDOC_Split == n->args->argv[0].arg)
-               n->data.An.auth = AUTH_split;
+               n->norm->An.auth = AUTH_split;
        else if (MDOC_Nosplit == n->args->argv[0].arg)
-               n->data.An.auth = AUTH_nosplit;
+               n->norm->An.auth = AUTH_nosplit;
        else
                abort();
 
        return(1);
 }
 
-
-static int
-pre_rv(PRE_ARGS)
-{
-
-       return(check_stdarg(mdoc, n));
-}
-
-
 static int
-post_dt(POST_ARGS)
+pre_std(PRE_ARGS)
 {
-       const struct mdoc_node *nn;
-       const char      *p;
 
-       if (NULL != (nn = mdoc->last->child))
-               for (p = nn->string; *p; p++) {
-                       if (toupper((u_char)*p) == *p)
-                               continue;
-                       if ( ! mdoc_nmsg(mdoc, nn, MANDOCERR_UPPERCASE))
-                               return(0);
-                       break;
-               }
+       if (n->args && 1 == n->args->argc)
+               if (MDOC_Std == n->args->argv[0].arg)
+                       return(1);
 
+       mdoc_nmsg(mdoc, n, MANDOCERR_NOARGV);
        return(1);
 }
 
-
 static int
 pre_dt(PRE_ARGS)
 {
 
-       if (0 == mdoc->meta.date || mdoc->meta.os)
-               if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGOOO))
-                       return(0);
+       if (NULL == mdoc->meta.date || mdoc->meta.os)
+               mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGOOO);
+
        if (mdoc->meta.title)
-               if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGREP))
-                       return(0);
+               mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGREP);
+
        return(1);
 }
 
-
 static int
 pre_os(PRE_ARGS)
 {
 
-       if (NULL == mdoc->meta.title || 0 == mdoc->meta.date)
-               if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGOOO))
-                       return(0);
+       if (NULL == mdoc->meta.title || NULL == mdoc->meta.date)
+               mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGOOO);
+
        if (mdoc->meta.os)
-               if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGREP))
-                       return(0);
+               mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGREP);
+
        return(1);
 }
 
-
 static int
 pre_dd(PRE_ARGS)
 {
 
        if (mdoc->meta.title || mdoc->meta.os)
-               if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGOOO))
-                       return(0);
+               mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGOOO);
+
        if (mdoc->meta.date)
-               if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGREP))
-                       return(0);
+               mdoc_nmsg(mdoc, n, MANDOCERR_PROLOGREP);
+
        return(1);
 }
 
@@ -1025,15 +1012,12 @@ post_bf(POST_ARGS)
                assert(np);
                assert(MDOC_HEAD == np->type);
                assert(MDOC_Bf == np->tok);
-               assert(np->data.Bf);
-               mdoc->last->data.Bf = np->data.Bf;
                return(1);
        }
 
        np = mdoc->last;
        assert(MDOC_BLOCK == np->parent->type);
        assert(MDOC_Bf == np->parent->tok);
-       np->data.Bf = mandoc_calloc(1, sizeof(struct mdoc_bf));
 
        /* 
         * Cannot have both argument and parameter.
@@ -1043,19 +1027,21 @@ post_bf(POST_ARGS)
        if (np->parent->args && np->child) {
                mdoc_nmsg(mdoc, np, MANDOCERR_SYNTARGVCOUNT);
                return(0);
-       } else if (NULL == np->parent->args && NULL == np->child)
-               return(mdoc_nmsg(mdoc, np, MANDOCERR_FONTTYPE));
+       } else if (NULL == np->parent->args && NULL == np->child) {
+               mdoc_nmsg(mdoc, np, MANDOCERR_FONTTYPE);
+               return(1);
+       }
 
        /* Extract argument into data. */
        
        if (np->parent->args) {
                arg = np->parent->args->argv[0].arg;
                if (MDOC_Emphasis == arg)
-                       np->data.Bf->font = FONT_Em;
+                       np->norm->Bf.font = FONT_Em;
                else if (MDOC_Literal == arg)
-                       np->data.Bf->font = FONT_Li;
+                       np->norm->Bf.font = FONT_Li;
                else if (MDOC_Symbolic == arg)
-                       np->data.Bf->font = FONT_Sy;
+                       np->norm->Bf.font = FONT_Sy;
                else
                        abort();
                return(1);
@@ -1064,35 +1050,58 @@ post_bf(POST_ARGS)
        /* Extract parameter into data. */
 
        if (0 == strcmp(np->child->string, "Em"))
-               np->data.Bf->font = FONT_Em;
+               np->norm->Bf.font = FONT_Em;
        else if (0 == strcmp(np->child->string, "Li"))
-               np->data.Bf->font = FONT_Li;
+               np->norm->Bf.font = FONT_Li;
        else if (0 == strcmp(np->child->string, "Sy"))
-               np->data.Bf->font = FONT_Sy;
-       else if ( ! mdoc_nmsg(mdoc, np, MANDOCERR_FONTTYPE))
-               return(0);
+               np->norm->Bf.font = FONT_Sy;
+       else 
+               mdoc_nmsg(mdoc, np, MANDOCERR_FONTTYPE);
 
        return(1);
 }
 
-
 static int
 post_lb(POST_ARGS)
 {
+       const char      *p;
+       char            *buf;
+       size_t           sz;
+
+       check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_EQ, 1);
+
+       assert(mdoc->last->child);
+       assert(MDOC_TEXT == mdoc->last->child->type);
+
+       p = mdoc_a2lib(mdoc->last->child->string);
 
-       if (mdoc_a2lib(mdoc->last->child->string))
+       /* If lookup ok, replace with table value. */
+
+       if (p) {
+               free(mdoc->last->child->string);
+               mdoc->last->child->string = mandoc_strdup(p);
                return(1);
-       return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADLIB));
-}
+       }
+
+       /* If not, use "library ``xxxx''. */
 
+       sz = strlen(mdoc->last->child->string) +
+               2 + strlen("\\(lqlibrary\\(rq");
+       buf = mandoc_malloc(sz);
+       snprintf(buf, sz, "library \\(lq%s\\(rq", 
+                       mdoc->last->child->string);
+       free(mdoc->last->child->string);
+       mdoc->last->child->string = buf;
+       return(1);
+}
 
 static int
 post_eoln(POST_ARGS)
 {
 
-       if (NULL == mdoc->last->child)
-               return(1);
-       return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_ARGSLOST));
+       if (mdoc->last->child)
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_ARGSLOST);
+       return(1);
 }
 
 
@@ -1104,19 +1113,17 @@ post_vt(POST_ARGS)
        /*
         * The Vt macro comes in both ELEM and BLOCK form, both of which
         * have different syntaxes (yet more context-sensitive
-        * behaviour).  ELEM types must have a child; BLOCK types,
+        * behaviour).  ELEM types must have a child, which is already
+        * guaranteed by the in_line parsing routine; BLOCK types,
         * specifically the BODY, should only have TEXT children.
         */
 
-       if (MDOC_ELEM == mdoc->last->type)
-               return(eerr_ge1(mdoc));
        if (MDOC_BODY != mdoc->last->type)
                return(1);
        
        for (n = mdoc->last->child; n; n = n->next)
                if (MDOC_TEXT != n->type) 
-                       if ( ! mdoc_nmsg(mdoc, n, MANDOCERR_CHILD))
-                               return(0);
+                       mdoc_nmsg(mdoc, n, MANDOCERR_CHILD);
 
        return(1);
 }
@@ -1125,27 +1132,128 @@ post_vt(POST_ARGS)
 static int
 post_nm(POST_ARGS)
 {
+       char             buf[BUFSIZ];
 
-       if (mdoc->last->child)
+       /* If no child specified, make sure we have the meta name. */
+
+       if (NULL == mdoc->last->child && NULL == mdoc->meta.name) {
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NONAME);
                return(1);
-       if (mdoc->meta.name)
+       } else if (mdoc->meta.name)
                return(1);
-       return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NONAME));
+
+       /* If no meta name, set it from the child. */
+
+       if ( ! concat(mdoc, buf, mdoc->last->child, BUFSIZ))
+               return(0);
+
+       mdoc->meta.name = mandoc_strdup(buf);
+
+       return(1);
+}
+
+static int
+post_literal(POST_ARGS)
+{
+       
+       /*
+        * The `Dl' (note "el" not "one") and `Bd' macros unset the
+        * MDOC_LITERAL flag as they leave.  Note that `Bd' only sets
+        * this in literal mode, but it doesn't hurt to just switch it
+        * off in general since displays can't be nested.
+        */
+
+       if (MDOC_BODY == mdoc->last->type)
+               mdoc->flags &= ~MDOC_LITERAL;
+
+       return(1);
 }
 
+static int
+post_defaults(POST_ARGS)
+{
+       struct mdoc_node *nn;
+
+       /*
+        * The `Ar' defaults to "file ..." if no value is provided as an
+        * argument; the `Mt' and `Pa' macros use "~"; the `Li' just
+        * gets an empty string.
+        */
+
+       if (mdoc->last->child)
+               return(1);
+       
+       nn = mdoc->last;
+       mdoc->next = MDOC_NEXT_CHILD;
+
+       switch (nn->tok) {
+       case (MDOC_Ar):
+               if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, "file"))
+                       return(0);
+               if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, "..."))
+                       return(0);
+               break;
+       case (MDOC_At):
+               if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, "AT&T"))
+                       return(0);
+               if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, "UNIX"))
+                       return(0);
+               break;
+       case (MDOC_Li):
+               if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, ""))
+                       return(0);
+               break;
+       case (MDOC_Pa):
+               /* FALLTHROUGH */
+       case (MDOC_Mt):
+               if ( ! mdoc_word_alloc(mdoc, nn->line, nn->pos, "~"))
+                       return(0);
+               break;
+       default:
+               abort();
+               /* NOTREACHED */
+       } 
+
+       mdoc->last = nn;
+       return(1);
+}
 
 static int
 post_at(POST_ARGS)
 {
+       const char       *p, *q;
+       char             *buf;
+       size_t            sz;
 
+       /*
+        * If we have a child, look it up in the standard keys.  If a
+        * key exist, use that instead of the child; if it doesn't,
+        * prefix "AT&T UNIX " to the existing data.
+        */
+       
        if (NULL == mdoc->last->child)
                return(1);
+
        assert(MDOC_TEXT == mdoc->last->child->type);
-       if (mdoc_a2att(mdoc->last->child->string))
-               return(1);
-       return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADATT));
-}
+       p = mdoc_a2att(mdoc->last->child->string);
+
+       if (p) {
+               free(mdoc->last->child->string);
+               mdoc->last->child->string = mandoc_strdup(p);
+       } else {
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADATT);
+               p = "AT&T UNIX ";
+               q = mdoc->last->child->string;
+               sz = strlen(p) + strlen(q) + 1;
+               buf = mandoc_malloc(sz);
+               strlcpy(buf, p, sz);
+               strlcat(buf, q, sz);
+               free(mdoc->last->child->string);
+               mdoc->last->child->string = buf;
+       }
 
+       return(1);
+}
 
 static int
 post_an(POST_ARGS)
@@ -1153,22 +1261,20 @@ post_an(POST_ARGS)
        struct mdoc_node *np;
 
        np = mdoc->last;
-       if (AUTH__NONE != np->data.An.auth && np->child)
-               return(eerr_eq0(mdoc));
-       /* 
-        * FIXME: make this ewarn and make sure that the front-ends
-        * don't print the arguments.
-        */
-       if (AUTH__NONE != np->data.An.auth || np->child)
-               return(1);
-       return(mdoc_nmsg(mdoc, np, MANDOCERR_NOARGS));
+       if (AUTH__NONE == np->norm->An.auth) {
+               if (0 == np->child)
+                       check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_GT, 0);
+       } else if (np->child)
+               check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_EQ, 0);
+
+       return(1);
 }
 
 
 static int
 post_it(POST_ARGS)
 {
-       int               i, cols, rc;
+       int               i, cols;
        enum mdoc_list    lt;
        struct mdoc_node *n, *c;
        enum mandocerr    er;
@@ -1177,12 +1283,11 @@ post_it(POST_ARGS)
                return(1);
 
        n = mdoc->last->parent->parent;
-       assert(n->data.Bl);
-       lt = n->data.Bl->type;
+       lt = n->norm->Bl.type;
 
        if (LIST__NONE == lt) {
                mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_LISTTYPE);
-               return(0);
+               return(1);
        }
 
        switch (lt) {
@@ -1190,8 +1295,7 @@ post_it(POST_ARGS)
                if (mdoc->last->head->child)
                        break;
                /* FIXME: give this a dummy value. */
-               if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOARGS))
-                       return(0);
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOARGS);
                break;
        case (LIST_hang):
                /* FALLTHROUGH */
@@ -1201,8 +1305,7 @@ post_it(POST_ARGS)
                /* FALLTHROUGH */
        case (LIST_diag):
                if (NULL == mdoc->last->head->child)
-                       if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOARGS))
-                               return(0);
+                       mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOARGS);
                break;
        case (LIST_bullet):
                /* FALLTHROUGH */
@@ -1212,22 +1315,19 @@ post_it(POST_ARGS)
                /* FALLTHROUGH */
        case (LIST_hyphen):
                if (NULL == mdoc->last->body->child)
-                       if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOBODY))
-                               return(0);
+                       mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOBODY);
                /* FALLTHROUGH */
        case (LIST_item):
                if (mdoc->last->head->child)
-                       if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_ARGSLOST))
-                               return(0);
+                       mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_ARGSLOST);
                break;
        case (LIST_column):
-               cols = (int)n->data.Bl->ncols;
+               cols = (int)n->norm->Bl.ncols;
 
                assert(NULL == mdoc->last->head->child);
 
                if (NULL == mdoc->last->body->child)
-                       if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOBODY))
-                               return(0);
+                       mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NOBODY);
 
                for (i = 0, c = mdoc->last->child; c; c = c->next)
                        if (MDOC_BODY == c->type)
@@ -1240,10 +1340,10 @@ post_it(POST_ARGS)
                else
                        er = MANDOCERR_SYNTARGCOUNT;
 
-               rc = mdoc_vmsg(mdoc, er
-                               mdoc->last->line, mdoc->last->pos, 
+               mandoc_vmsg(er, mdoc->parse, mdoc->last->line
+                               mdoc->last->pos, 
                                "columns == %d (have %d)", cols, i);
-               return(rc);
+               return(MANDOCERR_ARGCOUNT == er);
        default:
                break;
        }
@@ -1251,110 +1351,329 @@ post_it(POST_ARGS)
        return(1);
 }
 
-
 static int
-post_bl_head(POST_ARGS) 
+post_bl_block(POST_ARGS) 
 {
        struct mdoc_node *n;
 
-       assert(mdoc->last->parent);
-       n = mdoc->last->parent;
+       /*
+        * These are fairly complicated, so we've broken them into two
+        * functions.  post_bl_block_tag() is called when a -tag is
+        * specified, but no -width (it must be guessed).  The second
+        * when a -width is specified (macro indicators must be
+        * rewritten into real lengths).
+        */
 
-       if (LIST_column == n->data.Bl->type) {
-               if (n->data.Bl->ncols && mdoc->last->nchild) {
-                       mdoc_nmsg(mdoc, n, MANDOCERR_COLUMNS);
+       n = mdoc->last;
+
+       if (LIST_tag == n->norm->Bl.type && 
+                       NULL == n->norm->Bl.width) {
+               if ( ! post_bl_block_tag(mdoc))
                        return(0);
-               }
+       } else if (NULL != n->norm->Bl.width) {
+               if ( ! post_bl_block_width(mdoc))
+                       return(0);
+       } else 
                return(1);
-       }
 
-       /* FIXME: should be ERROR class. */
-       return(hwarn_eq0(mdoc));
+       assert(n->norm->Bl.width);
+       return(1);
 }
 
-
 static int
-post_bl(POST_ARGS)
+post_bl_block_width(POST_ARGS)
 {
-       struct mdoc_node        *n;
+       size_t            width;
+       int               i;
+       enum mdoct        tok;
+       struct mdoc_node *n;
+       char              buf[NUMSIZ];
 
-       if (MDOC_HEAD == mdoc->last->type) 
-               return(post_bl_head(mdoc));
-       if (MDOC_BODY != mdoc->last->type)
-               return(1);
-       if (NULL == mdoc->last->child)
-               return(1);
+       n = mdoc->last;
 
        /*
-        * We only allow certain children of `Bl'.  This is usually on
-        * `It', but apparently `Sm' occurs here and there, so we let
-        * that one through, too.
+        * Calculate the real width of a list from the -width string,
+        * which may contain a macro (with a known default width), a
+        * literal string, or a scaling width.
+        *
+        * If the value to -width is a macro, then we re-write it to be
+        * the macro's width as set in share/tmac/mdoc/doc-common.
         */
 
-       /* LINTED */
-       for (n = mdoc->last->child; n; n = n->next) {
-               if (MDOC_BLOCK == n->type && MDOC_It == n->tok)
-                       continue;
-               if (MDOC_Sm == n->tok)
-                       continue;
-               mdoc_nmsg(mdoc, n, MANDOCERR_SYNTCHILD);
-               return(0);
+       if (0 == strcmp(n->norm->Bl.width, "Ds"))
+               width = 6;
+       else if (MDOC_MAX == (tok = mdoc_hash_find(n->norm->Bl.width)))
+               return(1);
+       else if (0 == (width = macro2len(tok)))  {
+               mdoc_nmsg(mdoc, n, MANDOCERR_BADWIDTH);
+               return(1);
        }
 
+       /* The value already exists: free and reallocate it. */
+
+       assert(n->args);
+
+       for (i = 0; i < (int)n->args->argc; i++) 
+               if (MDOC_Width == n->args->argv[i].arg)
+                       break;
+
+       assert(i < (int)n->args->argc);
+
+       snprintf(buf, NUMSIZ, "%zun", width);
+       free(n->args->argv[i].value[0]);
+       n->args->argv[i].value[0] = mandoc_strdup(buf);
+
+       /* Set our width! */
+       n->norm->Bl.width = n->args->argv[i].value[0];
        return(1);
 }
 
-
 static int
-ebool(struct mdoc *mdoc)
+post_bl_block_tag(POST_ARGS)
 {
-       struct mdoc_node *n;
+       struct mdoc_node *n, *nn;
+       size_t            sz, ssz;
+       int               i;
+       char              buf[NUMSIZ];
 
-       /* LINTED */
-       for (n = mdoc->last->child; n; n = n->next) {
-               if (MDOC_TEXT != n->type)
-                       break;
-               if (0 == strcmp(n->string, "on"))
-                       continue;
-               if (0 == strcmp(n->string, "off"))
+       /*
+        * Calculate the -width for a `Bl -tag' list if it hasn't been
+        * provided.  Uses the first head macro.  NOTE AGAIN: this is
+        * ONLY if the -width argument has NOT been provided.  See
+        * post_bl_block_width() for converting the -width string.
+        */
+
+       sz = 10;
+       n = mdoc->last;
+
+       for (nn = n->body->child; nn; nn = nn->next) {
+               if (MDOC_It != nn->tok)
                        continue;
+
+               assert(MDOC_BLOCK == nn->type);
+               nn = nn->head->child;
+
+               if (nn == NULL)
+                       break;
+
+               if (MDOC_TEXT == nn->type) {
+                       sz = strlen(nn->string) + 1;
+                       break;
+               }
+
+               if (0 != (ssz = macro2len(nn->tok)))
+                       sz = ssz;
+
                break;
+       } 
+
+       /* Defaults to ten ens. */
+
+       snprintf(buf, NUMSIZ, "%zun", sz);
+
+       /*
+        * We have to dynamically add this to the macro's argument list.
+        * We're guaranteed that a MDOC_Width doesn't already exist.
+        */
+
+       assert(n->args);
+       i = (int)(n->args->argc)++;
+
+       n->args->argv = mandoc_realloc(n->args->argv, 
+                       n->args->argc * sizeof(struct mdoc_argv));
+
+       n->args->argv[i].arg = MDOC_Width;
+       n->args->argv[i].line = n->line;
+       n->args->argv[i].pos = n->pos;
+       n->args->argv[i].sz = 1;
+       n->args->argv[i].value = mandoc_malloc(sizeof(char *));
+       n->args->argv[i].value[0] = mandoc_strdup(buf);
+
+       /* Set our width! */
+       n->norm->Bl.width = n->args->argv[i].value[0];
+       return(1);
+}
+
+
+static int
+post_bl_head(POST_ARGS) 
+{
+       struct mdoc_node *np, *nn, *nnp;
+       int               i, j;
+
+       if (LIST_column != mdoc->last->norm->Bl.type)
+               /* FIXME: this should be ERROR class... */
+               return(hwarn_eq0(mdoc));
+
+       /*
+        * Convert old-style lists, where the column width specifiers
+        * trail as macro parameters, to the new-style ("normal-form")
+        * lists where they're argument values following -column.
+        */
+
+       /* First, disallow both types and allow normal-form. */
+
+       /* 
+        * TODO: technically, we can accept both and just merge the two
+        * lists, but I'll leave that for another day.
+        */
+
+       if (mdoc->last->norm->Bl.ncols && mdoc->last->nchild) {
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_COLUMNS);
+               return(0);
+       } else if (NULL == mdoc->last->child)
+               return(1);
+
+       np = mdoc->last->parent;
+       assert(np->args);
+
+       for (j = 0; j < (int)np->args->argc; j++) 
+               if (MDOC_Column == np->args->argv[j].arg)
+                       break;
+
+       assert(j < (int)np->args->argc);
+       assert(0 == np->args->argv[j].sz);
+
+       /*
+        * Accommodate for new-style groff column syntax.  Shuffle the
+        * child nodes, all of which must be TEXT, as arguments for the
+        * column field.  Then, delete the head children.
+        */
+
+       np->args->argv[j].sz = (size_t)mdoc->last->nchild;
+       np->args->argv[j].value = mandoc_malloc
+               ((size_t)mdoc->last->nchild * sizeof(char *));
+
+       mdoc->last->norm->Bl.ncols = np->args->argv[j].sz;
+       mdoc->last->norm->Bl.cols = (const char **)np->args->argv[j].value;
+
+       for (i = 0, nn = mdoc->last->child; nn; i++) {
+               np->args->argv[j].value[i] = nn->string;
+               nn->string = NULL;
+               nnp = nn;
+               nn = nn->next;
+               mdoc_node_delete(NULL, nnp);
        }
 
-       if (NULL == n)
+       mdoc->last->nchild = 0;
+       mdoc->last->child = NULL;
+
+       return(1);
+}
+
+static int
+post_bl(POST_ARGS)
+{
+       struct mdoc_node        *n;
+
+       if (MDOC_HEAD == mdoc->last->type) 
+               return(post_bl_head(mdoc));
+       if (MDOC_BLOCK == mdoc->last->type)
+               return(post_bl_block(mdoc));
+       if (MDOC_BODY != mdoc->last->type)
                return(1);
-       return(mdoc_nmsg(mdoc, n, MANDOCERR_BADBOOL));
+
+       for (n = mdoc->last->child; n; n = n->next) {
+               switch (n->tok) {
+               case (MDOC_Lp):
+                       /* FALLTHROUGH */
+               case (MDOC_Pp):
+                       mdoc_nmsg(mdoc, n, MANDOCERR_CHILD);
+                       /* FALLTHROUGH */
+               case (MDOC_It):
+                       /* FALLTHROUGH */
+               case (MDOC_Sm):
+                       continue;
+               default:
+                       break;
+               }
+
+               mdoc_nmsg(mdoc, n, MANDOCERR_SYNTCHILD);
+               return(0);
+       }
+
+       return(1);
 }
 
+static int
+ebool(struct mdoc *mdoc)
+{
+
+       if (NULL == mdoc->last->child) {
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_MACROEMPTY);
+               mdoc_node_delete(mdoc, mdoc->last);
+               return(1);
+       }
+       check_count(mdoc, MDOC_ELEM, CHECK_WARN, CHECK_EQ, 1);
+
+       assert(MDOC_TEXT == mdoc->last->child->type);
+
+       if (0 == strcmp(mdoc->last->child->string, "on"))
+               return(1);
+       if (0 == strcmp(mdoc->last->child->string, "off"))
+               return(1);
+
+       mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADBOOL);
+       return(1);
+}
 
 static int
 post_root(POST_ARGS)
 {
+       int               erc;
+       struct mdoc_node *n;
+
+       erc = 0;
+
+       /* Check that we have a finished prologue. */
 
-       if (NULL == mdoc->first->child)
-               mdoc_nmsg(mdoc, mdoc->first, MANDOCERR_NODOCBODY);
-       else if ( ! (MDOC_PBODY & mdoc->flags))
+       if ( ! (MDOC_PBODY & mdoc->flags)) {
+               erc++;
                mdoc_nmsg(mdoc, mdoc->first, MANDOCERR_NODOCPROLOG);
-       else if (MDOC_BLOCK != mdoc->first->child->type)
-               mdoc_nmsg(mdoc, mdoc->first, MANDOCERR_NODOCBODY);
-       else if (MDOC_Sh != mdoc->first->child->tok)
-               mdoc_nmsg(mdoc, mdoc->first, MANDOCERR_NODOCBODY);
-       else
-               return(1);
+       }
 
-       return(0);
-}
+       n = mdoc->first;
+       assert(n);
+       
+       /* Check that we begin with a proper `Sh'. */
+
+       if (NULL == n->child) {
+               erc++;
+               mdoc_nmsg(mdoc, n, MANDOCERR_NODOCBODY);
+       } else if (MDOC_BLOCK != n->child->type || 
+                       MDOC_Sh != n->child->tok) {
+               erc++;
+               /* Can this be lifted?  See rxdebug.1 for example. */
+               mdoc_nmsg(mdoc, n, MANDOCERR_NODOCBODY);
+       }
 
+       return(erc ? 0 : 1);
+}
 
 static int
 post_st(POST_ARGS)
 {
+       struct mdoc_node         *ch;
+       const char               *p;
 
-       if (mdoc_a2st(mdoc->last->child->string))
+       if (NULL == (ch = mdoc->last->child)) {
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_MACROEMPTY);
+               mdoc_node_delete(mdoc, mdoc->last);
                return(1);
-       return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADSTANDARD));
-}
+       }
 
+       assert(MDOC_TEXT == ch->type);
+
+       if (NULL == (p = mdoc_a2st(ch->string))) {
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADSTANDARD);
+               mdoc_node_delete(mdoc, mdoc->last);
+       } else {
+               free(ch->string);
+               ch->string = mandoc_strdup(p);
+       }
+
+       return(1);
+}
 
 static int
 post_rs(POST_ARGS)
@@ -1362,8 +1681,18 @@ post_rs(POST_ARGS)
        struct mdoc_node *nn, *next, *prev;
        int               i, j;
 
-       if (MDOC_BODY != mdoc->last->type)
+       switch (mdoc->last->type) {
+       case (MDOC_HEAD):
+               check_count(mdoc, MDOC_HEAD, CHECK_WARN, CHECK_EQ, 0);
                return(1);
+       case (MDOC_BODY):
+               if (mdoc->last->child)
+                       break;
+               check_count(mdoc, MDOC_BODY, CHECK_WARN, CHECK_GT, 0);
+               return(1);
+       default:
+               return(1);
+       }
 
        /*
         * Make sure only certain types of nodes are allowed within the
@@ -1378,6 +1707,8 @@ post_rs(POST_ARGS)
                                break;
 
                if (i < RSORD_MAX) {
+                       if (MDOC__J == rsord[i] || MDOC__B == rsord[i])
+                               mdoc->last->norm->Rs.quote_T++;
                        next = nn->next;
                        continue;
                }
@@ -1452,6 +1783,14 @@ post_rs(POST_ARGS)
        return(1);
 }
 
+static int
+post_ns(POST_ARGS)
+{
+
+       if (MDOC_LINE & mdoc->last->flags)
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_IGNNS);
+       return(1);
+}
 
 static int
 post_sh(POST_ARGS)
@@ -1465,7 +1804,6 @@ post_sh(POST_ARGS)
        return(1);
 }
 
-
 static int
 post_sh_body(POST_ARGS)
 {
@@ -1480,99 +1818,99 @@ post_sh_body(POST_ARGS)
         * children of the BODY declaration can also be "text".
         */
 
-       if (NULL == (n = mdoc->last->child))
-               return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADNAMESEC));
+       if (NULL == (n = mdoc->last->child)) {
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADNAMESEC);
+               return(1);
+       }
 
        for ( ; n && n->next; n = n->next) {
                if (MDOC_ELEM == n->type && MDOC_Nm == n->tok)
                        continue;
                if (MDOC_TEXT == n->type)
                        continue;
-               if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADNAMESEC))
-                       return(0);
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADNAMESEC);
        }
 
        assert(n);
        if (MDOC_BLOCK == n->type && MDOC_Nd == n->tok)
                return(1);
-       return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADNAMESEC));
-}
 
+       mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_BADNAMESEC);
+       return(1);
+}
 
 static int
 post_sh_head(POST_ARGS)
 {
-       char                    buf[BUFSIZ];
-       enum mdoc_sec           sec;
-       const struct mdoc_node *n;
+       char             buf[BUFSIZ];
+       enum mdoc_sec    sec;
 
        /*
         * Process a new section.  Sections are either "named" or
-        * "custom"; custom sections are user-defined, while named ones
-        * usually follow a conventional order and may only appear in
-        * certain manual sections.
+        * "custom".  Custom sections are user-defined, while named ones
+        * follow a conventional order and may only appear in certain
+        * manual sections.
         */
 
-       buf[0] = '\0';
+       if ( ! concat(mdoc, buf, mdoc->last->child, BUFSIZ))
+               return(0);
 
-       /*
-        * FIXME: yes, these can use a dynamic buffer, but I don't do so
-        * in the interests of simplicity.
-        */
+       sec = a2sec(buf);
 
-       for (n = mdoc->last->child; n; n = n->next) {
-               /* XXX - copied from compact(). */
-               assert(MDOC_TEXT == n->type);
+       /* The NAME should be first. */
 
-               if (strlcat(buf, n->string, BUFSIZ) >= BUFSIZ) {
-                       mdoc_nmsg(mdoc, n, MANDOCERR_MEM);
-                       return(0);
-               }
-               if (NULL == n->next)
-                       continue;
-               if (strlcat(buf, " ", BUFSIZ) >= BUFSIZ) {
-                       mdoc_nmsg(mdoc, n, MANDOCERR_MEM);
-                       return(0);
-               }
-       }
+       if (SEC_NAME != sec && SEC_NONE == mdoc->lastnamed)
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NAMESECFIRST);
 
-       sec = mdoc_str2sec(buf);
+       /* The SYNOPSIS gets special attention in other areas. */
 
-       /* 
-        * Check: NAME should always be first, CUSTOM has no roles,
-        * non-CUSTOM has a conventional order to be followed.
-        */
+       if (SEC_SYNOPSIS == sec)
+               mdoc->flags |= MDOC_SYNOPSIS;
+       else
+               mdoc->flags &= ~MDOC_SYNOPSIS;
 
-       if (SEC_NAME != sec && SEC_NONE == mdoc->lastnamed)
-               if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_NAMESECFIRST))
-                       return(0);
+       /* Mark our last section. */
+
+       mdoc->lastsec = sec;
+
+       /* We don't care about custom sections after this. */
 
        if (SEC_CUSTOM == sec)
                return(1);
 
+       /*
+        * Check whether our non-custom section is being repeated or is
+        * out of order.
+        */
+
        if (sec == mdoc->lastnamed)
-               if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SECREP))
-                       return(0);
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SECREP);
 
        if (sec < mdoc->lastnamed)
-               if ( ! mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SECOOO))
-                       return(0);
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SECOOO);
 
-       /* 
-        * Check particular section/manual conventions.  LIBRARY can
-        * only occur in manual section 2, 3, and 9.
-        */
+       /* Mark the last named section. */
+
+       mdoc->lastnamed = sec;
+
+       /* Check particular section/manual conventions. */
+
+       assert(mdoc->meta.msec);
 
        switch (sec) {
+       case (SEC_RETURN_VALUES):
+               /* FALLTHROUGH */
+       case (SEC_ERRORS):
+               /* FALLTHROUGH */
        case (SEC_LIBRARY):
-               assert(mdoc->meta.msec);
                if (*mdoc->meta.msec == '2')
                        break;
                if (*mdoc->meta.msec == '3')
                        break;
                if (*mdoc->meta.msec == '9')
                        break;
-               return(mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SECMSEC));
+               mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_SECMSEC);
+               break;
        default:
                break;
        }
@@ -1580,25 +1918,478 @@ post_sh_head(POST_ARGS)
        return(1);
 }
 
+static int
+post_ignpar(POST_ARGS)
+{
+       struct mdoc_node *np;
+
+       if (MDOC_BODY != mdoc->last->type)
+               return(1);
+
+       if (NULL != (np = mdoc->last->child))
+               if (MDOC_Pp == np->tok || MDOC_Lp == np->tok) {
+                       mdoc_nmsg(mdoc, np, MANDOCERR_IGNPAR);
+                       mdoc_node_delete(mdoc, np);
+               }
+
+       if (NULL != (np = mdoc->last->last))
+               if (MDOC_Pp == np->tok || MDOC_Lp == np->tok) {
+                       mdoc_nmsg(mdoc, np, MANDOCERR_IGNPAR);
+                       mdoc_node_delete(mdoc, np);
+               }
+
+       return(1);
+}
 
 static int
-pre_pp(PRE_ARGS)
+pre_par(PRE_ARGS)
 {
 
        if (NULL == mdoc->last)
                return(1);
+       if (MDOC_ELEM != n->type && MDOC_BLOCK != n->type)
+               return(1);
 
-       /* Don't allow prior `Lp' or `Pp'. */
+       /* 
+        * Don't allow prior `Lp' or `Pp' prior to a paragraph-type
+        * block:  `Lp', `Pp', or non-compact `Bd' or `Bl'.
+        */
 
        if (MDOC_Pp != mdoc->last->tok && MDOC_Lp != mdoc->last->tok)
                return(1);
-
-       if (MDOC_Bl == n->tok && n->data.Bl->comp)
+       if (MDOC_Bl == n->tok && n->norm->Bl.comp)
+               return(1);
+       if (MDOC_Bd == n->tok && n->norm->Bd.comp)
                return(1);
-       if (MDOC_Bd == n->tok && n->data.Bd->comp)
+       if (MDOC_It == n->tok && n->parent->norm->Bl.comp)
                return(1);
 
        mdoc_nmsg(mdoc, mdoc->last, MANDOCERR_IGNPAR);
        mdoc_node_delete(mdoc, mdoc->last);
        return(1);
 }
+
+static int
+pre_literal(PRE_ARGS)
+{
+
+       if (MDOC_BODY != n->type)
+               return(1);
+
+       /*
+        * The `Dl' (note "el" not "one") and `Bd -literal' and `Bd
+        * -unfilled' macros set MDOC_LITERAL on entrance to the body.
+        */
+
+       switch (n->tok) {
+       case (MDOC_Dl):
+               mdoc->flags |= MDOC_LITERAL;
+               break;
+       case (MDOC_Bd):
+               if (DISP_literal == n->norm->Bd.type)
+                       mdoc->flags |= MDOC_LITERAL;
+               if (DISP_unfilled == n->norm->Bd.type)
+                       mdoc->flags |= MDOC_LITERAL;
+               break;
+       default:
+               abort();
+               /* NOTREACHED */
+       }
+       
+       return(1);
+}
+
+static int
+post_dd(POST_ARGS)
+{
+       char              buf[DATESIZE];
+       struct mdoc_node *n;
+
+       if (mdoc->meta.date)
+               free(mdoc->meta.date);
+
+       n = mdoc->last;
+       if (NULL == n->child || '\0' == n->child->string[0]) {
+               mdoc->meta.date = mandoc_normdate
+                       (mdoc->parse, NULL, n->line, n->pos);
+               return(1);
+       }
+
+       if ( ! concat(mdoc, buf, n->child, DATESIZE))
+               return(0);
+
+       mdoc->meta.date = mandoc_normdate
+               (mdoc->parse, buf, n->line, n->pos);
+
+       return(1);
+}
+
+static int
+post_dt(POST_ARGS)
+{
+       struct mdoc_node *nn, *n;
+       const char       *cp;
+       char             *p;
+
+       n = mdoc->last;
+
+       if (mdoc->meta.title)
+               free(mdoc->meta.title);
+       if (mdoc->meta.vol)
+               free(mdoc->meta.vol);
+       if (mdoc->meta.arch)
+               free(mdoc->meta.arch);
+
+       mdoc->meta.title = mdoc->meta.vol = mdoc->meta.arch = NULL;
+
+       /* First make all characters uppercase. */
+
+       if (NULL != (nn = n->child))
+               for (p = nn->string; *p; p++) {
+                       if (toupper((u_char)*p) == *p)
+                               continue;
+
+                       /* 
+                        * FIXME: don't be lazy: have this make all
+                        * characters be uppercase and just warn once.
+                        */
+                       mdoc_nmsg(mdoc, nn, MANDOCERR_UPPERCASE);
+                       break;
+               }
+
+       /* Handles: `.Dt' 
+        *   --> title = unknown, volume = local, msec = 0, arch = NULL
+        */
+
+       if (NULL == (nn = n->child)) {
+               /* XXX: make these macro values. */
+               /* FIXME: warn about missing values. */
+               mdoc->meta.title = mandoc_strdup("UNKNOWN");
+               mdoc->meta.vol = mandoc_strdup("LOCAL");
+               mdoc->meta.msec = mandoc_strdup("1");
+               return(1);
+       }
+
+       /* Handles: `.Dt TITLE' 
+        *   --> title = TITLE, volume = local, msec = 0, arch = NULL
+        */
+
+       mdoc->meta.title = mandoc_strdup
+               ('\0' == nn->string[0] ? "UNKNOWN" : nn->string);
+
+       if (NULL == (nn = nn->next)) {
+               /* FIXME: warn about missing msec. */
+               /* XXX: make this a macro value. */
+               mdoc->meta.vol = mandoc_strdup("LOCAL");
+               mdoc->meta.msec = mandoc_strdup("1");
+               return(1);
+       }
+
+       /* Handles: `.Dt TITLE SEC'
+        *   --> title = TITLE, volume = SEC is msec ? 
+        *           format(msec) : SEC,
+        *       msec = SEC is msec ? atoi(msec) : 0,
+        *       arch = NULL
+        */
+
+       cp = mdoc_a2msec(nn->string);
+       if (cp) {
+               mdoc->meta.vol = mandoc_strdup(cp);
+               mdoc->meta.msec = mandoc_strdup(nn->string);
+       } else {
+               mdoc_nmsg(mdoc, n, MANDOCERR_BADMSEC);
+               mdoc->meta.vol = mandoc_strdup(nn->string);
+               mdoc->meta.msec = mandoc_strdup(nn->string);
+       } 
+
+       if (NULL == (nn = nn->next))
+               return(1);
+
+       /* Handles: `.Dt TITLE SEC VOL'
+        *   --> title = TITLE, volume = VOL is vol ?
+        *       format(VOL) : 
+        *           VOL is arch ? format(arch) : 
+        *               VOL
+        */
+
+       cp = mdoc_a2vol(nn->string);
+       if (cp) {
+               free(mdoc->meta.vol);
+               mdoc->meta.vol = mandoc_strdup(cp);
+       } else {
+               /* FIXME: warn about bad arch. */
+               cp = mdoc_a2arch(nn->string);
+               if (NULL == cp) {
+                       free(mdoc->meta.vol);
+                       mdoc->meta.vol = mandoc_strdup(nn->string);
+               } else 
+                       mdoc->meta.arch = mandoc_strdup(cp);
+       }       
+
+       /* Ignore any subsequent parameters... */
+       /* FIXME: warn about subsequent parameters. */
+
+       return(1);
+}
+
+static int
+post_prol(POST_ARGS)
+{
+       /*
+        * Remove prologue macros from the document after they're
+        * processed.  The final document uses mdoc_meta for these
+        * values and discards the originals.
+        */
+
+       mdoc_node_delete(mdoc, mdoc->last);
+       if (mdoc->meta.title && mdoc->meta.date && mdoc->meta.os)
+               mdoc->flags |= MDOC_PBODY;
+
+       return(1);
+}
+
+static int
+post_bx(POST_ARGS)
+{
+       struct mdoc_node        *n;
+
+       /* 
+        * Make `Bx's second argument always start with an uppercase
+        * letter.  Groff checks if it's an "accepted" term, but we just
+        * uppercase blindly.
+        */
+
+       n = mdoc->last->child;
+       if (n && NULL != (n = n->next))
+               *n->string = (char)toupper
+                       ((unsigned char)*n->string);
+
+       return(1);
+}
+
+static int
+post_os(POST_ARGS)
+{
+       struct mdoc_node *n;
+       char              buf[BUFSIZ];
+#ifndef OSNAME
+       struct utsname    utsname;
+#endif
+
+       n = mdoc->last;
+
+       /*
+        * Set the operating system by way of the `Os' macro.  Note that
+        * if an argument isn't provided and -DOSNAME="\"foo\"" is
+        * provided during compilation, this value will be used instead
+        * of filling in "sysname release" from uname().
+        */
+
+       if (mdoc->meta.os)
+               free(mdoc->meta.os);
+
+       if ( ! concat(mdoc, buf, n->child, BUFSIZ))
+               return(0);
+
+       /* XXX: yes, these can all be dynamically-adjusted buffers, but
+        * it's really not worth the extra hackery.
+        */
+
+       if ('\0' == buf[0]) {
+#ifdef OSNAME
+               if (strlcat(buf, OSNAME, BUFSIZ) >= BUFSIZ) {
+                       mdoc_nmsg(mdoc, n, MANDOCERR_MEM);
+                       return(0);
+               }
+#else /*!OSNAME */
+               if (-1 == uname(&utsname)) {
+                       mdoc_nmsg(mdoc, n, MANDOCERR_UNAME);
+                        mdoc->meta.os = mandoc_strdup("UNKNOWN");
+                        return(post_prol(mdoc));
+                }
+
+               if (strlcat(buf, utsname.sysname, BUFSIZ) >= BUFSIZ) {
+                       mdoc_nmsg(mdoc, n, MANDOCERR_MEM);
+                       return(0);
+               }
+               if (strlcat(buf, " ", BUFSIZ) >= BUFSIZ) {
+                       mdoc_nmsg(mdoc, n, MANDOCERR_MEM);
+                       return(0);
+               }
+               if (strlcat(buf, utsname.release, BUFSIZ) >= BUFSIZ) {
+                       mdoc_nmsg(mdoc, n, MANDOCERR_MEM);
+                       return(0);
+               }
+#endif /*!OSNAME*/
+       }
+
+       mdoc->meta.os = mandoc_strdup(buf);
+       return(1);
+}
+
+static int
+post_std(POST_ARGS)
+{
+       struct mdoc_node *nn, *n;
+
+       n = mdoc->last;
+
+       /*
+        * Macros accepting `-std' as an argument have the name of the
+        * current document (`Nm') filled in as the argument if it's not
+        * provided.
+        */
+
+       if (n->child)
+               return(1);
+
+       if (NULL == mdoc->meta.name)
+               return(1);
+       
+       nn = n;
+       mdoc->next = MDOC_NEXT_CHILD;
+
+       if ( ! mdoc_word_alloc(mdoc, n->line, n->pos, mdoc->meta.name))
+               return(0);
+
+       mdoc->last = nn;
+       return(1);
+}
+
+static int
+concat(struct mdoc *m, char *p, const struct mdoc_node *n, size_t sz)
+{
+
+       p[0] = '\0';
+
+       /*
+        * Concatenate sibling nodes together.  All siblings must be of
+        * type MDOC_TEXT or an assertion is raised.  Concatenation is
+        * separated by a single whitespace.  Returns 0 on fatal (string
+        * overrun) error.
+        */
+
+       for ( ; n; n = n->next) {
+               assert(MDOC_TEXT == n->type);
+
+               if (strlcat(p, n->string, sz) >= sz) {
+                       mdoc_nmsg(m, n, MANDOCERR_MEM);
+                       return(0);
+               }
+
+               if (NULL == n->next)
+                       continue;
+
+               if (strlcat(p, " ", sz) >= sz) {
+                       mdoc_nmsg(m, n, MANDOCERR_MEM);
+                       return(0);
+               }
+       }
+
+       return(1);
+}
+
+static enum mdoc_sec 
+a2sec(const char *p)
+{
+       int              i;
+
+       for (i = 0; i < (int)SEC__MAX; i++) 
+               if (secnames[i] && 0 == strcmp(p, secnames[i]))
+                       return((enum mdoc_sec)i);
+
+       return(SEC_CUSTOM);
+}
+
+static size_t
+macro2len(enum mdoct macro)
+{
+
+       switch (macro) {
+       case(MDOC_Ad):
+               return(12);
+       case(MDOC_Ao):
+               return(12);
+       case(MDOC_An):
+               return(12);
+       case(MDOC_Aq):
+               return(12);
+       case(MDOC_Ar):
+               return(12);
+       case(MDOC_Bo):
+               return(12);
+       case(MDOC_Bq):
+               return(12);
+       case(MDOC_Cd):
+               return(12);
+       case(MDOC_Cm):
+               return(10);
+       case(MDOC_Do):
+               return(10);
+       case(MDOC_Dq):
+               return(12);
+       case(MDOC_Dv):
+               return(12);
+       case(MDOC_Eo):
+               return(12);
+       case(MDOC_Em):
+               return(10);
+       case(MDOC_Er):
+               return(17);
+       case(MDOC_Ev):
+               return(15);
+       case(MDOC_Fa):
+               return(12);
+       case(MDOC_Fl):
+               return(10);
+       case(MDOC_Fo):
+               return(16);
+       case(MDOC_Fn):
+               return(16);
+       case(MDOC_Ic):
+               return(10);
+       case(MDOC_Li):
+               return(16);
+       case(MDOC_Ms):
+               return(6);
+       case(MDOC_Nm):
+               return(10);
+       case(MDOC_No):
+               return(12);
+       case(MDOC_Oo):
+               return(10);
+       case(MDOC_Op):
+               return(14);
+       case(MDOC_Pa):
+               return(32);
+       case(MDOC_Pf):
+               return(12);
+       case(MDOC_Po):
+               return(12);
+       case(MDOC_Pq):
+               return(12);
+       case(MDOC_Ql):
+               return(16);
+       case(MDOC_Qo):
+               return(12);
+       case(MDOC_So):
+               return(12);
+       case(MDOC_Sq):
+               return(12);
+       case(MDOC_Sy):
+               return(6);
+       case(MDOC_Sx):
+               return(16);
+       case(MDOC_Tn):
+               return(10);
+       case(MDOC_Va):
+               return(12);
+       case(MDOC_Vt):
+               return(12);
+       case(MDOC_Xr):
+               return(10);
+       default:
+               break;
+       };
+       return(0);
+}