]> git.cameronkatri.com Git - mandoc.git/blobdiff - mdoc_argv.c
Simplify the code by making various mdoc parser helper functions void.
[mandoc.git] / mdoc_argv.c
index ccc6ed103712514398ebe2b132592fa9fbb581b7..20dac8af168636374535a348f685257bcbb05567 100644 (file)
@@ -1,6 +1,7 @@
-/*     $Id: mdoc_argv.c,v 1.51 2010/05/31 10:28:04 kristaps Exp $ */
+/*     $OpenBSD$ */
 /*
- * Copyright (c) 2008, 2009 Kristaps Dzonsons <kristaps@kth.se>
+ * Copyright (c) 2008, 2009, 2010, 2011 Kristaps Dzonsons <kristaps@bsd.lv>
+ * Copyright (c) 2012 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
  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  */
-#ifdef HAVE_CONFIG_H
 #include "config.h"
-#endif
 
 #include <sys/types.h>
 
 #include <assert.h>
-#include <ctype.h>
 #include <stdlib.h>
 #include <stdio.h>
 #include <string.h>
 
+#include "mdoc.h"
 #include "mandoc.h"
+#include "mandoc_aux.h"
 #include "libmdoc.h"
 #include "libmandoc.h"
 
-/*
- * Routines to parse arguments of macros.  Arguments follow the syntax
- * of `-arg [val [valN...]]'.  Arguments come in all types:  quoted
- * arguments, multiple arguments per value, no-value arguments, etc.
- *
- * There's no limit to the number or arguments that may be allocated.
- */
+#define        MULTI_STEP       5 /* pre-allocate argument values */
+#define        DELIMSZ          6 /* max possible size of a delimiter */
+
+enum   argsflag {
+       ARGSFL_NONE = 0,
+       ARGSFL_DELIM, /* handle delimiters of [[::delim::][ ]+]+ */
+       ARGSFL_TABSEP /* handle tab/`Ta' separated phrases */
+};
 
-#define        ARGV_NONE       (1 << 0)
-#define        ARGV_SINGLE     (1 << 1)
-#define        ARGV_MULTI      (1 << 2)
-#define        ARGV_OPT_SINGLE (1 << 3)
+enum   argvflag {
+       ARGV_NONE, /* no args to flag (e.g., -split) */
+       ARGV_SINGLE, /* one arg to flag (e.g., -file xxx)  */
+       ARGV_MULTI /* multiple args (e.g., -column xxx yyy) */
+};
 
-#define        MULTI_STEP       5
+struct mdocarg {
+       enum argsflag    flags;
+       const enum mdocargt *argvs;
+};
 
