[BACK]Return to mdoc_argv.c CVS log [TXT][DIR] Up to [local] / src / usr.bin / mandoc

Annotation of src/usr.bin/mandoc/mdoc_argv.c, Revision 1.33

1.33    ! schwarze    1: /*     $Id: mdoc_argv.c,v 1.32 2010/07/13 01:09:13 schwarze Exp $ */
1.1       kristaps    2: /*
1.32      schwarze    3:  * Copyright (c) 2008, 2009, 2010 Kristaps Dzonsons <kristaps@bsd.lv>
1.1       kristaps    4:  *
                      5:  * Permission to use, copy, modify, and distribute this software for any
1.2       schwarze    6:  * purpose with or without fee is hereby granted, provided that the above
                      7:  * copyright notice and this permission notice appear in all copies.
1.1       kristaps    8:  *
1.2       schwarze    9:  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
                     10:  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
                     11:  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
                     12:  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
                     13:  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
                     14:  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
                     15:  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.1       kristaps   16:  */
                     17: #include <sys/types.h>
                     18:
                     19: #include <assert.h>
                     20: #include <ctype.h>
                     21: #include <stdlib.h>
                     22: #include <stdio.h>
                     23: #include <string.h>
                     24:
1.29      schwarze   25: #include "mandoc.h"
1.1       kristaps   26: #include "libmdoc.h"
1.19      schwarze   27: #include "libmandoc.h"
1.1       kristaps   28:
                     29: /*
                     30:  * Routines to parse arguments of macros.  Arguments follow the syntax
                     31:  * of `-arg [val [valN...]]'.  Arguments come in all types:  quoted
                     32:  * arguments, multiple arguments per value, no-value arguments, etc.
                     33:  *
                     34:  * There's no limit to the number or arguments that may be allocated.
                     35:  */
                     36:
                     37: #define        ARGV_NONE       (1 << 0)
                     38: #define        ARGV_SINGLE     (1 << 1)
                     39: #define        ARGV_MULTI      (1 << 2)
                     40: #define        ARGV_OPT_SINGLE (1 << 3)
                     41:
                     42: #define        MULTI_STEP       5
                     43:
