]> git.cameronkatri.com Git - mandoc.git/blobdiff - mdoc_macro.c
Unify mdoc_deroff() and man_deroff() into a common function deroff().
[mandoc.git] / mdoc_macro.c
index 7cf30c42cec9b5f420459e42f75d2a122287a983..3e5667de5aa325b1b82c5fc1cd4ff75200668a9b 100644 (file)
@@ -1,4 +1,4 @@
-/*     $Id: mdoc_macro.c,v 1.173 2015/02/04 18:03:47 schwarze Exp $ */
+/*     $Id: mdoc_macro.c,v 1.195 2015/04/23 15:35:59 schwarze Exp $ */
 /*
  * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
  * Copyright (c) 2010, 2012-2015 Ingo Schwarze <schwarze@openbsd.org>
@@ -7,9 +7,9 @@
  * purpose with or without fee is hereby granted, provided that the above
  * copyright notice and this permission notice appear in all copies.
  *
- * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+ * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
- * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 #include <string.h>
 #include <time.h>
 
-#include "mdoc.h"
 #include "mandoc.h"
-#include "libmdoc.h"
+#include "roff.h"
+#include "mdoc.h"
 #include "libmandoc.h"
+#include "roff_int.h"
+#include "libmdoc.h"
 
 static void            blk_full(MACRO_PROT_ARGS);
 static void            blk_exp_close(MACRO_PROT_ARGS);
@@ -41,20 +43,19 @@ static      void            in_line_argn(MACRO_PROT_ARGS);
 static void            in_line(MACRO_PROT_ARGS);
 static void            phrase_ta(MACRO_PROT_ARGS);
 
-static void            dword(struct mdoc *, int, int, const char *,
-                                enum mdelim, int);
-static void            append_delims(struct mdoc *, int, int *, char *);
-static enum mdoct      lookup(struct mdoc *, enum mdoct,
-                               int, int, const char *);
+static void            append_delims(struct roff_man *, int, int *, char *);
+static void            dword(struct roff_man *, int, int, const char *,
+                               enum mdelim, int);
+static int             find_pending(struct roff_man *, int, int, int,
+                               struct roff_node *);
+static int             lookup(struct roff_man *, int, int, int, const char *);
 static int             macro_or_word(MACRO_PROT_ARGS, int);
-static void            make_pending(struct mdoc *, struct mdoc_node *,
-                               struct mdoc_node *, int, int);
-static int             parse_rest(struct mdoc *, enum mdoct,
-                               int, int *, char *);
-static enum mdoct      rew_alt(enum mdoct);
-static void            rew_elem(struct mdoc *, enum mdoct);
-static void            rew_last(struct mdoc *, const struct mdoc_node *);
-static void            rew_pending(struct mdoc *, const struct mdoc_node *);
+static int             parse_rest(struct roff_man *, int, int, int *, char *);
+static int             rew_alt(int);
+static void            rew_elem(struct roff_man *, int);
+static void            rew_last(struct roff_man *, const struct roff_node *);
+static void            rew_pending(struct roff_man *,
+                               const struct roff_node *);
 
 const  struct mdoc_macro __mdoc_macros[MDOC_MAX] = {
        { in_line_argn, MDOC_CALLABLE | MDOC_PARSED | MDOC_JOIN }, /* Ap */
@@ -209,9 +210,9 @@ const       struct mdoc_macro * const mdoc_macros = __mdoc_macros;
  * are errors.
  */
 void