-static int              argv_a2arg(enum mdoct, const char *);
-static enum margserr    args(struct mdoc *, int, int *, 
-                               char *, int, char **);
-static int              argv(struct mdoc *, int, 
-                               struct mdoc_argv *, int *, char *);
-static int              argv_single(struct mdoc *, int, 
+static void             argn_free(struct mdoc_arg *, int);
+static enum margserr    args(struct mdoc *, int, int *,
+                               char *, enum argsflag, char **);
+static int              args_checkpunct(const char *, int);
+static void             argv_multi(struct mdoc *, int,
                                struct mdoc_argv *, int *, char *);
-static int              argv_opt_single(struct mdoc *, int, 
+static void             argv_single(struct mdoc *, int,
                                struct mdoc_argv *, int *, char *);
-static int              argv_multi(struct mdoc *, int, 
-                               struct mdoc_argv *, int *, char *);
-
-/* Per-argument flags. */
 
-static int mdoc_argvflags[MDOC_ARG_MAX] = {
+static const enum argvflag argvflags[MDOC_ARG_MAX] = {
        ARGV_NONE,      /* MDOC_Split */
        ARGV_NONE,      /* MDOC_Nosplit */
        ARGV_NONE,      /* MDOC_Ragged */
        ARGV_NONE,      /* MDOC_Unfilled */
        ARGV_NONE,      /* MDOC_Literal */
        ARGV_SINGLE,    /* MDOC_File */
-       ARGV_OPT_SINGLE, /* MDOC_Offset */
+       ARGV_SINGLE,    /* MDOC_Offset */
        ARGV_NONE,      /* MDOC_Bullet */
        ARGV_NONE,      /* MDOC_Dash */
        ARGV_NONE,      /* MDOC_Hyphen */
@@ -88,129 +88,184 @@ static    int mdoc_argvflags[MDOC_ARG_MAX] = {
        ARGV_NONE       /* MDOC_Symbolic */
 };
 
-static int mdoc_argflags[MDOC_MAX] = {
-       0, /* Ap */
-       0, /* Dd */
-       0, /* Dt */
-       0, /* Os */
-       0, /* Sh */
-       0, /* Ss */ 
-       ARGS_DELIM, /* Pp */ 
-       ARGS_DELIM, /* D1 */
-       ARGS_DELIM, /* Dl */
-       0, /* Bd */
-       0, /* Ed */
-       0, /* Bl */
-       0, /* El */
-       0, /* It */
-       ARGS_DELIM, /* Ad */ 
-       ARGS_DELIM, /* An */
-       ARGS_DELIM, /* Ar */
-       0, /* Cd */
-       ARGS_DELIM, /* Cm */
-       ARGS_DELIM, /* Dv */ 
-       ARGS_DELIM, /* Er */ 
-       ARGS_DELIM, /* Ev */ 
-       0, /* Ex */
-       ARGS_DELIM, /* Fa */ 
-       0, /* Fd */ 
-       ARGS_DELIM, /* Fl */
-       ARGS_DELIM, /* Fn */ 
-       ARGS_DELIM, /* Ft */ 
-       ARGS_DELIM, /* Ic */ 
-       0, /* In */ 
-       ARGS_DELIM, /* Li */
-       0, /* Nd */ 
-       ARGS_DELIM, /* Nm */ 
-       ARGS_DELIM, /* Op */
-       0, /* Ot */
-       ARGS_DELIM, /* Pa */
-       0, /* Rv */
-       ARGS_DELIM, /* St */ 
-       ARGS_DELIM, /* Va */
-       ARGS_DELIM, /* Vt */ 
-       ARGS_DELIM, /* Xr */
-       0, /* %A */
-       0, /* %B */
-       0, /* %D */
-       0, /* %I */
-       0, /* %J */
-       0, /* %N */
-       0, /* %O */
-       0, /* %P */
-       0, /* %R */
-       0, /* %T */
-       0, /* %V */
-       ARGS_DELIM, /* Ac */
-       0, /* Ao */
-       ARGS_DELIM, /* Aq */
-       ARGS_DELIM, /* At */
-       ARGS_DELIM, /* Bc */
-       0, /* Bf */ 
-       0, /* Bo */
-       ARGS_DELIM, /* Bq */
-       ARGS_DELIM, /* Bsx */
-       ARGS_DELIM, /* Bx */
-       0, /* Db */
-       ARGS_DELIM, /* Dc */
-       0, /* Do */
-       ARGS_DELIM, /* Dq */
-       ARGS_DELIM, /* Ec */
-       0, /* Ef */
-       ARGS_DELIM, /* Em */ 
-       0, /* Eo */
-       ARGS_DELIM, /* Fx */
-       ARGS_DELIM, /* Ms */
-       ARGS_DELIM, /* No */
-       ARGS_DELIM, /* Ns */
-       ARGS_DELIM, /* Nx */
-       ARGS_DELIM, /* Ox */
-       ARGS_DELIM, /* Pc */
-       ARGS_DELIM, /* Pf */
-       0, /* Po */
-       ARGS_DELIM, /* Pq */
-       ARGS_DELIM, /* Qc */
-       ARGS_DELIM, /* Ql */
-       0, /* Qo */
-       ARGS_DELIM, /* Qq */
-       0, /* Re */
-       0, /* Rs */
-       ARGS_DELIM, /* Sc */
-       0, /* So */
-       ARGS_DELIM, /* Sq */
-       0, /* Sm */
-       ARGS_DELIM, /* Sx */
-       ARGS_DELIM, /* Sy */
-       ARGS_DELIM, /* Tn */
-       ARGS_DELIM, /* Ux */
-       ARGS_DELIM, /* Xc */
-       0, /* Xo */
-       0, /* Fo */ 
-       0, /* Fc */ 
-       0, /* Oo */
-       ARGS_DELIM, /* Oc */
-       0, /* Bk */
-       0, /* Ek */
-       0, /* Bt */
-       0, /* Hf */
-       0, /* Fr */
-       0, /* Ud */
-       0, /* Lb */
-       ARGS_DELIM, /* Lp */
-       ARGS_DELIM, /* Lk */
-       ARGS_DELIM, /* Mt */
-       ARGS_DELIM, /* Brq */
-       0, /* Bro */
-       ARGS_DELIM, /* Brc */
-       0, /* %C */
-       0, /* Es */
-       0, /* En */
-       0, /* Dx */
-       0, /* %Q */
-       0, /* br */
-       0, /* sp */
-       0, /* %U */
-       0, /* Ta */
+static const enum mdocargt args_Ex[] = {
+       MDOC_Std,
+       MDOC_ARG_MAX
+};
+
+static const enum mdocargt args_An[] = {
+       MDOC_Split,
+       MDOC_Nosplit,
+       MDOC_ARG_MAX
+};
+
+static const enum mdocargt args_Bd[] = {
+       MDOC_Ragged,
+       MDOC_Unfilled,
+       MDOC_Filled,
+       MDOC_Literal,
+       MDOC_File,
+       MDOC_Offset,
+       MDOC_Compact,
+       MDOC_Centred,
+       MDOC_ARG_MAX
+};
+
+static const enum mdocargt args_Bf[] = {
+       MDOC_Emphasis,
+       MDOC_Literal,
+       MDOC_Symbolic,
+       MDOC_ARG_MAX
+};
+
+static const enum mdocargt args_Bk[] = {
+       MDOC_Words,
+       MDOC_ARG_MAX
+};
+
+static const enum mdocargt args_Bl[] = {
+       MDOC_Bullet,
+       MDOC_Dash,
+       MDOC_Hyphen,
+       MDOC_Item,
+       MDOC_Enum,
+       MDOC_Tag,
+       MDOC_Diag,
+       MDOC_Hang,
+       MDOC_Ohang,
+       MDOC_Inset,
+       MDOC_Column,
+       MDOC_Width,
+       MDOC_Offset,
+       MDOC_Compact,
+       MDOC_Nested,
+       MDOC_ARG_MAX
+};
+
+static const struct mdocarg mdocargs[MDOC_MAX] = {
+       { ARGSFL_DELIM, NULL }, /* Ap */
+       { ARGSFL_NONE, NULL }, /* Dd */
+       { ARGSFL_NONE, NULL }, /* Dt */
+       { ARGSFL_NONE, NULL }, /* Os */
+       { ARGSFL_NONE, NULL }, /* Sh */
+       { ARGSFL_NONE, NULL }, /* Ss */
+       { ARGSFL_NONE, NULL }, /* Pp */
+       { ARGSFL_DELIM, NULL }, /* D1 */
+       { ARGSFL_DELIM, NULL }, /* Dl */
+       { ARGSFL_NONE, args_Bd }, /* Bd */
+       { ARGSFL_NONE, NULL }, /* Ed */
+       { ARGSFL_NONE, args_Bl }, /* Bl */
+       { ARGSFL_NONE, NULL }, /* El */
+       { ARGSFL_NONE, NULL }, /* It */
+       { ARGSFL_DELIM, NULL }, /* Ad */
+       { ARGSFL_DELIM, args_An }, /* An */
+       { ARGSFL_DELIM, NULL }, /* Ar */
+       { ARGSFL_DELIM, NULL }, /* Cd */
+       { ARGSFL_DELIM, NULL }, /* Cm */
+       { ARGSFL_DELIM, NULL }, /* Dv */
+       { ARGSFL_DELIM, NULL }, /* Er */
+       { ARGSFL_DELIM, NULL }, /* Ev */
+       { ARGSFL_NONE, args_Ex }, /* Ex */
+       { ARGSFL_DELIM, NULL }, /* Fa */
+       { ARGSFL_NONE, NULL }, /* Fd */
+       { ARGSFL_DELIM, NULL }, /* Fl */
+       { ARGSFL_DELIM, NULL }, /* Fn */
+       { ARGSFL_DELIM, NULL }, /* Ft */
+       { ARGSFL_DELIM, NULL }, /* Ic */
+       { ARGSFL_DELIM, NULL }, /* In */
+       { ARGSFL_DELIM, NULL }, /* Li */
+       { ARGSFL_NONE, NULL }, /* Nd */
+       { ARGSFL_DELIM, NULL }, /* Nm */
+       { ARGSFL_DELIM, NULL }, /* Op */
+       { ARGSFL_DELIM, NULL }, /* Ot */
+       { ARGSFL_DELIM, NULL }, /* Pa */
+       { ARGSFL_NONE, args_Ex }, /* Rv */
+       { ARGSFL_DELIM, NULL }, /* St */
+       { ARGSFL_DELIM, NULL }, /* Va */
+       { ARGSFL_DELIM, NULL }, /* Vt */
+       { ARGSFL_DELIM, NULL }, /* Xr */
+       { ARGSFL_NONE, NULL }, /* %A */
+       { ARGSFL_NONE, NULL }, /* %B */
+       { ARGSFL_NONE, NULL }, /* %D */
+       { ARGSFL_NONE, NULL }, /* %I */
+       { ARGSFL_NONE, NULL }, /* %J */
+       { ARGSFL_NONE, NULL }, /* %N */
+       { ARGSFL_NONE, NULL }, /* %O */
+       { ARGSFL_NONE, NULL }, /* %P */
+       { ARGSFL_NONE, NULL }, /* %R */
+       { ARGSFL_NONE, NULL }, /* %T */
+       { ARGSFL_NONE, NULL }, /* %V */
+       { ARGSFL_DELIM, NULL }, /* Ac */
+       { ARGSFL_NONE, NULL }, /* Ao */
+       { ARGSFL_DELIM, NULL }, /* Aq */
+       { ARGSFL_DELIM, NULL }, /* At */
+       { ARGSFL_DELIM, NULL }, /* Bc */
+       { ARGSFL_NONE, args_Bf }, /* Bf */
+       { ARGSFL_NONE, NULL }, /* Bo */
+       { ARGSFL_DELIM, NULL }, /* Bq */
+       { ARGSFL_DELIM, NULL }, /* Bsx */
+       { ARGSFL_DELIM, NULL }, /* Bx */
+       { ARGSFL_NONE, NULL }, /* Db */
+       { ARGSFL_DELIM, NULL }, /* Dc */
+       { ARGSFL_NONE, NULL }, /* Do */
+       { ARGSFL_DELIM, NULL }, /* Dq */
+       { ARGSFL_DELIM, NULL }, /* Ec */
+       { ARGSFL_NONE, NULL }, /* Ef */
+       { ARGSFL_DELIM, NULL }, /* Em */
+       { ARGSFL_NONE, NULL }, /* Eo */
+       { ARGSFL_DELIM, NULL }, /* Fx */
+       { ARGSFL_DELIM, NULL }, /* Ms */
+       { ARGSFL_DELIM, NULL }, /* No */
+       { ARGSFL_DELIM, NULL }, /* Ns */
+       { ARGSFL_DELIM, NULL }, /* Nx */
+       { ARGSFL_DELIM, NULL }, /* Ox */
+       { ARGSFL_DELIM, NULL }, /* Pc */
+       { ARGSFL_DELIM, NULL }, /* Pf */
+       { ARGSFL_NONE, NULL }, /* Po */
+       { ARGSFL_DELIM, NULL }, /* Pq */
+       { ARGSFL_DELIM, NULL }, /* Qc */
+       { ARGSFL_DELIM, NULL }, /* Ql */
+       { ARGSFL_NONE, NULL }, /* Qo */
+       { ARGSFL_DELIM, NULL }, /* Qq */
+       { ARGSFL_NONE, NULL }, /* Re */
+       { ARGSFL_NONE, NULL }, /* Rs */
+       { ARGSFL_DELIM, NULL }, /* Sc */
+       { ARGSFL_NONE, NULL }, /* So */
+       { ARGSFL_DELIM, NULL }, /* Sq */
+       { ARGSFL_NONE, NULL }, /* Sm */
+       { ARGSFL_DELIM, NULL }, /* Sx */
+       { ARGSFL_DELIM, NULL }, /* Sy */
+       { ARGSFL_DELIM, NULL }, /* Tn */
+       { ARGSFL_DELIM, NULL }, /* Ux */
+       { ARGSFL_DELIM, NULL }, /* Xc */
+       { ARGSFL_NONE, NULL }, /* Xo */
+       { ARGSFL_NONE, NULL }, /* Fo */
+       { ARGSFL_DELIM, NULL }, /* Fc */
+       { ARGSFL_NONE, NULL }, /* Oo */
+       { ARGSFL_DELIM, NULL }, /* Oc */
+       { ARGSFL_NONE, args_Bk }, /* Bk */
+       { ARGSFL_NONE, NULL }, /* Ek */
+       { ARGSFL_NONE, NULL }, /* Bt */
+       { ARGSFL_NONE, NULL }, /* Hf */
+       { ARGSFL_DELIM, NULL }, /* Fr */
+       { ARGSFL_NONE, NULL }, /* Ud */
+       { ARGSFL_DELIM, NULL }, /* Lb */
+       { ARGSFL_NONE, NULL }, /* Lp */
+       { ARGSFL_DELIM, NULL }, /* Lk */
+       { ARGSFL_DELIM, NULL }, /* Mt */
+       { ARGSFL_DELIM, NULL }, /* Brq */
+       { ARGSFL_NONE, NULL }, /* Bro */
+       { ARGSFL_DELIM, NULL }, /* Brc */
+       { ARGSFL_NONE, NULL }, /* %C */
+       { ARGSFL_NONE, NULL }, /* Es */
+       { ARGSFL_DELIM, NULL }, /* En */
+       { ARGSFL_DELIM, NULL }, /* Dx */
+       { ARGSFL_NONE, NULL }, /* %Q */
+       { ARGSFL_NONE, NULL }, /* br */
+       { ARGSFL_NONE, NULL }, /* sp */
+       { ARGSFL_NONE, NULL }, /* %U */
+       { ARGSFL_NONE, NULL }, /* Ta */
+       { ARGSFL_NONE, NULL }, /* ll */
 };
 
 
@@ -220,73 +275,95 @@ static    int mdoc_argflags[MDOC_MAX] = {
  * one mandatory value, an optional single value, or no value.
  */
 enum margverr
-mdoc_argv(struct mdoc *m, int line, enum mdoct tok,
+mdoc_argv(struct mdoc *mdoc, int line, enum mdoct tok,
                struct mdoc_arg **v, int *pos, char *buf)
 {
        char             *p, sv;
        struct mdoc_argv tmp;
        struct mdoc_arg  *arg;
+       const enum mdocargt *ap;
 
-       if (0 == buf[*pos])
+       if ('\0' == buf[*pos])
                return(ARGV_EOLN);
+       else if (NULL == (ap = mdocargs[tok].argvs))
+               return(ARGV_WORD);
+       else if ('-' != buf[*pos])
+               return(ARGV_WORD);
 
-       assert(' ' != buf[*pos]);
-
-       /* Parse through to the first unescaped space. */
+       /* Seek to the first unescaped space. */
 
        p = &buf[++(*pos)];
 
        assert(*pos > 0);
 
-       /* LINTED */
-       while (buf[*pos]) {
-               if (' ' == buf[*pos])
-                       if ('\\' != buf[*pos - 1])
-                               break;
-               (*pos)++;
-       }
+       for ( ; buf[*pos] ; (*pos)++)
+               if (' ' == buf[*pos] && '\\' != buf[*pos - 1])
+                       break;
 
-       /* XXX - save zeroed byte, if not an argument. */
+       /*
+        * We want to nil-terminate the word to look it up (it's easier
+        * that way).  But we may not have a flag, in which case we need
+        * to restore the line as-is.  So keep around the stray byte,
+        * which we'll reset upon exiting (if necessary).
+        */
 
-       sv = 0;
-       if (buf[*pos]) {
-               sv = buf[*pos];
-               buf[(*pos)++] = 0;
-       }
+       if ('\0' != (sv = buf[*pos]))
+               buf[(*pos)++] = '\0';
+
+       /*
+        * Now look up the word as a flag.  Use temporary storage that
+        * we'll copy into the node's flags, if necessary.
+        */
+
+       memset(&tmp, 0, sizeof(struct mdoc_argv));
 
-       (void)memset(&tmp, 0, sizeof(struct mdoc_argv));
        tmp.line = line;
        tmp.pos = *pos;
+       tmp.arg = MDOC_ARG_MAX;
 
-       /* See if our token accepts the argument. */
+       while (MDOC_ARG_MAX != (tmp.arg = *ap++))
+               if (0 == strcmp(p, mdoc_argnames[tmp.arg]))
+                       break;
 
-       if (MDOC_ARG_MAX == (tmp.arg = argv_a2arg(tok, p))) {
-               /* XXX - restore saved zeroed byte. */
+       if (MDOC_ARG_MAX == tmp.arg) {
+               /*
+                * The flag was not found.
+                * Restore saved zeroed byte and return as a word.
+                */
                if (sv)
                        buf[*pos - 1] = sv;
                return(ARGV_WORD);
        }
 
+       /* Read to the next word (the argument). */
+
        while (buf[*pos] && ' ' == buf[*pos])
                (*pos)++;
 
-       if ( ! argv(m, line, &tmp, pos, buf))
-               return(ARGV_ERROR);
+       switch (argvflags[tmp.arg]) {
+       case ARGV_SINGLE:
+               argv_single(mdoc, line, &tmp, pos, buf);
+               break;
+       case ARGV_MULTI:
+               argv_multi(mdoc, line, &tmp, pos, buf);
+               break;
+       case ARGV_NONE:
+               break;
+       }
 
        if (NULL == (arg = *v))
                arg = *v = mandoc_calloc(1, sizeof(struct mdoc_arg));
 
        arg->argc++;
-       arg->argv = mandoc_realloc
-               (arg->argv, arg->argc * sizeof(struct mdoc_argv));
+       arg->argv = mandoc_reallocarray(arg->argv,
+           arg->argc, sizeof(struct mdoc_argv));
 
-       (void)memcpy(&arg->argv[(int)arg->argc - 1], 
-                       &tmp, sizeof(struct mdoc_argv));
+       memcpy(&arg->argv[(int)arg->argc - 1], &tmp,
+           sizeof(struct mdoc_argv));
 
        return(ARGV_ARG);
 }
 
-
 void
 mdoc_argv_free(struct mdoc_arg *p)
 {
@@ -303,21 +380,22 @@ mdoc_argv_free(struct mdoc_arg *p)
        assert(p->argc);
 
        for (i = (int)p->argc - 1; i >= 0; i--)
-               mdoc_argn_free(p, i);
+               argn_free(p, i);
 
        free(p->argv);
        free(p);
 }
 
-
-void
-mdoc_argn_free(struct mdoc_arg *p, int iarg)
+static void
+argn_free(struct mdoc_arg *p, int iarg)
 {
-       struct mdoc_argv *arg = &p->argv[iarg];
+       struct mdoc_argv *arg;
        int               j;
 
+       arg = &p->argv[iarg];
+
        if (arg->sz && arg->value) {
-               for (j = (int)arg->sz - 1; j >= 0; j--) 
+               for (j = (int)arg->sz - 1; j >= 0; j--)
                        free(arg->value[j]);
                free(arg->value);
        }
@@ -326,27 +404,24 @@ mdoc_argn_free(struct mdoc_arg *p, int iarg)
                p->argv[iarg] = p->argv[iarg+1];
 }
 
-
 enum margserr
-mdoc_zargs(struct mdoc *m, int line, int *pos, 
-               char *buf, int flags, char **v)
+mdoc_zargs(struct mdoc *mdoc, int line, int *pos, char *buf, char **v)
 {
 
-       return(args(m, line, pos, buf, flags, v));
+       return(args(mdoc, line, pos, buf, ARGSFL_NONE, v));
 }
 
-
 enum margserr
-mdoc_args(struct mdoc *m, int line, int *pos, 
+mdoc_args(struct mdoc *mdoc, int line, int *pos,
                char *buf, enum mdoct tok, char **v)
 {
-       int               fl;
+       enum argsflag     fl;
        struct mdoc_node *n;
 
-       fl = mdoc_argflags[tok];
+       fl = mdocargs[tok].flags;
 
        if (MDOC_It != tok)
-               return(args(m, line, pos, buf, fl, v));
+               return(args(mdoc, line, pos, buf, fl, v));
 
        /*
         * We know that we're in an `It', so it's reasonable to expect
@@ -355,94 +430,45 @@ mdoc_args(struct mdoc *m, int line, int *pos,
         * safe fall-back into the default behaviour.
         */
 
-       for (n = m->last; n; n = n->parent)
+       for (n = mdoc->last; n; n = n->parent)
                if (MDOC_Bl == n->tok)
-                       break;
-
-       if (n && LIST_column == n->data.list) {
-               fl |= ARGS_TABSEP;
-               fl &= ~ARGS_DELIM;
-       }
+                       if (LIST_column == n->norm->Bl.type) {
+                               fl = ARGSFL_TABSEP;
+                               break;
+                       }
 
-       return(args(m, line, pos, buf, fl, v));
+       return(args(mdoc, line, pos, buf, fl, v));
 }
 
-
 static enum margserr
-args(struct mdoc *m, int line, int *pos, 
-               char *buf, int fl, char **v)
+args(struct mdoc *mdoc, int line, int *pos,
+               char *buf, enum argsflag fl, char **v)
 {
-       int               i;
-       char             *p, *pp;
-       enum margserr     rc;
-
-       /*
-        * Parse out the terms (like `val' in `.Xx -arg val' or simply
-        * `.Xx val'), which can have all sorts of properties:
-        *
-        *   ARGS_DELIM: use special handling if encountering trailing
-        *   delimiters in the form of [[::delim::][ ]+]+.
-        *
-        *   ARGS_NOWARN: don't post warnings.  This is only used when
-        *   re-parsing delimiters, as the warnings have already been
-        *   posted.
-        *
-        *   ARGS_TABSEP: use special handling for tab/`Ta' separated
-        *   phrases like in `Bl -column'.
-        */
-
-       assert(*pos);
-       assert(' ' != buf[*pos]);
+       char            *p, *pp;
+       int              pairs;
+       enum margserr    rc;
 
        if ('\0' == buf[*pos]) {
-               if (MDOC_PPHRASE & m->flags)
+               if (MDOC_PPHRASE & mdoc->flags)
                        return(ARGS_EOLN);
                /*
                 * If we're not in a partial phrase and the flag for
                 * being a phrase literal is still set, the punctuation
                 * is unterminated.
                 */
-               if (MDOC_PHRASELIT & m->flags)
-                       if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_BADQUOTE))
-                               return(ARGS_ERROR);
+               if (MDOC_PHRASELIT & mdoc->flags)
+                       mandoc_msg(MANDOCERR_ARG_QUOTE,
+                           mdoc->parse, line, *pos, NULL);
 
-               m->flags &= ~MDOC_PHRASELIT;
+               mdoc->flags &= ~MDOC_PHRASELIT;
                return(ARGS_EOLN);
        }
 
-       /* 
-        * If the first character is a closing delimiter and we're to
-        * look for delimited strings, then pass down the buffer seeing
-        * if it follows the pattern of [[::delim::][ ]+]+.  Note that
-        * we ONLY care about closing delimiters.
-        */
-
-       if ((fl & ARGS_DELIM) && DELIM_CLOSE == mdoc_iscdelim(buf[*pos])) {
-               for (i = *pos; buf[i]; ) {
-                       enum mdelim d = mdoc_iscdelim(buf[i]);
-                       if (DELIM_NONE == d || DELIM_OPEN == d)
-                               break;
-                       i++;
-                       if ('\0' == buf[i] || ' ' != buf[i])
-                               break;
-                       i++;
-                       while (buf[i] && ' ' == buf[i])
-                               i++;
-               }
+       *v = &buf[*pos];
 
-               if ('\0' == buf[i]) {
-                       *v = &buf[*pos];
-                       if (' ' != buf[i - 1])
-                               return(ARGS_PUNCT);
-                       if (ARGS_NOWARN & fl)
-                               return(ARGS_PUNCT);
-                       if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_EOLNSPACE))
-                               return(ARGS_ERROR);
+       if (ARGSFL_DELIM == fl)
+               if (args_checkpunct(buf, *pos))
                        return(ARGS_PUNCT);
-               }
-       }
-
-       *v = &buf[*pos];
 
        /*
         * First handle TABSEP items, restricted to `Bl -column'.  This
@@ -451,13 +477,13 @@ args(struct mdoc *m, int line, int *pos,
         * for arguments at a later phase.
         */
 
-       if (ARGS_TABSEP & fl) {
+       if (ARGSFL_TABSEP == fl) {
                /* Scan ahead to tab (can't be escaped). */
                p = strchr(*v, '\t');
                pp = NULL;
 
                /* Scan ahead to unescaped `Ta'. */
-               if ( ! (MDOC_PHRASELIT & m->flags)) 
+               if ( ! (MDOC_PHRASELIT & mdoc->flags))
                        for (pp = *v; ; pp++) {
                                if (NULL == (pp = strstr(pp, "Ta")))
                                        break;
@@ -470,7 +496,7 @@ args(struct mdoc *m, int line, int *pos,
                /* By default, assume a phrase. */
                rc = ARGS_PHRASE;
 
-               /* 
+               /*
                 * Adjust new-buffer position to be beyond delimiter
                 * mark (e.g., Ta -> end + 2).
                 */
@@ -490,9 +516,9 @@ args(struct mdoc *m, int line, int *pos,
                }
 
                /* Whitespace check for eoln case... */
-               if (0 == *p && ' ' == *(p - 1) && ! (ARGS_NOWARN & fl))
-                       if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_EOLNSPACE))
-                               return(ARGS_ERROR);
+               if ('\0' == *p && ' ' == *(p - 1))
+                       mandoc_msg(MANDOCERR_SPACE_EOL, mdoc->parse,
+                           line, *pos, NULL);
 
                *pos += (int)(p - *v);
 
@@ -510,38 +536,49 @@ args(struct mdoc *m, int line, int *pos,
                        /* Skip ahead. */ ;
 
                return(rc);
-       } 
+       }
 
-       /* 
+       /*
         * Process a quoted literal.  A quote begins with a double-quote
         * and ends with a double-quote NOT preceded by a double-quote.
+        * NUL-terminate the literal in place.
+        * Collapse pairs of quotes inside quoted literals.
         * Whitespace is NOT involved in literal termination.
         */
 
-       if (MDOC_PHRASELIT & m->flags || '\"' == buf[*pos]) {
-               if ( ! (MDOC_PHRASELIT & m->flags))
+       if (MDOC_PHRASELIT & mdoc->flags || '\"' == buf[*pos]) {
+               if ( ! (MDOC_PHRASELIT & mdoc->flags))
                        *v = &buf[++(*pos)];
 
-               if (MDOC_PPHRASE & m->flags)
-                       m->flags |= MDOC_PHRASELIT;
+               if (MDOC_PPHRASE & mdoc->flags)
+                       mdoc->flags |= MDOC_PHRASELIT;
 
+               pairs = 0;
                for ( ; buf[*pos]; (*pos)++) {
+                       /* Move following text left after quoted quotes. */
+                       if (pairs)
+                               buf[*pos - pairs] = buf[*pos];
                        if ('\"' != buf[*pos])
                                continue;
+                       /* Unquoted quotes end quoted args. */
                        if ('\"' != buf[*pos + 1])
                                break;
+                       /* Quoted quotes collapse. */
+                       pairs++;
                        (*pos)++;
                }
+               if (pairs)
+                       buf[*pos - pairs] = '\0';
 
                if ('\0' == buf[*pos]) {
-                       if (ARGS_NOWARN & fl || MDOC_PPHRASE & m->flags)
+                       if (MDOC_PPHRASE & mdoc->flags)
                                return(ARGS_QWORD);
-                       if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_BADQUOTE))
-                               return(ARGS_ERROR);
+                       mandoc_msg(MANDOCERR_ARG_QUOTE,
+                           mdoc->parse, line, *pos, NULL);
                        return(ARGS_QWORD);
                }
 
-               m->flags &= ~MDOC_PHRASELIT;
+               mdoc->flags &= ~MDOC_PHRASELIT;
                buf[(*pos)++] = '\0';
 
                if ('\0' == buf[*pos])
@@ -550,241 +587,103 @@ args(struct mdoc *m, int line, int *pos,
                while (' ' == buf[*pos])
                        (*pos)++;
 
-               if (0 == buf[*pos] && ! (ARGS_NOWARN & fl))
-                       if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_EOLNSPACE))
-                               return(ARGS_ERROR);
+               if ('\0' == buf[*pos])
+                       mandoc_msg(MANDOCERR_SPACE_EOL, mdoc->parse,
+                           line, *pos, NULL);
 
                return(ARGS_QWORD);
        }
 
-       /* 
-        * A non-quoted term progresses until either the end of line or
-        * a non-escaped whitespace.
-        */
-
-       for ( ; buf[*pos]; (*pos)++)
-               if (' ' == buf[*pos] && '\\' != buf[*pos - 1])
-                       break;
-
-       if ('\0' == buf[*pos])
-               return(ARGS_WORD);
-
-       buf[(*pos)++] = '\0';
-
-       while (' ' == buf[*pos])
-               (*pos)++;
-
-       if ('\0' == buf[*pos] && ! (ARGS_NOWARN & fl))
-               if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_EOLNSPACE))
-                       return(ARGS_ERROR);
+       p = &buf[*pos];
+       *v = mandoc_getarg(mdoc->parse, &p, line, pos);
 
        return(ARGS_WORD);
 }
 
-
+/*
+ * Check if the string consists only of space-separated closing
+ * delimiters.  This is a bit of a dance: the first must be a close
+ * delimiter, but it may be followed by middle delimiters.  Arbitrary
+ * whitespace may separate these tokens.
+ */
 static int
-argv_a2arg(enum mdoct tok, const char *p)
+args_checkpunct(const char *buf, int i)
 {
+       int              j;
+       char             dbuf[DELIMSZ];
+       enum mdelim      d;
 
-       /*
-        * Parse an argument identifier from its text.  XXX - this
-        * should really be table-driven to clarify the code.
-        *
-        * If you add an argument to the list, make sure that you
-        * register it here with its one or more macros!
-        */
-
-       switch (tok) {
-       case (MDOC_An):
-               if (0 == strcmp(p, "split"))
-                       return(MDOC_Split);
-               else if (0 == strcmp(p, "nosplit"))
-                       return(MDOC_Nosplit);
-               break;
+       /* First token must be a close-delimiter. */
 
-       case (MDOC_Bd):
-               if (0 == strcmp(p, "ragged"))
-                       return(MDOC_Ragged);
-               else if (0 == strcmp(p, "unfilled"))
-                       return(MDOC_Unfilled);
-               else if (0 == strcmp(p, "filled"))
-                       return(MDOC_Filled);
-               else if (0 == strcmp(p, "literal"))
-                       return(MDOC_Literal);
-               else if (0 == strcmp(p, "file"))
-                       return(MDOC_File);
-               else if (0 == strcmp(p, "offset"))
-                       return(MDOC_Offset);
-               else if (0 == strcmp(p, "compact"))
-                       return(MDOC_Compact);
-               else if (0 == strcmp(p, "centered"))
-                       return(MDOC_Centred);
-               break;
+       for (j = 0; buf[i] && ' ' != buf[i] && j < DELIMSZ; j++, i++)
+               dbuf[j] = buf[i];
 
-       case (MDOC_Bf):
-               if (0 == strcmp(p, "emphasis"))
-                       return(MDOC_Emphasis);
-               else if (0 == strcmp(p, "literal"))
-                       return(MDOC_Literal);
-               else if (0 == strcmp(p, "symbolic"))
-                       return(MDOC_Symbolic);
-               break;
-
-       case (MDOC_Bk):
-               if (0 == strcmp(p, "words"))
-                       return(MDOC_Words);
-               break;
+       if (DELIMSZ == j)
+               return(0);
 
-       case (MDOC_Bl):
-               if (0 == strcmp(p, "bullet"))
-                       return(MDOC_Bullet);
-               else if (0 == strcmp(p, "dash"))
-                       return(MDOC_Dash);
-               else if (0 == strcmp(p, "hyphen"))
-                       return(MDOC_Hyphen);
-               else if (0 == strcmp(p, "item"))
-                       return(MDOC_Item);
-               else if (0 == strcmp(p, "enum"))
-                       return(MDOC_Enum);
-               else if (0 == strcmp(p, "tag"))
-                       return(MDOC_Tag);
-               else if (0 == strcmp(p, "diag"))
-                       return(MDOC_Diag);
-               else if (0 == strcmp(p, "hang"))
-                       return(MDOC_Hang);
-               else if (0 == strcmp(p, "ohang"))
-                       return(MDOC_Ohang);
-               else if (0 == strcmp(p, "inset"))
-                       return(MDOC_Inset);
-               else if (0 == strcmp(p, "column"))
-                       return(MDOC_Column);
-               else if (0 == strcmp(p, "width"))
-                       return(MDOC_Width);
-               else if (0 == strcmp(p, "offset"))
-                       return(MDOC_Offset);
-               else if (0 == strcmp(p, "compact"))
-                       return(MDOC_Compact);
-               else if (0 == strcmp(p, "nested"))
-                       return(MDOC_Nested);
-               break;
-       
-       case (MDOC_Rv):
-               /* FALLTHROUGH */
-       case (MDOC_Ex):
-               if (0 == strcmp(p, "std"))
-                       return(MDOC_Std);
-               break;
-       default:
-               break;
-       }
+       dbuf[j] = '\0';
+       if (DELIM_CLOSE != mdoc_isdelim(dbuf))
+               return(0);
 
-       return(MDOC_ARG_MAX);
-}
+       while (' ' == buf[i])
+               i++;
 
+       /* Remaining must NOT be open/none. */
 
-static int
-argv_multi(struct mdoc *m, int line, 
-               struct mdoc_argv *v, int *pos, char *buf)
-{
-       enum margserr    ac;
-       char            *p;
+       while (buf[i]) {
+               j = 0;
+               while (buf[i] && ' ' != buf[i] && j < DELIMSZ)
+                       dbuf[j++] = buf[i++];
 
-       for (v->sz = 0; ; v->sz++) {
-               if ('-' == buf[*pos])
-                       break;
-               ac = args(m, line, pos, buf, 0, &p);
-               if (ARGS_ERROR == ac)
+               if (DELIMSZ == j)
                        return(0);
-               else if (ARGS_EOLN == ac)
-                       break;
 
-               if (0 == v->sz % MULTI_STEP)
-                       v->value = mandoc_realloc(v->value, 
-                               (v->sz + MULTI_STEP) * sizeof(char *));
+               dbuf[j] = '\0';
+               d = mdoc_isdelim(dbuf);
+               if (DELIM_NONE == d || DELIM_OPEN == d)
+                       return(0);
 
-               v->value[(int)v->sz] = mandoc_strdup(p);
+               while (' ' == buf[i])
+                       i++;
        }
 
-       return(1);
+       return('\0' == buf[i]);
 }
 
-
-static int
-argv_opt_single(struct mdoc *m, int line, 
+static void
+argv_multi(struct mdoc *mdoc, int line,
                struct mdoc_argv *v, int *pos, char *buf)
 {
        enum margserr    ac;
        char            *p;
 
-       if ('-' == buf[*pos])
-               return(1);
-
-       ac = args(m, line, pos, buf, 0, &p);
-       if (ARGS_ERROR == ac)
-               return(0);
-       if (ARGS_EOLN == ac)
-               return(1);
+       for (v->sz = 0; ; v->sz++) {
+               if (buf[*pos] == '-')
+                       break;
+               ac = args(mdoc, line, pos, buf, ARGSFL_NONE, &p);
+               if (ac == ARGS_EOLN)
+                       break;
 
-       v->sz = 1;
-       v->value = mandoc_malloc(sizeof(char *));
-       v->value[0] = mandoc_strdup(p);
+               if (v->sz % MULTI_STEP == 0)
+                       v->value = mandoc_reallocarray(v->value,
+                           v->sz + MULTI_STEP, sizeof(char *));
 
-       return(1);
+               v->value[(int)v->sz] = mandoc_strdup(p);
+       }
 }
 
-
-/*
- * Parse a single, mandatory value from the stream.
- */
-static int
-argv_single(struct mdoc *m, int line, 
+static void
+argv_single(struct mdoc *mdoc, int line,
                struct mdoc_argv *v, int *pos, char *buf)
 {
-       int              ppos;
        enum margserr    ac;
        char            *p;
 
-       ppos = *pos;
-
-       ac = args(m, line, pos, buf, 0, &p);
-       if (ARGS_EOLN == ac) {
-               mdoc_pmsg(m, line, ppos, MANDOCERR_SYNTARGVCOUNT);
-               return(0);
-       } else if (ARGS_ERROR == ac)
-               return(0);
+       ac = args(mdoc, line, pos, buf, ARGSFL_NONE, &p);
+       if (ac == ARGS_EOLN)
+               return;
 
        v->sz = 1;
        v->value = mandoc_malloc(sizeof(char *));
        v->value[0] = mandoc_strdup(p);
-
-       return(1);
-}
-
-
-/*
- * Determine rules for parsing arguments.  Arguments can either accept
- * no parameters, an optional single parameter, one parameter, or
- * multiple parameters.
- */
-static int
-argv(struct mdoc *mdoc, int line, 
-               struct mdoc_argv *v, int *pos, char *buf)
-{
-
-       v->sz = 0;
-       v->value = NULL;
-
-       switch (mdoc_argvflags[v->arg]) {
-       case (ARGV_SINGLE):
-               return(argv_single(mdoc, line, v, pos, buf));
-       case (ARGV_MULTI):
-               return(argv_multi(mdoc, line, v, pos, buf));
-       case (ARGV_OPT_SINGLE):
-               return(argv_opt_single(mdoc, line, v, pos, buf));
-       default:
-               /* ARGV_NONE */
-               break;
-       }
-
-       return(1);
 }