1.33    ! schwarze   44: static enum mdocargt    argv_a2arg(enum mdoct, const char *);
1.24      schwarze   45: static enum margserr    args(struct mdoc *, int, int *,
1.1       kristaps   46:                                char *, int, char **);
                     47: static int              argv(struct mdoc *, int,
                     48:                                struct mdoc_argv *, int *, char *);
                     49: static int              argv_single(struct mdoc *, int,
                     50:                                struct mdoc_argv *, int *, char *);
                     51: static int              argv_opt_single(struct mdoc *, int,
                     52:                                struct mdoc_argv *, int *, char *);
                     53: static int              argv_multi(struct mdoc *, int,
                     54:                                struct mdoc_argv *, int *, char *);
                     55:
                     56: /* Per-argument flags. */
                     57:
                     58: static int mdoc_argvflags[MDOC_ARG_MAX] = {
                     59:        ARGV_NONE,      /* MDOC_Split */
                     60:        ARGV_NONE,      /* MDOC_Nosplit */
                     61:        ARGV_NONE,      /* MDOC_Ragged */
                     62:        ARGV_NONE,      /* MDOC_Unfilled */
                     63:        ARGV_NONE,      /* MDOC_Literal */
1.17      schwarze   64:        ARGV_SINGLE,    /* MDOC_File */
1.15      schwarze   65:        ARGV_OPT_SINGLE, /* MDOC_Offset */
1.1       kristaps   66:        ARGV_NONE,      /* MDOC_Bullet */
                     67:        ARGV_NONE,      /* MDOC_Dash */
                     68:        ARGV_NONE,      /* MDOC_Hyphen */
                     69:        ARGV_NONE,      /* MDOC_Item */
                     70:        ARGV_NONE,      /* MDOC_Enum */
                     71:        ARGV_NONE,      /* MDOC_Tag */
                     72:        ARGV_NONE,      /* MDOC_Diag */
                     73:        ARGV_NONE,      /* MDOC_Hang */
                     74:        ARGV_NONE,      /* MDOC_Ohang */
                     75:        ARGV_NONE,      /* MDOC_Inset */
                     76:        ARGV_MULTI,     /* MDOC_Column */
                     77:        ARGV_SINGLE,    /* MDOC_Width */
                     78:        ARGV_NONE,      /* MDOC_Compact */
1.14      schwarze   79:        ARGV_NONE,      /* MDOC_Std */
1.1       kristaps   80:        ARGV_NONE,      /* MDOC_Filled */
                     81:        ARGV_NONE,      /* MDOC_Words */
                     82:        ARGV_NONE,      /* MDOC_Emphasis */
                     83:        ARGV_NONE,      /* MDOC_Symbolic */
                     84:        ARGV_NONE       /* MDOC_Symbolic */
                     85: };
                     86:
                     87: static int mdoc_argflags[MDOC_MAX] = {
1.3       schwarze   88:        0, /* Ap */
1.1       kristaps   89:        0, /* Dd */
                     90:        0, /* Dt */
                     91:        0, /* Os */
1.12      schwarze   92:        0, /* Sh */
                     93:        0, /* Ss */
1.1       kristaps   94:        ARGS_DELIM, /* Pp */
                     95:        ARGS_DELIM, /* D1 */
1.12      schwarze   96:        ARGS_DELIM, /* Dl */
1.1       kristaps   97:        0, /* Bd */
                     98:        0, /* Ed */
1.12      schwarze   99:        0, /* Bl */
1.1       kristaps  100:        0, /* El */
                    101:        0, /* It */
                    102:        ARGS_DELIM, /* Ad */
                    103:        ARGS_DELIM, /* An */
1.12      schwarze  104:        ARGS_DELIM, /* Ar */
                    105:        0, /* Cd */
1.1       kristaps  106:        ARGS_DELIM, /* Cm */
                    107:        ARGS_DELIM, /* Dv */
                    108:        ARGS_DELIM, /* Er */
                    109:        ARGS_DELIM, /* Ev */
                    110:        0, /* Ex */
1.12      schwarze  111:        ARGS_DELIM, /* Fa */
1.1       kristaps  112:        0, /* Fd */
                    113:        ARGS_DELIM, /* Fl */
1.12      schwarze  114:        ARGS_DELIM, /* Fn */
                    115:        ARGS_DELIM, /* Ft */
1.1       kristaps  116:        ARGS_DELIM, /* Ic */
                    117:        0, /* In */
1.12      schwarze  118:        ARGS_DELIM, /* Li */
                    119:        0, /* Nd */
1.1       kristaps  120:        ARGS_DELIM, /* Nm */
                    121:        ARGS_DELIM, /* Op */
                    122:        0, /* Ot */
                    123:        ARGS_DELIM, /* Pa */
                    124:        0, /* Rv */
1.12      schwarze  125:        ARGS_DELIM, /* St */
1.1       kristaps  126:        ARGS_DELIM, /* Va */
                    127:        ARGS_DELIM, /* Vt */
                    128:        ARGS_DELIM, /* Xr */
1.12      schwarze  129:        0, /* %A */
                    130:        0, /* %B */
                    131:        0, /* %D */
                    132:        0, /* %I */
                    133:        0, /* %J */
                    134:        0, /* %N */
                    135:        0, /* %O */
                    136:        0, /* %P */
                    137:        0, /* %R */
                    138:        0, /* %T */
                    139:        0, /* %V */
1.1       kristaps  140:        ARGS_DELIM, /* Ac */
                    141:        0, /* Ao */
                    142:        ARGS_DELIM, /* Aq */
                    143:        ARGS_DELIM, /* At */
                    144:        ARGS_DELIM, /* Bc */
                    145:        0, /* Bf */
                    146:        0, /* Bo */
                    147:        ARGS_DELIM, /* Bq */
                    148:        ARGS_DELIM, /* Bsx */
                    149:        ARGS_DELIM, /* Bx */
                    150:        0, /* Db */
                    151:        ARGS_DELIM, /* Dc */
                    152:        0, /* Do */
                    153:        ARGS_DELIM, /* Dq */
                    154:        ARGS_DELIM, /* Ec */
                    155:        0, /* Ef */
                    156:        ARGS_DELIM, /* Em */
                    157:        0, /* Eo */
                    158:        ARGS_DELIM, /* Fx */
                    159:        ARGS_DELIM, /* Ms */
                    160:        ARGS_DELIM, /* No */
                    161:        ARGS_DELIM, /* Ns */
                    162:        ARGS_DELIM, /* Nx */
                    163:        ARGS_DELIM, /* Ox */
                    164:        ARGS_DELIM, /* Pc */
                    165:        ARGS_DELIM, /* Pf */
                    166:        0, /* Po */
                    167:        ARGS_DELIM, /* Pq */
                    168:        ARGS_DELIM, /* Qc */
                    169:        ARGS_DELIM, /* Ql */
                    170:        0, /* Qo */
                    171:        ARGS_DELIM, /* Qq */
                    172:        0, /* Re */
                    173:        0, /* Rs */
                    174:        ARGS_DELIM, /* Sc */
                    175:        0, /* So */
                    176:        ARGS_DELIM, /* Sq */
                    177:        0, /* Sm */
                    178:        ARGS_DELIM, /* Sx */
1.12      schwarze  179:        ARGS_DELIM, /* Sy */
1.1       kristaps  180:        ARGS_DELIM, /* Tn */
                    181:        ARGS_DELIM, /* Ux */
                    182:        ARGS_DELIM, /* Xc */
                    183:        0, /* Xo */
1.12      schwarze  184:        0, /* Fo */
1.1       kristaps  185:        0, /* Fc */
                    186:        0, /* Oo */
                    187:        ARGS_DELIM, /* Oc */
                    188:        0, /* Bk */
                    189:        0, /* Ek */
                    190:        0, /* Bt */
                    191:        0, /* Hf */
                    192:        0, /* Fr */
                    193:        0, /* Ud */
                    194:        0, /* Lb */
                    195:        ARGS_DELIM, /* Lp */
1.12      schwarze  196:        ARGS_DELIM, /* Lk */
                    197:        ARGS_DELIM, /* Mt */
1.1       kristaps  198:        ARGS_DELIM, /* Brq */
                    199:        0, /* Bro */
                    200:        ARGS_DELIM, /* Brc */
1.12      schwarze  201:        0, /* %C */
1.1       kristaps  202:        0, /* Es */
                    203:        0, /* En */
                    204:        0, /* Dx */
1.12      schwarze  205:        0, /* %Q */
1.10      schwarze  206:        0, /* br */
                    207:        0, /* sp */
1.18      schwarze  208:        0, /* %U */
1.30      schwarze  209:        0, /* Ta */
1.1       kristaps  210: };
                    211:
                    212:
                    213: /*
                    214:  * Parse an argument from line text.  This comes in the form of -key
                    215:  * [value0...], which may either have a single mandatory value, at least
                    216:  * one mandatory value, an optional single value, or no value.
                    217:  */