-mdoc_macroend(struct mdoc *mdoc)
+mdoc_endparse(struct roff_man *mdoc)
 {
-       struct mdoc_node *n;
+       struct roff_node *n;
 
        /* Scan for open explicit scopes. */
 
@@ -219,7 +220,7 @@ mdoc_macroend(struct mdoc *mdoc)
            mdoc->last->parent : mdoc->last;
 
        for ( ; n; n = n->parent)
-               if (n->type == MDOC_BLOCK &&
+               if (n->type == ROFFT_BLOCK &&
                    mdoc_macros[n->tok].flags & MDOC_EXPLICIT)
                        mandoc_msg(MANDOCERR_BLK_NOEND, mdoc->parse,
                            n->line, n->pos, mdoc_macronames[n->tok]);
@@ -231,16 +232,16 @@ mdoc_macroend(struct mdoc *mdoc)
 
 /*
  * Look up the macro at *p called by "from",
- * or as a line macro if from == MDOC_MAX.
+ * or as a line macro if from == TOKEN_NONE.
  */
-static enum mdoct
-lookup(struct mdoc *mdoc, enum mdoct from, int line, int ppos, const char *p)
+static int
+lookup(struct roff_man *mdoc, int from, int line, int ppos, const char *p)
 {
-       enum mdoct       res;
+       int      res;
 
-       if (from == MDOC_MAX || mdoc_macros[from].flags & MDOC_PARSED) {
+       if (from == TOKEN_NONE || mdoc_macros[from].flags & MDOC_PARSED) {
                res = mdoc_hash_find(p);
-               if (res != MDOC_MAX) {
+               if (res != TOKEN_NONE) {
                        if (mdoc_macros[res].flags & MDOC_CALLABLE)
                                return(res);
                        if (res != MDOC_br && res != MDOC_sp && res != MDOC_ll)
@@ -248,23 +249,22 @@ lookup(struct mdoc *mdoc, enum mdoct from, int line, int ppos, const char *p)
                                    mdoc->parse, line, ppos, p);
                }
        }
-       return(MDOC_MAX);
+       return(TOKEN_NONE);
 }
 
 /*
  * Rewind up to and including a specific node.
  */
 static void
-rew_last(struct mdoc *mdoc, const struct mdoc_node *to)
+rew_last(struct roff_man *mdoc, const struct roff_node *to)
 {
-       struct mdoc_node *n, *np;
+       struct roff_node *n, *np;
+
+       if (to->flags & MDOC_VALID)
+               return;
 
-       assert(to);
-       mdoc->next = MDOC_NEXT_SIBLING;
+       mdoc->next = ROFF_NEXT_SIBLING;
        while (mdoc->last != to) {
-               if ( ! (mdoc->last->flags & MDOC_VALID))
-                       mdoc->last->lastline = to->lastline -
-                           (mdoc->flags & MDOC_NEWLINE ? 1 : 0);
                /*
                 * Save the parent here, because we may delete the
                 * mdoc->last node in the post-validation phase and reset
@@ -285,18 +285,40 @@ rew_last(struct mdoc *mdoc, const struct mdoc_node *to)
  * Rewind up to a specific block, including all blocks that broke it.
  */
 static void
-rew_pending(struct mdoc *mdoc, const struct mdoc_node *n)
+rew_pending(struct roff_man *mdoc, const struct roff_node *n)
 {
 
-       rew_last(mdoc, n);
-
-       if (n->type != MDOC_BLOCK)
-               return;
-
-       while ((n = n->pending) != NULL) {
+       for (;;) {
                rew_last(mdoc, n);
-               if (n->type == MDOC_HEAD)
-                       mdoc_body_alloc(mdoc, n->line, n->pos, n->tok);
+
+               if (mdoc->last == n) {
+                       switch (n->type) {
+                       case ROFFT_HEAD:
+                               roff_body_alloc(mdoc, n->line, n->pos,
+                                   n->tok);
+                               return;
+                       case ROFFT_BLOCK:
+                               break;
+                       default:
+                               return;
+                       }
+                       if ( ! (n->flags & MDOC_BROKEN))
+                               return;
+               } else
+                       n = mdoc->last;
+
+               for (;;) {
+                       if ((n = n->parent) == NULL)
+                               return;
+
+                       if (n->type == ROFFT_BLOCK ||
+                           n->type == ROFFT_HEAD) {
+                               if (n->flags & MDOC_ENDED)
+                                       break;
+                               else
+                                       return;
+                       }
+               }
        }
 }
 
@@ -304,8 +326,8 @@ rew_pending(struct mdoc *mdoc, const struct mdoc_node *n)
  * For a block closing macro, return the corresponding opening one.
  * Otherwise, return the macro itself.
  */
-static enum mdoct
-rew_alt(enum mdoct tok)
+static int
+rew_alt(int tok)
 {
        switch (tok) {
        case MDOC_Ac:
@@ -347,88 +369,54 @@ rew_alt(enum mdoct tok)
 }
 
 static void
-rew_elem(struct mdoc *mdoc, enum mdoct tok)
+rew_elem(struct roff_man *mdoc, int tok)
 {
-       struct mdoc_node *n;
+       struct roff_node *n;
 
        n = mdoc->last;
-       if (MDOC_ELEM != n->type)
+       if (n->type != ROFFT_ELEM)
                n = n->parent;
-       assert(MDOC_ELEM == n->type);
+       assert(n->type == ROFFT_ELEM);
        assert(tok == n->tok);
        rew_last(mdoc, n);
 }
 
 /*
- * We are trying to close the block *breaker,
- * but the child block *broken is still open.
- * Thus, postpone closing the *breaker
- * until the rew_pending() call closing *broken.
+ * If there is an open sub-block of the target requiring
+ * explicit close-out, postpone closing out the target until
+ * the rew_pending() call closing out the sub-block.
  */
-static void
-make_pending(struct mdoc *mdoc, struct mdoc_node *breaker,
-       struct mdoc_node *broken, int line, int ppos)
+static int
+find_pending(struct roff_man *mdoc, int tok, int line, int ppos,
+       struct roff_node *target)
 {
-       struct mdoc_node *n;
-
-       mandoc_vmsg(MANDOCERR_BLK_NEST, mdoc->parse, line, ppos,
-           "%s breaks %s", mdoc_macronames[breaker->tok],
-           mdoc_macronames[broken->tok]);
-
-       /*
-        * If the *broken block (Z) is already broken by a block (B)
-        * contained in the breaker (A), make the breaker pending
-        * on that inner breaker (B).  Graphically,
-        *
-        * breaker=[A! broken=n=[B!->A (old broken=)[Z->B B] A] Z]
-        *
-        * In these graphics, "->" indicates the "pending" pointer and
-        * "!" indicates the MDOC_BREAK flag.  Each of the cases gets
-        * one additional pointer (B->A) and one additional flag (A!).
-        */
-
-       for (n = broken->parent; ; n = n->parent)
-               if (n == broken->pending)
-                       broken = n;
-               else if (n == breaker)
-                       break;
-
-       /*
-        * Found the breaker.
-        *
-        * If another, outer breaker (X) is already pending on
-        * the *broken block (B), we must not clobber the link
-        * to the outer breaker, but make it pending on the new,
-        * now inner breaker (A).  Graphically,
-        *
-        * [X! n=breaker=[A!->X broken=[B(->X)->A X] A] B].
-        */
-
-       if (broken->pending != NULL) {
-               n = breaker;
-
-               /*
-                * If the inner breaker (A) is already broken, too,
-                * it cannot take on the outer breaker (X) but must
-                * hand it on to its own breakers (Y).  Graphically,
-                *
-                * [X! n=[Y!->X breaker=[A!->Y Y] broken=[B(->X)->A X] A] B]
-                */
-
-               while (n->pending)
-                       n = n->pending;
-               n->pending = broken->pending;
+       struct roff_node        *n;
+       int                      irc;
+
+       irc = 0;
+       for (n = mdoc->last; n != NULL && n != target; n = n->parent) {
+               if (n->flags & MDOC_ENDED) {
+                       if ( ! (n->flags & MDOC_VALID))
+                               n->flags |= MDOC_BROKEN;
+                       continue;
+               }
+               if (n->type == ROFFT_BLOCK &&
+                   mdoc_macros[n->tok].flags & MDOC_EXPLICIT) {
+                       irc = 1;
+                       n->flags = MDOC_BROKEN;
+                       if (target->type == ROFFT_HEAD)
+                               target->flags = MDOC_ENDED;
+                       else if ( ! (target->flags & MDOC_ENDED)) {
+                               mandoc_vmsg(MANDOCERR_BLK_NEST,
+                                   mdoc->parse, line, ppos,
+                                   "%s breaks %s", mdoc_macronames[tok],
+                                   mdoc_macronames[n->tok]);
+                               mdoc_endbody_alloc(mdoc, line, ppos,
+                                   tok, target, ENDBODY_NOSPACE);
+                       }
+               }
        }
-
-       /*
-        * Now we have reduced the situation to the simplest case:
-        * breaker=[A! broken=[B->A A] B].
-        */
-
-       broken->pending = breaker;
-       breaker->flags |= MDOC_BREAK;
-       if (breaker->body != NULL)
-               breaker->body->flags |= MDOC_BREAK;
+       return(irc);
 }
 
 /*
@@ -436,7 +424,7 @@ make_pending(struct mdoc *mdoc, struct mdoc_node *breaker,
  * Punctuation consists of those tokens found in mdoc_isdelim().
  */
 static void
-dword(struct mdoc *mdoc, int line, int col, const char *p,
+dword(struct roff_man *mdoc, int line, int col, const char *p,
                enum mdelim d, int may_append)
 {
 
@@ -445,13 +433,13 @@ dword(struct mdoc *mdoc, int line, int col, const char *p,
 
        if (may_append &&
            ! (mdoc->flags & (MDOC_SYNOPSIS | MDOC_KEEP | MDOC_SMOFF)) &&
-           d == DELIM_NONE && mdoc->last->type == MDOC_TEXT &&
+           d == DELIM_NONE && mdoc->last->type == ROFFT_TEXT &&
            mdoc_isdelim(mdoc->last->string) == DELIM_NONE) {
-               mdoc_word_append(mdoc, p);
+               roff_word_append(mdoc, p);
                return;
        }
 
-       mdoc_word_alloc(mdoc, line, col, p);
+       roff_word_alloc(mdoc, line, col, p);
 
        /*
         * If the word consists of a bare delimiter,
@@ -470,7 +458,7 @@ dword(struct mdoc *mdoc, int line, int col, const char *p,
 }
 
 static void
-append_delims(struct mdoc *mdoc, int line, int *pos, char *buf)
+append_delims(struct roff_man *mdoc, int line, int *pos, char *buf)
 {
        char            *p;
        int              la;
@@ -480,7 +468,8 @@ append_delims(struct mdoc *mdoc, int line, int *pos, char *buf)
 
        for (;;) {
                la = *pos;
-               if (mdoc_args(mdoc, line, pos, buf, MDOC_MAX, &p) == ARGS_EOLN)
+               if (mdoc_args(mdoc, line, pos, buf, TOKEN_NONE, &p) ==
+                   ARGS_EOLN)
                        break;
                dword(mdoc, line, la, p, DELIM_MAX, 1);
 
@@ -510,24 +499,24 @@ static int
 macro_or_word(MACRO_PROT_ARGS, int parsed)
 {
        char            *p;
-       enum mdoct       ntok;
+       int              ntok;
 
        p = buf + ppos;
-       ntok = MDOC_MAX;
+       ntok = TOKEN_NONE;
        if (*p == '"')
                p++;
        else if (parsed && ! (mdoc->flags & MDOC_PHRASELIT))
                ntok = lookup(mdoc, tok, line, ppos, p);
 
-       if (ntok == MDOC_MAX) {
-               dword(mdoc, line, ppos, p, DELIM_MAX, tok == MDOC_MAX ||
+       if (ntok == TOKEN_NONE) {
+               dword(mdoc, line, ppos, p, DELIM_MAX, tok == TOKEN_NONE ||
                    mdoc_macros[tok].flags & MDOC_JOIN);
                return(0);
        } else {
                if (mdoc_macros[tok].fp == in_line_eoln)
                        rew_elem(mdoc, tok);
                mdoc_macro(mdoc, ntok, line, ppos, pos, buf);
-               if (tok == MDOC_MAX)
+               if (tok == TOKEN_NONE)
                        append_delims(mdoc, line, pos, buf);
                return(1);
        }
@@ -539,15 +528,16 @@ macro_or_word(MACRO_PROT_ARGS, int parsed)
 static void
 blk_exp_close(MACRO_PROT_ARGS)
 {
-       struct mdoc_node *body;         /* Our own body. */
-       struct mdoc_node *endbody;      /* Our own end marker. */
-       struct mdoc_node *itblk;        /* An It block starting later. */
-       struct mdoc_node *later;        /* A sub-block starting later. */
-       struct mdoc_node *n;            /* Search back to our block. */
-
-       int              j, lastarg, maxargs, nl;
+       struct roff_node *body;         /* Our own body. */
+       struct roff_node *endbody;      /* Our own end marker. */
+       struct roff_node *itblk;        /* An It block starting later. */
+       struct roff_node *later;        /* A sub-block starting later. */
+       struct roff_node *n;            /* Search back to our block. */
+       struct roff_node *target;       /* For find_pending(). */
+
+       int              j, lastarg, maxargs, nl, pending;
        enum margserr    ac;
-       enum mdoct       atok, ntok;
+       int              atok, ntok;
        char            *p;
 
        nl = MDOC_NEWLINE & mdoc->flags;
@@ -572,20 +562,21 @@ blk_exp_close(MACRO_PROT_ARGS)
        atok = rew_alt(tok);
        body = endbody = itblk = later = NULL;
        for (n = mdoc->last; n; n = n->parent) {
-               if (n->flags & (MDOC_VALID | MDOC_BREAK))
+               if (n->flags & MDOC_ENDED) {
+                       if ( ! (n->flags & MDOC_VALID))
+                               n->flags |= MDOC_BROKEN;
                        continue;
+               }
 
                /* Remember the start of our own body. */
 
-               if (n->type == MDOC_BODY && atok == n->tok) {
-                       if (n->end == ENDBODY_NOT) {
+               if (n->type == ROFFT_BODY && atok == n->tok) {
+                       if (n->end == ENDBODY_NOT)
                                body = n;
-                               n->lastline = line;
-                       }
                        continue;
                }
 
-               if (n->type != MDOC_BLOCK || n->tok == MDOC_Nm)
+               if (n->type != ROFFT_BLOCK || n->tok == MDOC_Nm)
                        continue;
 
                if (n->tok == MDOC_It) {
@@ -594,7 +585,6 @@ blk_exp_close(MACRO_PROT_ARGS)
                }
 
                if (atok == n->tok) {
-                       n->lastline = line;
                        assert(body);
 
                        /*
@@ -611,20 +601,21 @@ blk_exp_close(MACRO_PROT_ARGS)
                         * When there is a pending sub block, postpone
                         * closing out the current block until the
                         * rew_pending() closing out the sub-block.
-                        */
-
-                       make_pending(mdoc, n, later, line, ppos);
-                       if (tok == MDOC_El)
-                               itblk->flags |= MDOC_BREAK;
-
-                       /*
                         * Mark the place where the formatting - but not
                         * the scope - of the current block ends.
                         */
 
+                       mandoc_vmsg(MANDOCERR_BLK_NEST, mdoc->parse,
+                           line, ppos, "%s breaks %s",
+                           mdoc_macronames[atok],
+                           mdoc_macronames[later->tok]);
+
                        endbody = mdoc_endbody_alloc(mdoc, line, ppos,
                            atok, body, ENDBODY_SPACE);
 
+                       if (tok == MDOC_El)
+                               itblk->flags |= MDOC_ENDED | MDOC_BROKEN;
+
                        /*
                         * If a block closing macro taking arguments
                         * breaks another block, put the arguments
@@ -632,18 +623,21 @@ blk_exp_close(MACRO_PROT_ARGS)
                         */
 
                        if (maxargs)
-                               mdoc->next = MDOC_NEXT_CHILD;
+                               mdoc->next = ROFF_NEXT_CHILD;
                        break;
                }
 
-               /*
-                * When finding an open sub block, remember the last
-                * open explicit block, or, in case there are only
-                * implicit ones, the first open implicit block.
-                */
+               /* Explicit blocks close out description lines. */
 
-               if (later == NULL ||
-                   ! (mdoc_macros[later->tok].flags & MDOC_EXPLICIT))
+               if (n->tok == MDOC_Nd) {
+                       rew_last(mdoc, n);
+                       continue;
+               }
+
+               /* Breaking an open sub block. */
+
+               n->flags |= MDOC_BROKEN;
+               if (later == NULL)
                        later = n;
        }
 
@@ -655,7 +649,7 @@ blk_exp_close(MACRO_PROT_ARGS)
                         * Stray .Ec without previous .Eo:
                         * Break the output line, keep the arguments.
                         */
-                       mdoc_elem_alloc(mdoc, line, ppos, MDOC_br, NULL);
+                       roff_elem_alloc(mdoc, line, ppos, MDOC_br);
                        rew_elem(mdoc, MDOC_br);
                }
        } else if (endbody == NULL) {
@@ -680,35 +674,42 @@ blk_exp_close(MACRO_PROT_ARGS)
        for (j = 0; ; j++) {
                lastarg = *pos;
 
-               if (j == maxargs && n != NULL) {
-                       rew_pending(mdoc, n);
-                       n = NULL;
-               }
+               if (j == maxargs && n != NULL)
+                       rew_last(mdoc, n);
 
                ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
                if (ac == ARGS_PUNCT || ac == ARGS_EOLN)
                        break;
 
-               ntok = ac == ARGS_QWORD ? MDOC_MAX :
+               ntok = ac == ARGS_QWORD ? TOKEN_NONE :
                    lookup(mdoc, tok, line, lastarg, p);
 
-               if (ntok == MDOC_MAX) {
+               if (ntok == TOKEN_NONE) {
                        dword(mdoc, line, lastarg, p, DELIM_MAX,
                            MDOC_JOIN & mdoc_macros[tok].flags);
                        continue;
                }
 
-               if (n != NULL) {
-                       rew_pending(mdoc, n);
-                       n = NULL;
-               }
+               if (n != NULL)
+                       rew_last(mdoc, n);
                mdoc->flags &= ~MDOC_NEWLINE;
                mdoc_macro(mdoc, ntok, line, lastarg, pos, buf);
                break;
        }
 
-       if (n != NULL)
-               rew_pending(mdoc, n);
+       if (n != NULL) {
+               if (n != mdoc->last && n->flags & MDOC_BROKEN) {
+                       target = n;
+                       do
+                               target = target->parent;
+                       while ( ! (target->flags & MDOC_ENDED));
+                       pending = find_pending(mdoc, ntok, line, ppos,
+                           target);
+               } else
+                       pending = 0;
+               if ( ! pending)
+                       rew_pending(mdoc, n);
+       }
        if (nl)
                append_delims(mdoc, line, pos, buf);
 }
@@ -717,7 +718,7 @@ static void
 in_line(MACRO_PROT_ARGS)
 {
        int              la, scope, cnt, firstarg, mayopen, nc, nl;
-       enum mdoct       ntok;
+       int              ntok;
        enum margserr    ac;
        enum mdelim      d;
        struct mdoc_arg *arg;
@@ -778,13 +779,13 @@ in_line(MACRO_PROT_ARGS)
                 */
 
                if (ac == ARGS_PUNCT) {
-                       if (cnt == 0 && nc == 0)
+                       if (cnt == 0 && (nc == 0 || tok == MDOC_An))
                                mdoc->flags |= MDOC_NODELIMC;
                        break;
                }
 
                ntok = (ac == ARGS_QWORD || (tok == MDOC_Fn && !cnt)) ?
-                   MDOC_MAX : lookup(mdoc, tok, line, la, p);
+                   TOKEN_NONE : lookup(mdoc, tok, line, la, p);
 
                /*
                 * In this case, we've located a submacro and must
@@ -793,7 +794,7 @@ in_line(MACRO_PROT_ARGS)
                 * or raise a warning.
                 */
 
-               if (ntok != MDOC_MAX) {
+               if (ntok != TOKEN_NONE) {
                        if (scope)
                                rew_elem(mdoc, tok);
                        if (nc && ! cnt) {
@@ -901,24 +902,35 @@ blk_full(MACRO_PROT_ARGS)
 {
        int               la, nl, parsed;
        struct mdoc_arg  *arg;
-       struct mdoc_node *blk; /* Our own or a broken block. */
-       struct mdoc_node *head; /* Our own head. */
-       struct mdoc_node *body; /* Our own body. */
-       struct mdoc_node *n;
+       struct roff_node *blk; /* Our own or a broken block. */
+       struct roff_node *head; /* Our own head. */
+       struct roff_node *body; /* Our own body. */
+       struct roff_node *n;
        enum margserr     ac, lac;
        char             *p;
 
        nl = MDOC_NEWLINE & mdoc->flags;
 
+       if (buf[*pos] == '\0' && (tok == MDOC_Sh || tok == MDOC_Ss)) {
+               mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
+                   line, ppos, mdoc_macronames[tok]);
+               return;
+       }
+
        if ( ! (mdoc_macros[tok].flags & MDOC_EXPLICIT)) {
 
                /* Here, tok is one of Sh Ss Nm Nd It. */
 
                blk = NULL;
                for (n = mdoc->last; n != NULL; n = n->parent) {
-                       if (n->flags & (MDOC_VALID | MDOC_BREAK) ||
-                           n->type != MDOC_BLOCK)
+                       if (n->flags & MDOC_ENDED) {
+                               if ( ! (n->flags & MDOC_VALID))
+                                       n->flags |= MDOC_BROKEN;
                                continue;
+                       }
+                       if (n->type != ROFFT_BLOCK)
+                               continue;
+
                        if (tok == MDOC_It && n->tok == MDOC_Bl) {
                                if (blk != NULL) {
                                        mandoc_vmsg(MANDOCERR_BLK_BROKEN,
@@ -941,6 +953,7 @@ blk_full(MACRO_PROT_ARGS)
                                            mdoc_macronames[tok],
                                            mdoc_macronames[n->tok]);
                                        rew_pending(mdoc, n);
+                                       n = mdoc->last;
                                        continue;
                                case MDOC_It:
                                        /* Delay in case it's astray. */
@@ -980,7 +993,7 @@ blk_full(MACRO_PROT_ARGS)
                if (tok == MDOC_It && (n == NULL || n->tok != MDOC_Bl)) {
                        mandoc_vmsg(MANDOCERR_IT_STRAY, mdoc->parse,
                            line, ppos, "It %s", buf + *pos);
-                       mdoc_elem_alloc(mdoc, line, ppos, MDOC_br, NULL);
+                       roff_elem_alloc(mdoc, line, ppos, MDOC_br);
                        rew_elem(mdoc, MDOC_br);
                        return;
                }
@@ -1014,9 +1027,9 @@ blk_full(MACRO_PROT_ARGS)
         */
 
        if (tok == MDOC_Nd) {
-               head = mdoc_head_alloc(mdoc, line, ppos, tok);
+               head = roff_head_alloc(mdoc, line, ppos, tok);
                rew_last(mdoc, head);
-               body = mdoc_body_alloc(mdoc, line, ppos, tok);
+               body = roff_body_alloc(mdoc, line, ppos, tok);
        }
 
        if (tok == MDOC_Bk)
@@ -1039,7 +1052,13 @@ blk_full(MACRO_PROT_ARGS)
                         */
                        if (body != NULL)
                                rew_last(mdoc, body);
-                       body = mdoc_body_alloc(mdoc, line, ppos, tok);
+                       body = roff_body_alloc(mdoc, line, ppos, tok);
+                       break;
+               }
+               if (tok == MDOC_Bd || tok == MDOC_Bk) {
+                       mandoc_vmsg(MANDOCERR_ARG_EXCESS,
+                           mdoc->parse, line, la, "%s ... %s",
+                           mdoc_macronames[tok], buf + la);
                        break;
                }
                if (tok == MDOC_Rs) {
@@ -1052,7 +1071,7 @@ blk_full(MACRO_PROT_ARGS)
 
                /*
                 * Emit leading punctuation (i.e., punctuation before
-                * the MDOC_HEAD) for non-phrase types.
+                * the ROFFT_HEAD) for non-phrase types.
                 */
 
                if (head == NULL &&
@@ -1068,7 +1087,7 @@ blk_full(MACRO_PROT_ARGS)
                /* Open a head if one hasn't been opened. */
 
                if (head == NULL)
-                       head = mdoc_head_alloc(mdoc, line, ppos, tok);
+                       head = roff_head_alloc(mdoc, line, ppos, tok);
 
                if (ac == ARGS_PHRASE ||
                    ac == ARGS_PEND ||
@@ -1080,7 +1099,7 @@ blk_full(MACRO_PROT_ARGS)
                         */
 
                        rew_last(mdoc, body == NULL ? head : body);
-                       body = mdoc_body_alloc(mdoc, line, ppos, tok);
+                       body = roff_body_alloc(mdoc, line, ppos, tok);
 
                        /*
                         * Process phrases: set whether we're in a
@@ -1092,7 +1111,7 @@ blk_full(MACRO_PROT_ARGS)
                                mdoc->flags |= MDOC_PPHRASE;
                        if (ac == ARGS_PEND && lac == ARGS_PPHRASE)
                                mdoc->flags |= MDOC_PPHRASE;
-                       parse_rest(mdoc, MDOC_MAX, line, &la, buf);
+                       parse_rest(mdoc, TOKEN_NONE, line, &la, buf);
                        mdoc->flags &= ~MDOC_PPHRASE;
                        continue;
                }
@@ -1104,31 +1123,18 @@ blk_full(MACRO_PROT_ARGS)
        if (blk->flags & MDOC_VALID)
                return;
        if (head == NULL)
-               head = mdoc_head_alloc(mdoc, line, ppos, tok);
-       if (nl && tok != MDOC_Rs)
+               head = roff_head_alloc(mdoc, line, ppos, tok);
+       if (nl && tok != MDOC_Bd && tok != MDOC_Bl && tok != MDOC_Rs)
                append_delims(mdoc, line, pos, buf);
        if (body != NULL)
                goto out;
-
-       /*
-        * If there is an open (i.e., unvalidated) sub-block requiring
-        * explicit close-out, postpone switching the current block from
-        * head to body until the rew_pending() call closing out that
-        * sub-block.
-        */
-       for (n = mdoc->last; n && n != head; n = n->parent) {
-               if (n->type == MDOC_BLOCK &&
-                   mdoc_macros[n->tok].flags & MDOC_EXPLICIT &&
-                   ! (n->flags & MDOC_VALID)) {
-                       n->pending = head;
-                       return;
-               }
-       }
+       if (find_pending(mdoc, tok, line, ppos, head))
+               return;
 
        /* Close out scopes to remain in a consistent state. */
 
        rew_last(mdoc, head);
-       body = mdoc_body_alloc(mdoc, line, ppos, tok);
+       body = roff_body_alloc(mdoc, line, ppos, tok);
 out:
        if (mdoc->flags & MDOC_FREECOL) {
                rew_last(mdoc, body);
@@ -1143,9 +1149,9 @@ blk_part_imp(MACRO_PROT_ARGS)
        int               la, nl;
        enum margserr     ac;
        char             *p;
-       struct mdoc_node *blk; /* saved block context */
-       struct mdoc_node *body; /* saved body context */
-       struct mdoc_node *n;
+       struct roff_node *blk; /* saved block context */
+       struct roff_node *body; /* saved body context */
+       struct roff_node *n;
 
        nl = MDOC_NEWLINE & mdoc->flags;
 
@@ -1159,7 +1165,7 @@ blk_part_imp(MACRO_PROT_ARGS)
         */
 
        blk = mdoc_block_alloc(mdoc, line, ppos, tok, NULL);
-       rew_last(mdoc, mdoc_head_alloc(mdoc, line, ppos, tok));
+       rew_last(mdoc, roff_head_alloc(mdoc, line, ppos, tok));
 
        /*
         * Open the body scope "on-demand", that is, after we've
@@ -1180,32 +1186,17 @@ blk_part_imp(MACRO_PROT_ARGS)
                }
 
                if (body == NULL)
-                       body = mdoc_body_alloc(mdoc, line, ppos, tok);
+                       body = roff_body_alloc(mdoc, line, ppos, tok);
 
                if (macro_or_word(mdoc, tok, line, la, pos, buf, 1))
                        break;
        }
        if (body == NULL)
-               body = mdoc_body_alloc(mdoc, line, ppos, tok);
+               body = roff_body_alloc(mdoc, line, ppos, tok);
 
-       /*
-        * If there is an open sub-block requiring explicit close-out,
-        * postpone closing out the current block until the
-        * rew_pending() call closing out the sub-block.
-        */
+       if (find_pending(mdoc, tok, line, ppos, body))
+               return;
 
-       for (n = mdoc->last; n && n != body && n != blk->parent;
-            n = n->parent) {
-               if (n->type == MDOC_BLOCK &&
-                   mdoc_macros[n->tok].flags & MDOC_EXPLICIT &&
-                   ! (n->flags & MDOC_VALID)) {
-                       make_pending(mdoc, blk, n, line, ppos);
-                       mdoc_endbody_alloc(mdoc, line, ppos,
-                           tok, body, ENDBODY_NOSPACE);
-                       return;
-               }
-       }
-       assert(n == body);
        rew_last(mdoc, body);
        if (nl)
                append_delims(mdoc, line, pos, buf);
@@ -1224,7 +1215,7 @@ blk_part_exp(MACRO_PROT_ARGS)
 {
        int               la, nl;
        enum margserr     ac;
-       struct mdoc_node *head; /* keep track of head */
+       struct roff_node *head; /* keep track of head */
        char             *p;
 
        nl = MDOC_NEWLINE & mdoc->flags;
@@ -1235,7 +1226,7 @@ blk_part_exp(MACRO_PROT_ARGS)
         * case of `Eo'); and a body that may be empty.
         */
 
-       mdoc_block_alloc(mdoc, line, ppos, tok, NULL);
+       roff_block_alloc(mdoc, line, ppos, tok);
        head = NULL;
        for (;;) {
                la = *pos;
@@ -1252,11 +1243,11 @@ blk_part_exp(MACRO_PROT_ARGS)
                }
 
                if (head == NULL) {
-                       head = mdoc_head_alloc(mdoc, line, ppos, tok);
+                       head = roff_head_alloc(mdoc, line, ppos, tok);
                        if (tok == MDOC_Eo)  /* Not parsed. */
                                dword(mdoc, line, la, p, DELIM_MAX, 0);
                        rew_last(mdoc, head);
-                       mdoc_body_alloc(mdoc, line, ppos, tok);
+                       roff_body_alloc(mdoc, line, ppos, tok);
                        if (tok == MDOC_Eo)
                                continue;
                }
@@ -1268,8 +1259,8 @@ blk_part_exp(MACRO_PROT_ARGS)
        /* Clean-up to leave in a consistent state. */
 
        if (head == NULL) {
-               rew_last(mdoc, mdoc_head_alloc(mdoc, line, ppos, tok));
-               mdoc_body_alloc(mdoc, line, ppos, tok);
+               rew_last(mdoc, roff_head_alloc(mdoc, line, ppos, tok));
+               roff_body_alloc(mdoc, line, ppos, tok);
        }
        if (nl)
                append_delims(mdoc, line, pos, buf);
@@ -1278,11 +1269,12 @@ blk_part_exp(MACRO_PROT_ARGS)
 static void
 in_line_argn(MACRO_PROT_ARGS)
 {
-       int              la, flushed, j, maxargs, nl;
-       enum margserr    ac;
        struct mdoc_arg *arg;
        char            *p;
-       enum mdoct       ntok;
+       enum margserr    ac;
+       int              ntok;
+       int              state; /* arg#; -1: not yet open; -2: closed */
+       int              la, maxargs, nl;
 
        nl = mdoc->flags & MDOC_NEWLINE;
 
@@ -1316,62 +1308,76 @@ in_line_argn(MACRO_PROT_ARGS)
 
        mdoc_argv(mdoc, line, tok, &arg, pos, buf);
 
+       state = -1;
        p = NULL;
-       flushed = j = 0;
        for (;;) {
                la = *pos;
                ac = mdoc_args(mdoc, line, pos, buf, tok, &p);
+
+               if (ac == ARGS_WORD && state == -1 &&
+                   ! (mdoc_macros[tok].flags & MDOC_IGNDELIM) &&
+                   mdoc_isdelim(p) == DELIM_OPEN) {
+                       dword(mdoc, line, la, p, DELIM_OPEN, 0);
+                       continue;
+               }
+
+               if (state == -1 && tok != MDOC_In &&
+                   tok != MDOC_St && tok != MDOC_Xr) {
+                       mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
+                       state = 0;
+               }
+
                if (ac == ARGS_PUNCT || ac == ARGS_EOLN) {
-                       if (j < 2 && tok == MDOC_Pf)
+                       if (abs(state) < 2 && tok == MDOC_Pf)
                                mandoc_vmsg(MANDOCERR_PF_SKIP,
                                    mdoc->parse, line, ppos, "Pf %s",
                                    p == NULL ? "at eol" : p);
                        break;
                }
 
-               if ( ! (mdoc_macros[tok].flags & MDOC_IGNDELIM) &&
-                   ac != ARGS_QWORD && j == 0 &&
-                   mdoc_isdelim(p) == DELIM_OPEN) {
-                       dword(mdoc, line, la, p, DELIM_OPEN, 0);
-                       continue;
-               } else if (j == 0)
-                      mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
-
-               if (j == maxargs && ! flushed) {
+               if (state == maxargs) {
                        rew_elem(mdoc, tok);
-                       flushed = 1;
+                       state = -2;
                }
 
-               ntok = (ac == ARGS_QWORD || (tok == MDOC_Pf && j == 0)) ?
-                   MDOC_MAX : lookup(mdoc, tok, line, la, p);
+               ntok = (ac == ARGS_QWORD || (tok == MDOC_Pf && state == 0)) ?
+                   TOKEN_NONE : lookup(mdoc, tok, line, la, p);
 
-               if (ntok != MDOC_MAX) {
-                       if ( ! flushed)
+               if (ntok != TOKEN_NONE) {
+                       if (state >= 0) {
                                rew_elem(mdoc, tok);
-                       flushed = 1;
+                               state = -2;
+                       }
                        mdoc_macro(mdoc, ntok, line, la, pos, buf);
-                       j++;
                        break;
                }
 
-               if ( ! (mdoc_macros[tok].flags & MDOC_IGNDELIM) &&
-                   ac != ARGS_QWORD && ! flushed &&
-                   mdoc_isdelim(p) != DELIM_NONE) {
+               if (ac == ARGS_QWORD ||
+                   mdoc_macros[tok].flags & MDOC_IGNDELIM ||
+                   mdoc_isdelim(p) == DELIM_NONE) {
+                       if (state == -1) {
+                               mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
+                               state = 1;
+                       } else if (state >= 0)
+                               state++;
+               } else if (state >= 0) {
                        rew_elem(mdoc, tok);
-                       flushed = 1;
+                       state = -2;
                }
 
                dword(mdoc, line, la, p, DELIM_MAX,
                    MDOC_JOIN & mdoc_macros[tok].flags);
-               j++;
        }
 
-       if (j == 0) {
-               mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
-               if (ac == ARGS_PUNCT && tok == MDOC_Pf)
-                       append_delims(mdoc, line, pos, buf);
+       if (state == -1) {
+               mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
+                   line, ppos, mdoc_macronames[tok]);
+               return;
        }
-       if ( ! flushed)
+
+       if (state == 0 && tok == MDOC_Pf)
+               append_delims(mdoc, line, pos, buf);
+       if (state >= 0)
                rew_elem(mdoc, tok);
        if (nl)
                append_delims(mdoc, line, pos, buf);
@@ -1380,18 +1386,25 @@ in_line_argn(MACRO_PROT_ARGS)
 static void
 in_line_eoln(MACRO_PROT_ARGS)
 {
-       struct mdoc_node        *n;
+       struct roff_node        *n;
        struct mdoc_arg         *arg;
 
        if ((tok == MDOC_Pp || tok == MDOC_Lp) &&
            ! (mdoc->flags & MDOC_SYNOPSIS)) {
                n = mdoc->last;
-               if (mdoc->next == MDOC_NEXT_SIBLING)
+               if (mdoc->next == ROFF_NEXT_SIBLING)
                        n = n->parent;
                if (n->tok == MDOC_Nm)
                        rew_last(mdoc, mdoc->last->parent);
        }
 
+       if (buf[*pos] == '\0' &&
+           (tok == MDOC_Fd || mdoc_macronames[tok][0] == '%')) {
+               mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
+                   line, ppos, mdoc_macronames[tok]);
+               return;
+       }
+
        mdoc_argv(mdoc, line, tok, &arg, pos, buf);
        mdoc_elem_alloc(mdoc, line, ppos, tok, arg);
        if (parse_rest(mdoc, tok, line, pos, buf))
@@ -1405,7 +1418,7 @@ in_line_eoln(MACRO_PROT_ARGS)
  * or until the next macro, call that macro, and return 1.
  */
 static int
-parse_rest(struct mdoc *mdoc, enum mdoct tok, int line, int *pos, char *buf)
+parse_rest(struct roff_man *mdoc, int tok, int line, int *pos, char *buf)
 {
        int              la;
 
@@ -1440,15 +1453,15 @@ ctx_synopsis(MACRO_PROT_ARGS)
 static void
 phrase_ta(MACRO_PROT_ARGS)
 {
-       struct mdoc_node *body, *n;
+       struct roff_node *body, *n;
 
        /* Make sure we are in a column list or ignore this macro. */
 
        body = NULL;
        for (n = mdoc->last; n != NULL; n = n->parent) {
-               if (n->flags & (MDOC_VALID | MDOC_BREAK))
+               if (n->flags & MDOC_ENDED)
                        continue;
-               if (n->tok == MDOC_It && n->type == MDOC_BODY)
+               if (n->tok == MDOC_It && n->type == ROFFT_BODY)
                        body = n;
                if (n->tok == MDOC_Bl)
                        break;
@@ -1463,6 +1476,6 @@ phrase_ta(MACRO_PROT_ARGS)
        /* Advance to the next column. */
 
        rew_last(mdoc, body);
-       mdoc_body_alloc(mdoc, line, ppos, MDOC_It);
-       parse_rest(mdoc, MDOC_MAX, line, pos, buf);
+       roff_body_alloc(mdoc, line, ppos, MDOC_It);
+       parse_rest(mdoc, TOKEN_NONE, line, pos, buf);
 }