[BACK]Return to mdoc_argv.c CVS log [TXT][DIR] Up to [cvsweb.bsd.lv] / mandoc

Annotation of mandoc/mdoc_argv.c, Revision 1.43

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

CVSweb