1.24      schwarze  218: enum margverr
1.22      schwarze  219: mdoc_argv(struct mdoc *m, int line, enum mdoct tok,
1.1       kristaps  220:                struct mdoc_arg **v, int *pos, char *buf)
                    221: {
                    222:        char             *p, sv;
                    223:        struct mdoc_argv tmp;
                    224:        struct mdoc_arg  *arg;
                    225:
1.30      schwarze  226:        if ('\0' == buf[*pos])
1.1       kristaps  227:                return(ARGV_EOLN);
                    228:
                    229:        assert(' ' != buf[*pos]);
                    230:
                    231:        /* Parse through to the first unescaped space. */
                    232:
                    233:        p = &buf[++(*pos)];
                    234:
                    235:        assert(*pos > 0);
                    236:
                    237:        /* LINTED */
                    238:        while (buf[*pos]) {
                    239:                if (' ' == buf[*pos])
                    240:                        if ('\\' != buf[*pos - 1])
                    241:                                break;
                    242:                (*pos)++;
                    243:        }
                    244:
                    245:        /* XXX - save zeroed byte, if not an argument. */
                    246:
1.30      schwarze  247:        sv = '\0';
1.1       kristaps  248:        if (buf[*pos]) {
                    249:                sv = buf[*pos];
1.30      schwarze  250:                buf[(*pos)++] = '\0';
1.1       kristaps  251:        }
                    252:
                    253:        (void)memset(&tmp, 0, sizeof(struct mdoc_argv));
                    254:        tmp.line = line;
                    255:        tmp.pos = *pos;
                    256:
                    257:        /* See if our token accepts the argument. */
                    258:
                    259:        if (MDOC_ARG_MAX == (tmp.arg = argv_a2arg(tok, p))) {
                    260:                /* XXX - restore saved zeroed byte. */
                    261:                if (sv)
                    262:                        buf[*pos - 1] = sv;
                    263:                return(ARGV_WORD);
                    264:        }
                    265:
                    266:        while (buf[*pos] && ' ' == buf[*pos])
                    267:                (*pos)++;
                    268:
1.6       schwarze  269:        if ( ! argv(m, line, &tmp, pos, buf))
1.1       kristaps  270:                return(ARGV_ERROR);
                    271:
1.19      schwarze  272:        if (NULL == (arg = *v))
                    273:                arg = *v = mandoc_calloc(1, sizeof(struct mdoc_arg));
1.1       kristaps  274:
                    275:        arg->argc++;
1.19      schwarze  276:        arg->argv = mandoc_realloc
                    277:                (arg->argv, arg->argc * sizeof(struct mdoc_argv));
1.1       kristaps  278:
                    279:        (void)memcpy(&arg->argv[(int)arg->argc - 1],
                    280:                        &tmp, sizeof(struct mdoc_argv));
                    281:
                    282:        return(ARGV_ARG);
                    283: }
                    284:
                    285:
                    286: void
                    287: mdoc_argv_free(struct mdoc_arg *p)
                    288: {
1.23      schwarze  289:        int              i;
1.1       kristaps  290:
                    291:        if (NULL == p)
                    292:                return;
                    293:
                    294:        if (p->refcnt) {
                    295:                --(p->refcnt);
                    296:                if (p->refcnt)
                    297:                        return;
                    298:        }
                    299:        assert(p->argc);
                    300:
1.24      schwarze  301:        for (i = (int)p->argc - 1; i >= 0; i--)
1.23      schwarze  302:                mdoc_argn_free(p, i);
                    303:
                    304:        free(p->argv);
                    305:        free(p);
                    306: }
                    307:
                    308:
                    309: void
                    310: mdoc_argn_free(struct mdoc_arg *p, int iarg)
                    311: {
1.33    ! schwarze  312:        struct mdoc_argv *arg;
1.23      schwarze  313:        int               j;
1.1       kristaps  314:
1.33    ! schwarze  315:        arg = &p->argv[iarg];
        !           316:
1.23      schwarze  317:        if (arg->sz && arg->value) {
1.24      schwarze  318:                for (j = (int)arg->sz - 1; j >= 0; j--)
1.23      schwarze  319:                        free(arg->value[j]);
                    320:                free(arg->value);
1.1       kristaps  321:        }
                    322:
1.23      schwarze  323:        for (--p->argc; iarg < (int)p->argc; iarg++)
                    324:                p->argv[iarg] = p->argv[iarg+1];
1.1       kristaps  325: }
                    326:
                    327:
1.24      schwarze  328: enum margserr
1.13      schwarze  329: mdoc_zargs(struct mdoc *m, int line, int *pos,
                    330:                char *buf, int flags, char **v)
1.12      schwarze  331: {
                    332:
1.13      schwarze  333:        return(args(m, line, pos, buf, flags, v));
1.12      schwarze  334: }
                    335:
                    336:
1.24      schwarze  337: enum margserr
1.22      schwarze  338: mdoc_args(struct mdoc *m, int line, int *pos,
                    339:                char *buf, enum mdoct tok, char **v)
1.1       kristaps  340: {
1.30      schwarze  341:        int               fl;
1.1       kristaps  342:        struct mdoc_node *n;
                    343:
1.22      schwarze  344:        fl = mdoc_argflags[tok];
1.1       kristaps  345:
1.12      schwarze  346:        if (MDOC_It != tok)
                    347:                return(args(m, line, pos, buf, fl, v));
                    348:
1.30      schwarze  349:        /*
                    350:         * We know that we're in an `It', so it's reasonable to expect
                    351:         * us to be sitting in a `Bl'.  Someday this may not be the case
                    352:         * (if we allow random `It's sitting out there), so provide a
                    353:         * safe fall-back into the default behaviour.
1.1       kristaps  354:         */
                    355:
1.12      schwarze  356:        for (n = m->last; n; n = n->parent)
1.30      schwarze  357:                if (MDOC_Bl == n->tok)
1.12      schwarze  358:                        break;
1.1       kristaps  359:
1.32      schwarze  360:        assert(n->data.Bl);
                    361:        if (n && LIST_column == n->data.Bl->type) {
1.12      schwarze  362:                fl |= ARGS_TABSEP;
                    363:                fl &= ~ARGS_DELIM;
1.1       kristaps  364:        }
                    365:
1.8       schwarze  366:        return(args(m, line, pos, buf, fl, v));
1.1       kristaps  367: }
                    368:
                    369:
1.24      schwarze  370: static enum margserr
1.12      schwarze  371: args(struct mdoc *m, int line, int *pos,
1.11      schwarze  372:                char *buf, int fl, char **v)
1.1       kristaps  373: {
1.30      schwarze  374:        int              i;
                    375:        char            *p, *pp;
                    376:        enum margserr    rc;
                    377:        enum mdelim      d;
1.1       kristaps  378:
1.13      schwarze  379:        /*
                    380:         * Parse out the terms (like `val' in `.Xx -arg val' or simply
                    381:         * `.Xx val'), which can have all sorts of properties:
                    382:         *
                    383:         *   ARGS_DELIM: use special handling if encountering trailing
                    384:         *   delimiters in the form of [[::delim::][ ]+]+.
                    385:         *
                    386:         *   ARGS_NOWARN: don't post warnings.  This is only used when
                    387:         *   re-parsing delimiters, as the warnings have already been
                    388:         *   posted.
                    389:         *
                    390:         *   ARGS_TABSEP: use special handling for tab/`Ta' separated
                    391:         *   phrases like in `Bl -column'.
                    392:         */
                    393:
1.12      schwarze  394:        assert(' ' != buf[*pos]);
1.1       kristaps  395:
1.28      schwarze  396:        if ('\0' == buf[*pos]) {
                    397:                if (MDOC_PPHRASE & m->flags)
                    398:                        return(ARGS_EOLN);
                    399:                /*
                    400:                 * If we're not in a partial phrase and the flag for
                    401:                 * being a phrase literal is still set, the punctuation
                    402:                 * is unterminated.
                    403:                 */
                    404:                if (MDOC_PHRASELIT & m->flags)
1.29      schwarze  405:                        if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_BADQUOTE))
1.28      schwarze  406:                                return(ARGS_ERROR);
                    407:
                    408:                m->flags &= ~MDOC_PHRASELIT;
1.1       kristaps  409:                return(ARGS_EOLN);
1.28      schwarze  410:        }
1.1       kristaps  411:
                    412:        /*
1.25      schwarze  413:         * If the first character is a closing delimiter and we're to
                    414:         * look for delimited strings, then pass down the buffer seeing
                    415:         * if it follows the pattern of [[::delim::][ ]+]+.  Note that
                    416:         * we ONLY care about closing delimiters.
1.1       kristaps  417:         */
                    418:
1.27      schwarze  419:        if ((fl & ARGS_DELIM) && DELIM_CLOSE == mdoc_iscdelim(buf[*pos])) {
1.1       kristaps  420:                for (i = *pos; buf[i]; ) {
1.30      schwarze  421:                        d = mdoc_iscdelim(buf[i]);
1.27      schwarze  422:                        if (DELIM_NONE == d || DELIM_OPEN == d)
1.1       kristaps  423:                                break;
                    424:                        i++;
1.25      schwarze  425:                        if ('\0' == buf[i] || ' ' != buf[i])
1.1       kristaps  426:                                break;
                    427:                        i++;
                    428:                        while (buf[i] && ' ' == buf[i])
                    429:                                i++;
                    430:                }
1.12      schwarze  431:
1.25      schwarze  432:                if ('\0' == buf[i]) {
1.1       kristaps  433:                        *v = &buf[*pos];
1.30      schwarze  434:                        if (i && ' ' != buf[i - 1])
1.13      schwarze  435:                                return(ARGS_PUNCT);
                    436:                        if (ARGS_NOWARN & fl)
                    437:                                return(ARGS_PUNCT);
1.29      schwarze  438:                        if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_EOLNSPACE))
1.13      schwarze  439:                                return(ARGS_ERROR);
1.1       kristaps  440:                        return(ARGS_PUNCT);
                    441:                }
                    442:        }
                    443:
1.12      schwarze  444:        *v = &buf[*pos];
1.1       kristaps  445:
1.12      schwarze  446:        /*
                    447:         * First handle TABSEP items, restricted to `Bl -column'.  This
                    448:         * ignores conventional token parsing and instead uses tabs or
                    449:         * `Ta' macros to separate phrases.  Phrases are parsed again
                    450:         * for arguments at a later phase.
                    451:         */
                    452:
                    453:        if (ARGS_TABSEP & fl) {
                    454:                /* Scan ahead to tab (can't be escaped). */
                    455:                p = strchr(*v, '\t');
1.28      schwarze  456:                pp = NULL;
1.12      schwarze  457:
                    458:                /* Scan ahead to unescaped `Ta'. */
1.28      schwarze  459:                if ( ! (MDOC_PHRASELIT & m->flags))
                    460:                        for (pp = *v; ; pp++) {
                    461:                                if (NULL == (pp = strstr(pp, "Ta")))
                    462:                                        break;
                    463:                                if (pp > *v && ' ' != *(pp - 1))
                    464:                                        continue;
1.30      schwarze  465:                                if (' ' == *(pp + 2) || '\0' == *(pp + 2))
1.28      schwarze  466:                                        break;
                    467:                        }
1.1       kristaps  468:
1.24      schwarze  469:                /* By default, assume a phrase. */
                    470:                rc = ARGS_PHRASE;
                    471:
1.1       kristaps  472:                /*
1.12      schwarze  473:                 * Adjust new-buffer position to be beyond delimiter
                    474:                 * mark (e.g., Ta -> end + 2).
1.1       kristaps  475:                 */
1.12      schwarze  476:                if (p && pp) {
                    477:                        *pos += pp < p ? 2 : 1;
1.24      schwarze  478:                        rc = pp < p ? ARGS_PHRASE : ARGS_PPHRASE;
1.12      schwarze  479:                        p = pp < p ? pp : p;
                    480:                } else if (p && ! pp) {
1.24      schwarze  481:                        rc = ARGS_PPHRASE;
1.12      schwarze  482:                        *pos += 1;
                    483:                } else if (pp && ! p) {
                    484:                        p = pp;
                    485:                        *pos += 2;
1.25      schwarze  486:                } else {
                    487:                        rc = ARGS_PEND;
1.12      schwarze  488:                        p = strchr(*v, 0);
1.25      schwarze  489:                }
1.1       kristaps  490:
1.12      schwarze  491:                /* Whitespace check for eoln case... */
1.30      schwarze  492:                if ('\0' == *p && ' ' == *(p - 1) && ! (ARGS_NOWARN & fl))
1.29      schwarze  493:                        if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_EOLNSPACE))
1.12      schwarze  494:                                return(ARGS_ERROR);
                    495:
                    496:                *pos += (int)(p - *v);
                    497:
                    498:                /* Strip delimiter's preceding whitespace. */
                    499:                pp = p - 1;
                    500:                while (pp > *v && ' ' == *pp) {
                    501:                        if (pp > *v && '\\' == *(pp - 1))
                    502:                                break;
                    503:                        pp--;
                    504:                }
                    505:                *(pp + 1) = 0;
1.1       kristaps  506:
1.12      schwarze  507:                /* Strip delimiter's proceeding whitespace. */
                    508:                for (pp = &buf[*pos]; ' ' == *pp; pp++, (*pos)++)
                    509:                        /* Skip ahead. */ ;
1.1       kristaps  510:
1.24      schwarze  511:                return(rc);
1.12      schwarze  512:        }
1.1       kristaps  513:
1.12      schwarze  514:        /*
                    515:         * Process a quoted literal.  A quote begins with a double-quote
                    516:         * and ends with a double-quote NOT preceded by a double-quote.
                    517:         * Whitespace is NOT involved in literal termination.
                    518:         */
1.1       kristaps  519:
1.28      schwarze  520:        if (MDOC_PHRASELIT & m->flags || '\"' == buf[*pos]) {
                    521:                if ( ! (MDOC_PHRASELIT & m->flags))
                    522:                        *v = &buf[++(*pos)];
                    523:
                    524:                if (MDOC_PPHRASE & m->flags)
                    525:                        m->flags |= MDOC_PHRASELIT;
1.1       kristaps  526:
1.12      schwarze  527:                for ( ; buf[*pos]; (*pos)++) {
                    528:                        if ('\"' != buf[*pos])
                    529:                                continue;
                    530:                        if ('\"' != buf[*pos + 1])
                    531:                                break;
                    532:                        (*pos)++;
                    533:                }
1.1       kristaps  534:
1.28      schwarze  535:                if ('\0' == buf[*pos]) {
                    536:                        if (ARGS_NOWARN & fl || MDOC_PPHRASE & m->flags)
1.13      schwarze  537:                                return(ARGS_QWORD);
1.29      schwarze  538:                        if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_BADQUOTE))
1.12      schwarze  539:                                return(ARGS_ERROR);
                    540:                        return(ARGS_QWORD);
                    541:                }
1.1       kristaps  542:
1.28      schwarze  543:                m->flags &= ~MDOC_PHRASELIT;
                    544:                buf[(*pos)++] = '\0';
1.1       kristaps  545:
1.28      schwarze  546:                if ('\0' == buf[*pos])
1.12      schwarze  547:                        return(ARGS_QWORD);
1.1       kristaps  548:
1.12      schwarze  549:                while (' ' == buf[*pos])
                    550:                        (*pos)++;
1.1       kristaps  551:
1.13      schwarze  552:                if (0 == buf[*pos] && ! (ARGS_NOWARN & fl))
1.29      schwarze  553:                        if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_EOLNSPACE))
1.12      schwarze  554:                                return(ARGS_ERROR);
1.1       kristaps  555:
1.12      schwarze  556:                return(ARGS_QWORD);
1.1       kristaps  557:        }
                    558:
1.12      schwarze  559:        /*
                    560:         * A non-quoted term progresses until either the end of line or
                    561:         * a non-escaped whitespace.
1.1       kristaps  562:         */
                    563:
1.12      schwarze  564:        for ( ; buf[*pos]; (*pos)++)
1.30      schwarze  565:                if (*pos && ' ' == buf[*pos] && '\\' != buf[*pos - 1])
1.12      schwarze  566:                        break;
1.1       kristaps  567:
1.28      schwarze  568:        if ('\0' == buf[*pos])
1.12      schwarze  569:                return(ARGS_WORD);
1.1       kristaps  570:
1.28      schwarze  571:        buf[(*pos)++] = '\0';
1.1       kristaps  572:
1.12      schwarze  573:        while (' ' == buf[*pos])
1.1       kristaps  574:                (*pos)++;
                    575:
1.28      schwarze  576:        if ('\0' == buf[*pos] && ! (ARGS_NOWARN & fl))
1.29      schwarze  577:                if ( ! mdoc_pmsg(m, line, *pos, MANDOCERR_EOLNSPACE))
1.12      schwarze  578:                        return(ARGS_ERROR);
1.1       kristaps  579:
1.12      schwarze  580:        return(ARGS_WORD);
1.1       kristaps  581: }
                    582:
                    583:
1.33    ! schwarze  584: static enum mdocargt
1.22      schwarze  585: argv_a2arg(enum mdoct tok, const char *p)
1.1       kristaps  586: {
                    587:
                    588:        /*
                    589:         * Parse an argument identifier from its text.  XXX - this
                    590:         * should really be table-driven to clarify the code.
                    591:         *
                    592:         * If you add an argument to the list, make sure that you
                    593:         * register it here with its one or more macros!
                    594:         */
                    595:
                    596:        switch (tok) {
                    597:        case (MDOC_An):
1.16      schwarze  598:                if (0 == strcmp(p, "split"))
1.1       kristaps  599:                        return(MDOC_Split);
1.16      schwarze  600:                else if (0 == strcmp(p, "nosplit"))
1.1       kristaps  601:                        return(MDOC_Nosplit);
                    602:                break;
                    603:
                    604:        case (MDOC_Bd):
1.16      schwarze  605:                if (0 == strcmp(p, "ragged"))
1.1       kristaps  606:                        return(MDOC_Ragged);
1.16      schwarze  607:                else if (0 == strcmp(p, "unfilled"))
1.1       kristaps  608:                        return(MDOC_Unfilled);
1.16      schwarze  609:                else if (0 == strcmp(p, "filled"))
1.1       kristaps  610:                        return(MDOC_Filled);
1.16      schwarze  611:                else if (0 == strcmp(p, "literal"))
1.1       kristaps  612:                        return(MDOC_Literal);
1.16      schwarze  613:                else if (0 == strcmp(p, "file"))
1.1       kristaps  614:                        return(MDOC_File);
1.16      schwarze  615:                else if (0 == strcmp(p, "offset"))
1.1       kristaps  616:                        return(MDOC_Offset);
1.16      schwarze  617:                else if (0 == strcmp(p, "compact"))
1.1       kristaps  618:                        return(MDOC_Compact);
1.17      schwarze  619:                else if (0 == strcmp(p, "centered"))
                    620:                        return(MDOC_Centred);
1.1       kristaps  621:                break;
                    622:
                    623:        case (MDOC_Bf):
1.16      schwarze  624:                if (0 == strcmp(p, "emphasis"))
1.1       kristaps  625:                        return(MDOC_Emphasis);
1.16      schwarze  626:                else if (0 == strcmp(p, "literal"))
1.1       kristaps  627:                        return(MDOC_Literal);
1.16      schwarze  628:                else if (0 == strcmp(p, "symbolic"))
1.1       kristaps  629:                        return(MDOC_Symbolic);
                    630:                break;
                    631:
                    632:        case (MDOC_Bk):
1.16      schwarze  633:                if (0 == strcmp(p, "words"))
1.1       kristaps  634:                        return(MDOC_Words);
                    635:                break;
                    636:
                    637:        case (MDOC_Bl):
1.16      schwarze  638:                if (0 == strcmp(p, "bullet"))
1.1       kristaps  639:                        return(MDOC_Bullet);
1.16      schwarze  640:                else if (0 == strcmp(p, "dash"))
1.1       kristaps  641:                        return(MDOC_Dash);
1.16      schwarze  642:                else if (0 == strcmp(p, "hyphen"))
1.1       kristaps  643:                        return(MDOC_Hyphen);
1.16      schwarze  644:                else if (0 == strcmp(p, "item"))
1.1       kristaps  645:                        return(MDOC_Item);
1.16      schwarze  646:                else if (0 == strcmp(p, "enum"))
1.1       kristaps  647:                        return(MDOC_Enum);
1.16      schwarze  648:                else if (0 == strcmp(p, "tag"))
1.1       kristaps  649:                        return(MDOC_Tag);
1.16      schwarze  650:                else if (0 == strcmp(p, "diag"))
1.1       kristaps  651:                        return(MDOC_Diag);
1.16      schwarze  652:                else if (0 == strcmp(p, "hang"))
1.1       kristaps  653:                        return(MDOC_Hang);
1.16      schwarze  654:                else if (0 == strcmp(p, "ohang"))
1.1       kristaps  655:                        return(MDOC_Ohang);
1.16      schwarze  656:                else if (0 == strcmp(p, "inset"))
1.1       kristaps  657:                        return(MDOC_Inset);
1.16      schwarze  658:                else if (0 == strcmp(p, "column"))
1.1       kristaps  659:                        return(MDOC_Column);
1.16      schwarze  660:                else if (0 == strcmp(p, "width"))
1.1       kristaps  661:                        return(MDOC_Width);
1.16      schwarze  662:                else if (0 == strcmp(p, "offset"))
1.1       kristaps  663:                        return(MDOC_Offset);
1.16      schwarze  664:                else if (0 == strcmp(p, "compact"))
1.1       kristaps  665:                        return(MDOC_Compact);
1.16      schwarze  666:                else if (0 == strcmp(p, "nested"))
1.1       kristaps  667:                        return(MDOC_Nested);
                    668:                break;
                    669:
                    670:        case (MDOC_Rv):
                    671:                /* FALLTHROUGH */
                    672:        case (MDOC_Ex):
1.16      schwarze  673:                if (0 == strcmp(p, "std"))
1.1       kristaps  674:                        return(MDOC_Std);
                    675:                break;
                    676:        default:
                    677:                break;
                    678:        }
                    679:
                    680:        return(MDOC_ARG_MAX);
                    681: }
                    682:
                    683:
                    684: static int
1.6       schwarze  685: argv_multi(struct mdoc *m, int line,
1.1       kristaps  686:                struct mdoc_argv *v, int *pos, char *buf)
                    687: {
1.24      schwarze  688:        enum margserr    ac;
1.1       kristaps  689:        char            *p;
                    690:
                    691:        for (v->sz = 0; ; v->sz++) {
                    692:                if ('-' == buf[*pos])
                    693:                        break;
1.24      schwarze  694:                ac = args(m, line, pos, buf, 0, &p);
                    695:                if (ARGS_ERROR == ac)
1.1       kristaps  696:                        return(0);
1.24      schwarze  697:                else if (ARGS_EOLN == ac)
1.1       kristaps  698:                        break;
                    699:
1.19      schwarze  700:                if (0 == v->sz % MULTI_STEP)
                    701:                        v->value = mandoc_realloc(v->value,
1.1       kristaps  702:                                (v->sz + MULTI_STEP) * sizeof(char *));
1.19      schwarze  703:
                    704:                v->value[(int)v->sz] = mandoc_strdup(p);
1.1       kristaps  705:        }
                    706:
1.4       schwarze  707:        return(1);
1.1       kristaps  708: }
                    709:
                    710:
                    711: static int
1.6       schwarze  712: argv_opt_single(struct mdoc *m, int line,
1.1       kristaps  713:                struct mdoc_argv *v, int *pos, char *buf)
                    714: {
1.24      schwarze  715:        enum margserr    ac;
1.1       kristaps  716:        char            *p;
                    717:
                    718:        if ('-' == buf[*pos])
                    719:                return(1);
                    720:
1.24      schwarze  721:        ac = args(m, line, pos, buf, 0, &p);
                    722:        if (ARGS_ERROR == ac)
1.1       kristaps  723:                return(0);
1.24      schwarze  724:        if (ARGS_EOLN == ac)
1.1       kristaps  725:                return(1);
                    726:
                    727:        v->sz = 1;
1.19      schwarze  728:        v->value = mandoc_malloc(sizeof(char *));
                    729:        v->value[0] = mandoc_strdup(p);
1.1       kristaps  730:
                    731:        return(1);
                    732: }
                    733:
                    734:
                    735: /*
                    736:  * Parse a single, mandatory value from the stream.
                    737:  */
                    738: static int
1.6       schwarze  739: argv_single(struct mdoc *m, int line,
1.1       kristaps  740:                struct mdoc_argv *v, int *pos, char *buf)
                    741: {
1.24      schwarze  742:        int              ppos;
                    743:        enum margserr    ac;
1.1       kristaps  744:        char            *p;
                    745:
                    746:        ppos = *pos;
                    747:
1.24      schwarze  748:        ac = args(m, line, pos, buf, 0, &p);
1.29      schwarze  749:        if (ARGS_EOLN == ac) {
                    750:                mdoc_pmsg(m, line, ppos, MANDOCERR_SYNTARGVCOUNT);
                    751:                return(0);
                    752:        } else if (ARGS_ERROR == ac)
1.1       kristaps  753:                return(0);
                    754:
                    755:        v->sz = 1;
1.19      schwarze  756:        v->value = mandoc_malloc(sizeof(char *));
                    757:        v->value[0] = mandoc_strdup(p);
1.1       kristaps  758:
                    759:        return(1);
                    760: }
                    761:
                    762:
                    763: /*
                    764:  * Determine rules for parsing arguments.  Arguments can either accept
                    765:  * no parameters, an optional single parameter, one parameter, or
                    766:  * multiple parameters.
                    767:  */
                    768: static int
                    769: argv(struct mdoc *mdoc, int line,
                    770:                struct mdoc_argv *v, int *pos, char *buf)
                    771: {
                    772:
                    773:        v->sz = 0;
                    774:        v->value = NULL;
                    775:
                    776:        switch (mdoc_argvflags[v->arg]) {
                    777:        case (ARGV_SINGLE):
                    778:                return(argv_single(mdoc, line, v, pos, buf));
                    779:        case (ARGV_MULTI):
                    780:                return(argv_multi(mdoc, line, v, pos, buf));
                    781:        case (ARGV_OPT_SINGLE):
                    782:                return(argv_opt_single(mdoc, line, v, pos, buf));
                    783:        default:
                    784:                /* ARGV_NONE */
                    785:                break;
                    786:        }
                    787:
                    788:        return(1);
                    789: }