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

Annotation of mandoc/validate.c, Revision 1.63

1.63    ! kristaps    1: /* $Id: validate.c,v 1.62 2009/02/27 09:14:02 kristaps Exp $ */
1.1       kristaps    2: /*
                      3:  * Copyright (c) 2008 Kristaps Dzonsons <kristaps@kth.se>
                      4:  *
                      5:  * Permission to use, copy, modify, and distribute this software for any
                      6:  * purpose with or without fee is hereby granted, provided that the
                      7:  * above copyright notice and this permission notice appear in all
                      8:  * copies.
                      9:  *
                     10:  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL
                     11:  * WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
                     12:  * WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE
                     13:  * AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
                     14:  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
                     15:  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
                     16:  * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
                     17:  * PERFORMANCE OF THIS SOFTWARE.
                     18:  */
                     19: #include <assert.h>
1.56      kristaps   20: #include <ctype.h>
1.8       kristaps   21: #include <stdlib.h>
1.1       kristaps   22:
                     23: #include "private.h"
                     24:
1.44      kristaps   25: /*
                     26:  * Pre- and post-validate macros as they're parsed.  Pre-validation
                     27:  * occurs when the macro has been detected and its arguments parsed.
                     28:  * Post-validation occurs when all child macros have also been parsed.
                     29:  * In the ELEMENT case, this is simply the parameters of the macro; in
                     30:  * the BLOCK case, this is the HEAD, BODY, TAIL and so on.
                     31:  */
                     32:
1.55      kristaps   33: #define        PRE_ARGS        struct mdoc *mdoc, const struct mdoc_node *n
                     34: #define        POST_ARGS       struct mdoc *mdoc
                     35:
                     36: typedef        int     (*v_pre)(PRE_ARGS);
                     37: typedef        int     (*v_post)(POST_ARGS);
1.14      kristaps   38:
1.36      kristaps   39: /* FIXME: some sections should only occur in specific msecs. */
                     40: /* FIXME: ignoring Pp. */
                     41: /* FIXME: math symbols. */
                     42:
1.14      kristaps   43: struct valids {
1.24      kristaps   44:        v_pre   *pre;
1.17      kristaps   45:        v_post  *post;
1.14      kristaps   46: };
1.1       kristaps   47:
1.37      kristaps   48: /* Utility checks. */
                     49:
1.55      kristaps   50: static int     check_parent(PRE_ARGS, int, enum mdoc_type);
                     51: static int     check_msec(PRE_ARGS, int, enum mdoc_msec *);
                     52: static int     check_stdarg(PRE_ARGS);
                     53:
                     54: static int     check_text(struct mdoc *,
1.63    ! kristaps   55:                        int, int, const char *);
1.55      kristaps   56:
1.51      kristaps   57: static int     err_child_lt(struct mdoc *, const char *, int);
1.59      kristaps   58: static int     warn_child_lt(struct mdoc *, const char *, int);
1.51      kristaps   59: static int     err_child_gt(struct mdoc *, const char *, int);
                     60: static int     warn_child_gt(struct mdoc *, const char *, int);
                     61: static int     err_child_eq(struct mdoc *, const char *, int);
                     62: static int     warn_child_eq(struct mdoc *, const char *, int);
                     63:
                     64: /* Utility auxiliaries. */
                     65:
                     66: static inline int count_child(struct mdoc *);
                     67: static inline int warn_count(struct mdoc *, const char *,
                     68:                        int, const char *, int);
                     69: static inline int err_count(struct mdoc *, const char *,
                     70:                        int, const char *, int);
1.11      kristaps   71:
1.37      kristaps   72: /* Specific pre-child-parse routines. */
                     73:
1.55      kristaps   74: static int     pre_display(PRE_ARGS);
                     75: static int     pre_sh(PRE_ARGS);
                     76: static int     pre_ss(PRE_ARGS);
                     77: static int     pre_bd(PRE_ARGS);
                     78: static int     pre_bl(PRE_ARGS);
                     79: static int     pre_it(PRE_ARGS);
                     80: static int     pre_cd(PRE_ARGS);
                     81: static int     pre_er(PRE_ARGS);
                     82: static int     pre_ex(PRE_ARGS);
                     83: static int     pre_rv(PRE_ARGS);
                     84: static int     pre_an(PRE_ARGS);
                     85: static int     pre_st(PRE_ARGS);
                     86: static int     pre_prologue(PRE_ARGS);
                     87: static int     pre_prologue(PRE_ARGS);
                     88: static int     pre_prologue(PRE_ARGS);
1.24      kristaps   89:
1.37      kristaps   90: /* Specific post-child-parse routines. */
                     91:
1.55      kristaps   92: static int     herr_ge1(POST_ARGS);
1.59      kristaps   93: static int     hwarn_le1(POST_ARGS);
1.55      kristaps   94: static int     herr_eq0(POST_ARGS);
                     95: static int     eerr_eq0(POST_ARGS);
                     96: static int     eerr_le1(POST_ARGS);
                     97: static int     eerr_le2(POST_ARGS);
                     98: static int     eerr_eq1(POST_ARGS);
                     99: static int     eerr_ge1(POST_ARGS);
                    100: static int     ewarn_eq0(POST_ARGS);
                    101: static int     ewarn_eq1(POST_ARGS);
                    102: static int     bwarn_ge1(POST_ARGS);
1.58      kristaps  103: static int     hwarn_eq1(POST_ARGS);
1.55      kristaps  104: static int     ewarn_ge1(POST_ARGS);
                    105: static int     ebool(POST_ARGS);
                    106:
                    107: static int     post_sh(POST_ARGS);
                    108: static int     post_sh_body(POST_ARGS);
                    109: static int     post_sh_head(POST_ARGS);
1.57      kristaps  110: static int     post_fd(POST_ARGS);
1.55      kristaps  111: static int     post_bl(POST_ARGS);
                    112: static int     post_it(POST_ARGS);
                    113: static int     post_ex(POST_ARGS);
                    114: static int     post_an(POST_ARGS);
                    115: static int     post_at(POST_ARGS);
                    116: static int     post_xr(POST_ARGS);
                    117: static int     post_nm(POST_ARGS);
                    118: static int     post_bf(POST_ARGS);
                    119: static int     post_root(POST_ARGS);
1.37      kristaps  120:
                    121: /* Collections of pre-child-parse routines. */
1.17      kristaps  122:
1.24      kristaps  123: static v_pre   pres_prologue[] = { pre_prologue, NULL };
                    124: static v_pre   pres_d1[] = { pre_display, NULL };
                    125: static v_pre   pres_bd[] = { pre_display, pre_bd, NULL };
                    126: static v_pre   pres_bl[] = { pre_bl, NULL };
1.25      kristaps  127: static v_pre   pres_it[] = { pre_it, NULL };
1.33      kristaps  128: static v_pre   pres_ss[] = { pre_ss, NULL };
                    129: static v_pre   pres_sh[] = { pre_sh, NULL };
                    130: static v_pre   pres_cd[] = { pre_cd, NULL };
                    131: static v_pre   pres_er[] = { pre_er, NULL };
                    132: static v_pre   pres_ex[] = { pre_ex, NULL };
1.36      kristaps  133: static v_pre   pres_rv[] = { pre_rv, NULL };
1.35      kristaps  134: static v_pre   pres_an[] = { pre_an, NULL };
1.36      kristaps  135: static v_pre   pres_st[] = { pre_st, NULL };
1.24      kristaps  136:
1.37      kristaps  137: /* Collections of post-child-parse routines. */
                    138:
                    139: static v_post  posts_bool[] = { eerr_eq1, ebool, NULL };
                    140: static v_post  posts_bd[] = { herr_eq0, bwarn_ge1, NULL };
                    141: static v_post  posts_text[] = { eerr_ge1, NULL };
                    142: static v_post  posts_wtext[] = { ewarn_ge1, NULL };
                    143: static v_post  posts_notext[] = { eerr_eq0, NULL };
1.43      kristaps  144: static v_post  posts_wline[] = { bwarn_ge1, herr_eq0, NULL };
1.37      kristaps  145: static v_post  posts_sh[] = { herr_ge1, bwarn_ge1, post_sh, NULL };
                    146: static v_post  posts_bl[] = { herr_eq0, bwarn_ge1, post_bl, NULL };
1.25      kristaps  147: static v_post  posts_it[] = { post_it, NULL };
1.39      kristaps  148: static v_post  posts_in[] = { ewarn_eq1, NULL };
1.37      kristaps  149: static v_post  posts_ss[] = { herr_ge1, NULL };
1.52      kristaps  150: static v_post  posts_pf[] = { eerr_eq1, NULL };
1.37      kristaps  151: static v_post  posts_pp[] = { ewarn_eq0, NULL };
                    152: static v_post  posts_ex[] = { eerr_le1, post_ex, NULL };
1.35      kristaps  153: static v_post  posts_an[] = { post_an, NULL };
1.37      kristaps  154: static v_post  posts_at[] = { post_at, NULL };
                    155: static v_post  posts_xr[] = { eerr_ge1, eerr_le2, post_xr, NULL };
                    156: static v_post  posts_nm[] = { post_nm, NULL };
1.59      kristaps  157: static v_post  posts_bf[] = { hwarn_le1, post_bf, NULL };
1.45      kristaps  158: static v_post  posts_rs[] = { herr_eq0, bwarn_ge1, NULL };
1.58      kristaps  159: static v_post  posts_fo[] = { hwarn_eq1, bwarn_ge1, NULL };
1.45      kristaps  160: static v_post  posts_bk[] = { herr_eq0, bwarn_ge1, NULL };
1.57      kristaps  161: static v_post  posts_fd[] = { ewarn_ge1, post_fd, NULL };
1.9       kristaps  162:
1.37      kristaps  163: /* Per-macro pre- and post-child-check routine collections. */
1.12      kristaps  164:
1.9       kristaps  165: const  struct valids mdoc_valids[MDOC_MAX] = {
1.51      kristaps  166:        { NULL, NULL },                         /* \" */
                    167:        { pres_prologue, posts_text },          /* Dd */
                    168:        { pres_prologue, NULL },                /* Dt */
                    169:        { pres_prologue, NULL },                /* Os */
                    170:        { pres_sh, posts_sh },                  /* Sh */
                    171:        { pres_ss, posts_ss },                  /* Ss */
                    172:        { NULL, posts_pp },                     /* Pp */
                    173:        { pres_d1, posts_wline },               /* D1 */
                    174:        { pres_d1, posts_wline },               /* Dl */
                    175:        { pres_bd, posts_bd },                  /* Bd */
                    176:        { NULL, NULL },                         /* Ed */
                    177:        { pres_bl, posts_bl },                  /* Bl */
                    178:        { NULL, NULL },                         /* El */
                    179:        { pres_it, posts_it },                  /* It */
                    180:        { NULL, posts_text },                   /* Ad */
                    181:        { pres_an, posts_an },                  /* An */
                    182:        { NULL, NULL },                         /* Ar */
                    183:        { pres_cd, posts_text },                /* Cd */
                    184:        { NULL, NULL },                         /* Cm */
                    185:        { NULL, posts_text },                   /* Dv */
                    186:        { pres_er, posts_text },                /* Er */
                    187:        { NULL, posts_text },                   /* Ev */
                    188:        { pres_ex, posts_ex },                  /* Ex */
                    189:        { NULL, posts_text },                   /* Fa */
1.57      kristaps  190:        { NULL, posts_fd },                     /* Fd */
1.51      kristaps  191:        { NULL, NULL },                         /* Fl */
                    192:        { NULL, posts_text },                   /* Fn */
                    193:        { NULL, posts_wtext },                  /* Ft */
                    194:        { NULL, posts_text },                   /* Ic */
                    195:        { NULL, posts_in },                     /* In */
                    196:        { NULL, posts_text },                   /* Li */
                    197:        { NULL, posts_wtext },                  /* Nd */
                    198:        { NULL, posts_nm },                     /* Nm */
                    199:        { NULL, posts_wline },                  /* Op */
                    200:        { NULL, NULL },                         /* Ot */
                    201:        { NULL, NULL },                         /* Pa */
                    202:        { pres_rv, posts_notext },              /* Rv */
                    203:        { pres_st, posts_notext },              /* St */
                    204:        { NULL, posts_text },                   /* Va */
                    205:        { NULL, posts_text },                   /* Vt */
                    206:        { NULL, posts_xr },                     /* Xr */
                    207:        { NULL, posts_text },                   /* %A */
                    208:        { NULL, posts_text },                   /* %B */
                    209:        { NULL, posts_text },                   /* %D */
                    210:        { NULL, posts_text },                   /* %I */
                    211:        { NULL, posts_text },                   /* %J */
                    212:        { NULL, posts_text },                   /* %N */
                    213:        { NULL, posts_text },                   /* %O */
                    214:        { NULL, posts_text },                   /* %P */
                    215:        { NULL, posts_text },                   /* %R */
                    216:        { NULL, posts_text },                   /* %T */
                    217:        { NULL, posts_text },                   /* %V */
                    218:        { NULL, NULL },                         /* Ac */
                    219:        { NULL, NULL },                         /* Ao */
                    220:        { NULL, posts_wline },                  /* Aq */
                    221:        { NULL, posts_at },                     /* At */
                    222:        { NULL, NULL },                         /* Bc */
                    223:        { NULL, posts_bf },                     /* Bf */
                    224:        { NULL, NULL },                         /* Bo */
                    225:        { NULL, posts_wline },                  /* Bq */
                    226:        { NULL, NULL },                         /* Bsx */
                    227:        { NULL, NULL },                         /* Bx */
                    228:        { NULL, posts_bool },                   /* Db */
                    229:        { NULL, NULL },                         /* Dc */
                    230:        { NULL, NULL },                         /* Do */
                    231:        { NULL, posts_wline },                  /* Dq */
                    232:        { NULL, NULL },                         /* Ec */
                    233:        { NULL, NULL },                         /* Ef */
                    234:        { NULL, posts_text },                   /* Em */
                    235:        { NULL, NULL },                         /* Eo */
                    236:        { NULL, NULL },                         /* Fx */
                    237:        { NULL, posts_text },                   /* Ms */
                    238:        { NULL, posts_notext },                 /* No */
                    239:        { NULL, posts_notext },                 /* Ns */
                    240:        { NULL, NULL },                         /* Nx */
                    241:        { NULL, NULL },                         /* Ox */
                    242:        { NULL, NULL },                         /* Pc */
1.52      kristaps  243:        { NULL, posts_pf },                     /* Pf */
1.51      kristaps  244:        { NULL, NULL },                         /* Po */
                    245:        { NULL, posts_wline },                  /* Pq */
                    246:        { NULL, NULL },                         /* Qc */
                    247:        { NULL, posts_wline },                  /* Ql */
                    248:        { NULL, NULL },                         /* Qo */
                    249:        { NULL, posts_wline },                  /* Qq */
                    250:        { NULL, NULL },                         /* Re */
                    251:        { NULL, posts_rs },                     /* Rs */
                    252:        { NULL, NULL },                         /* Sc */
                    253:        { NULL, NULL },                         /* So */
                    254:        { NULL, posts_wline },                  /* Sq */
                    255:        { NULL, posts_bool },                   /* Sm */
                    256:        { NULL, posts_text },                   /* Sx */
                    257:        { NULL, posts_text },                   /* Sy */
                    258:        { NULL, posts_text },                   /* Tn */
                    259:        { NULL, NULL },                         /* Ux */
                    260:        { NULL, NULL },                         /* Xc */
                    261:        { NULL, NULL },                         /* Xo */
                    262:        { NULL, posts_fo },                     /* Fo */
                    263:        { NULL, NULL },                         /* Fc */
                    264:        { NULL, NULL },                         /* Oo */
                    265:        { NULL, NULL },                         /* Oc */
                    266:        { NULL, posts_bk },                     /* Bk */
                    267:        { NULL, NULL },                         /* Ek */
                    268:        { NULL, posts_notext },                 /* Bt */
                    269:        { NULL, NULL },                         /* Hf */
                    270:        { NULL, NULL },                         /* Fr */
                    271:        { NULL, posts_notext },                 /* Ud */
1.9       kristaps  272: };
1.6       kristaps  273:
                    274:
1.57      kristaps  275: int
                    276: mdoc_valid_pre(struct mdoc *mdoc,
                    277:                const struct mdoc_node *node)
                    278: {
                    279:        v_pre           *p;
                    280:        struct mdoc_arg *argv;
1.63    ! kristaps  281:        size_t           argc;
        !           282:        int              line, pos, i, j;
1.57      kristaps  283:        const char      *tp;
                    284:
                    285:        if (MDOC_TEXT == node->type) {
                    286:                tp = node->data.text.string;
                    287:                line = node->line;
                    288:                pos = node->pos;
                    289:                return(check_text(mdoc, line, pos, tp));
                    290:        }
                    291:
                    292:        if (MDOC_BLOCK == node->type || MDOC_ELEM == node->type) {
                    293:                argv = MDOC_BLOCK == node->type ?
                    294:                        node->data.block.argv :
                    295:                        node->data.elem.argv;
                    296:                argc = MDOC_BLOCK == node->type ?
                    297:                        node->data.block.argc :
                    298:                        node->data.elem.argc;
                    299:
1.63    ! kristaps  300:                for (i = 0; i < (int)argc; i++) {
1.57      kristaps  301:                        if (0 == argv[i].sz)
                    302:                                continue;
1.63    ! kristaps  303:                        for (j = 0; j < (int)argv[i].sz; j++) {
1.57      kristaps  304:                                tp = argv[i].value[j];
                    305:                                line = argv[i].line;
                    306:                                pos = argv[i].pos;
                    307:                                if ( ! check_text(mdoc, line, pos, tp))
                    308:                                        return(0);
                    309:                        }
                    310:                }
                    311:        }
                    312:
                    313:        if (NULL == mdoc_valids[node->tok].pre)
                    314:                return(1);
                    315:        for (p = mdoc_valids[node->tok].pre; *p; p++)
                    316:                if ( ! (*p)(mdoc, node))
                    317:                        return(0);
                    318:        return(1);
                    319: }
                    320:
                    321:
                    322: int
                    323: mdoc_valid_post(struct mdoc *mdoc)
                    324: {
                    325:        v_post          *p;
                    326:
                    327:        /*
                    328:         * This check occurs after the macro's children have been filled
                    329:         * in: postfix validation.  Since this happens when we're
                    330:         * rewinding the scope tree, it's possible to have multiple
                    331:         * invocations (as by design, for now), we set bit MDOC_VALID to
                    332:         * indicate that we've validated.
                    333:         */
                    334:
                    335:        if (MDOC_VALID & mdoc->last->flags)
                    336:                return(1);
                    337:        mdoc->last->flags |= MDOC_VALID;
                    338:
                    339:        if (MDOC_TEXT == mdoc->last->type)
                    340:                return(1);
                    341:        if (MDOC_ROOT == mdoc->last->type)
                    342:                return(post_root(mdoc));
                    343:
                    344:        if (NULL == mdoc_valids[mdoc->last->tok].post)
                    345:                return(1);
                    346:        for (p = mdoc_valids[mdoc->last->tok].post; *p; p++)
                    347:                if ( ! (*p)(mdoc))
                    348:                        return(0);
                    349:
                    350:        return(1);
                    351: }
                    352:
                    353:
                    354:
1.51      kristaps  355: static inline int
                    356: warn_count(struct mdoc *m, const char *k,
                    357:                int want, const char *v, int has)
                    358: {
                    359:
1.55      kristaps  360:        return(mdoc_warn(m, WARN_SYNTAX,
1.58      kristaps  361:                                "suggests %s %s %d (has %d)",
                    362:                                v, k, want, has));
1.51      kristaps  363: }
                    364:
                    365:
                    366: static inline int
                    367: err_count(struct mdoc *m, const char *k,
                    368:                int want, const char *v, int has)
                    369: {
                    370:
1.58      kristaps  371:        return(mdoc_err(m, "requires %s %s %d (has %d)",
                    372:                                v, k, want, has));
1.51      kristaps  373: }
                    374:
                    375:
                    376: static inline int
                    377: count_child(struct mdoc *mdoc)
1.36      kristaps  378: {
1.51      kristaps  379:        int               i;
1.36      kristaps  380:        struct mdoc_node *n;
                    381:
                    382:        for (i = 0, n = mdoc->last->child; n; n = n->next, i++)
                    383:                /* Do nothing */ ;
1.53      kristaps  384:
1.36      kristaps  385:        return(i);
                    386: }
                    387:
                    388:
1.53      kristaps  389: /*
                    390:  * Build these up with macros because they're basically the same check
                    391:  * for different inequalities.  Yes, this could be done with functions,
                    392:  * but this is reasonable for now.
                    393:  */
1.36      kristaps  394:
1.53      kristaps  395: #define CHECK_CHILD_DEFN(lvl, name, ineq)                      \
                    396: static int                                                     \
                    397: lvl##_child_##name(struct mdoc *mdoc, const char *p, int sz)   \
                    398: {                                                              \
                    399:        int i;                                                  \
                    400:        if ((i = count_child(mdoc)) ineq sz)                    \
                    401:                return(1);                                      \
                    402:        return(lvl##_count(mdoc, #ineq, sz, p, i));             \
                    403: }
                    404:
                    405: #define CHECK_BODY_DEFN(name, lvl, func, num)                  \
                    406: static int                                                     \
1.55      kristaps  407: b##lvl##_##name(POST_ARGS)                                     \
1.53      kristaps  408: {                                                              \
                    409:        if (MDOC_BODY != mdoc->last->type)                      \
                    410:                return(1);                                      \
                    411:        return(func(mdoc, "multiline parameters", (num)));      \
                    412: }
                    413:
                    414: #define CHECK_ELEM_DEFN(name, lvl, func, num)                  \
                    415: static int                                                     \
1.55      kristaps  416: e##lvl##_##name(POST_ARGS)                                     \
1.53      kristaps  417: {                                                              \
                    418:        assert(MDOC_ELEM == mdoc->last->type);                  \
                    419:        return(func(mdoc, "line parameters", (num)));           \
                    420: }
                    421:
                    422: #define CHECK_HEAD_DEFN(name, lvl, func, num)                  \
                    423: static int                                                     \
1.55      kristaps  424: h##lvl##_##name(POST_ARGS)                                     \
1.53      kristaps  425: {                                                              \
                    426:        if (MDOC_HEAD != mdoc->last->type)                      \
                    427:                return(1);                                      \
1.58      kristaps  428:        return(func(mdoc, "line parameters", (num)));           \
1.36      kristaps  429: }
                    430:
                    431:
1.53      kristaps  432: CHECK_CHILD_DEFN(warn, gt, >)                  /* warn_child_gt() */
                    433: CHECK_CHILD_DEFN(err, gt, >)                   /* err_child_gt() */
                    434: CHECK_CHILD_DEFN(warn, eq, ==)                 /* warn_child_eq() */
                    435: CHECK_CHILD_DEFN(err, eq, ==)                  /* err_child_eq() */
                    436: CHECK_CHILD_DEFN(err, lt, <)                   /* err_child_lt() */
1.59      kristaps  437: CHECK_CHILD_DEFN(warn, lt, <)                  /* warn_child_lt() */
1.53      kristaps  438: CHECK_BODY_DEFN(ge1, warn, warn_child_gt, 0)   /* bwarn_ge1() */
                    439: CHECK_ELEM_DEFN(eq1, warn, warn_child_eq, 1)   /* ewarn_eq1() */
                    440: CHECK_ELEM_DEFN(eq0, warn, warn_child_eq, 0)   /* ewarn_eq0() */
                    441: CHECK_ELEM_DEFN(ge1, warn, warn_child_gt, 0)   /* ewarn_gt1() */
                    442: CHECK_ELEM_DEFN(eq1, err, err_child_eq, 1)     /* eerr_eq1() */
                    443: CHECK_ELEM_DEFN(le2, err, err_child_lt, 3)     /* eerr_le2() */
                    444: CHECK_ELEM_DEFN(le1, err, err_child_lt, 2)     /* eerr_le1() */
                    445: CHECK_ELEM_DEFN(eq0, err, err_child_eq, 0)     /* eerr_eq0() */
                    446: CHECK_ELEM_DEFN(ge1, err, err_child_gt, 0)     /* eerr_ge1() */
                    447: CHECK_HEAD_DEFN(eq0, err, err_child_eq, 0)     /* herr_eq0() */
1.59      kristaps  448: CHECK_HEAD_DEFN(le1, warn, warn_child_lt, 2)   /* hwarn_le1() */
1.53      kristaps  449: CHECK_HEAD_DEFN(ge1, err, err_child_gt, 0)     /* herr_ge1() */
1.58      kristaps  450: CHECK_HEAD_DEFN(eq1, warn, warn_child_eq, 1)   /* hwarn_eq1() */
1.36      kristaps  451:
                    452:
                    453: static int
1.55      kristaps  454: check_stdarg(PRE_ARGS)
1.36      kristaps  455: {
                    456:
1.55      kristaps  457:        if (MDOC_Std == n->data.elem.argv[0].arg &&
                    458:                        1 == n->data.elem.argc)
1.36      kristaps  459:                return(1);
1.51      kristaps  460:
1.55      kristaps  461:        return(mdoc_nwarn(mdoc, n, WARN_COMPAT,
1.53      kristaps  462:                                "one argument suggested"));
1.36      kristaps  463: }
                    464:
                    465:
                    466: static int
1.55      kristaps  467: check_msec(PRE_ARGS, int sz, enum mdoc_msec *msecs)
1.33      kristaps  468: {
                    469:        int              i;
                    470:
                    471:        for (i = 0; i < sz; i++)
                    472:                if (msecs[i] == mdoc->meta.msec)
                    473:                        return(1);
1.55      kristaps  474:        return(mdoc_nwarn(mdoc, n, WARN_COMPAT,
                    475:                                "invalid manual section"));
                    476: }
                    477:
                    478:
                    479: static int
1.63    ! kristaps  480: check_text(struct mdoc *mdoc, int line, int pos, const char *p)
1.55      kristaps  481: {
                    482:        size_t           c;
                    483:
1.62      kristaps  484:        /* XXX - indicate deprecated escapes \*(xx and \*x. */
                    485:
1.55      kristaps  486:        for ( ; *p; p++) {
1.60      kristaps  487:                if ( ! isprint((int)*p) && '\t' != *p)
1.56      kristaps  488:                        return(mdoc_perr(mdoc, line, pos,
                    489:                                        "invalid characters"));
1.55      kristaps  490:                if ('\\' != *p)
                    491:                        continue;
                    492:                if ((c = mdoc_isescape(p))) {
1.63    ! kristaps  493:                        p += (int)c - 1;
1.55      kristaps  494:                        continue;
                    495:                }
                    496:                return(mdoc_perr(mdoc, line, pos,
1.56      kristaps  497:                                        "invalid escape sequence"));
1.55      kristaps  498:        }
                    499:
                    500:        return(1);
1.14      kristaps  501: }
                    502:
                    503:
1.55      kristaps  504:
                    505:
1.14      kristaps  506: static int
1.55      kristaps  507: check_parent(PRE_ARGS, int tok, enum mdoc_type t)
1.54      kristaps  508: {
                    509:
                    510:        assert(n->parent);
                    511:        if ((MDOC_ROOT == t || tok == n->parent->tok) &&
                    512:                        (t == n->parent->type))
                    513:                return(1);
                    514:
                    515:        return(mdoc_nerr(mdoc, n, "require parent %s",
                    516:                MDOC_ROOT == t ? "<root>" : mdoc_macronames[tok]));
                    517: }
                    518:
                    519:
                    520:
                    521: static int
1.55      kristaps  522: pre_display(PRE_ARGS)
1.23      kristaps  523: {
1.55      kristaps  524:        struct mdoc_node *node;
1.23      kristaps  525:
1.53      kristaps  526:        /* Display elements (`Bd', `D1'...) cannot be nested. */
                    527:
1.55      kristaps  528:        if (MDOC_BLOCK != n->type)
1.24      kristaps  529:                return(1);
                    530:
1.38      kristaps  531:        /* LINTED */
1.55      kristaps  532:        for (node = mdoc->last->parent; node; node = node->parent)
                    533:                if (MDOC_BLOCK == node->type)
                    534:                        if (MDOC_Bd == node->tok)
1.23      kristaps  535:                                break;
1.55      kristaps  536:        if (NULL == node)
1.23      kristaps  537:                return(1);
1.53      kristaps  538:
1.55      kristaps  539:        return(mdoc_nerr(mdoc, n, "displays may not be nested"));
1.23      kristaps  540: }
                    541:
                    542:
                    543: static int
1.55      kristaps  544: pre_bl(PRE_ARGS)
1.24      kristaps  545: {
1.61      kristaps  546:        int              type, i, width, offset;
1.24      kristaps  547:        struct mdoc_arg *argv;
1.53      kristaps  548:        size_t           argc;
1.24      kristaps  549:
1.55      kristaps  550:        if (MDOC_BLOCK != n->type)
1.24      kristaps  551:                return(1);
                    552:
1.55      kristaps  553:        argc = n->data.block.argc;
1.24      kristaps  554:
1.53      kristaps  555:        /* Make sure that only one type of list is specified.  */
                    556:
1.61      kristaps  557:        type = offset = width = -1;
                    558:
1.38      kristaps  559:        /* LINTED */
1.61      kristaps  560:        for (i = 0; i < (int)argc; i++) {
1.55      kristaps  561:                argv = &n->data.block.argv[i];
1.53      kristaps  562:
1.24      kristaps  563:                switch (argv->arg) {
                    564:                case (MDOC_Bullet):
                    565:                        /* FALLTHROUGH */
                    566:                case (MDOC_Dash):
                    567:                        /* FALLTHROUGH */
                    568:                case (MDOC_Enum):
                    569:                        /* FALLTHROUGH */
                    570:                case (MDOC_Hyphen):
                    571:                        /* FALLTHROUGH */
                    572:                case (MDOC_Item):
                    573:                        /* FALLTHROUGH */
                    574:                case (MDOC_Tag):
                    575:                        /* FALLTHROUGH */
                    576:                case (MDOC_Diag):
                    577:                        /* FALLTHROUGH */
                    578:                case (MDOC_Hang):
                    579:                        /* FALLTHROUGH */
                    580:                case (MDOC_Ohang):
                    581:                        /* FALLTHROUGH */
                    582:                case (MDOC_Inset):
1.26      kristaps  583:                        /* FALLTHROUGH */
                    584:                case (MDOC_Column):
1.61      kristaps  585:                        if (-1 == type) {
                    586:                                type = argv->arg;
1.53      kristaps  587:                                break;
1.61      kristaps  588:                        }
1.53      kristaps  589:                        return(mdoc_perr(mdoc, argv->line, argv->pos,
                    590:                                        "multiple types specified"));
1.61      kristaps  591:                case (MDOC_Width):
                    592:                        if (-1 == width) {
                    593:                                width = argv->arg;
                    594:                                break;
                    595:                        }
                    596:                        return(mdoc_perr(mdoc, argv->line, argv->pos,
                    597:                                        "multiple -%s arguments",
                    598:                                        mdoc_argnames[MDOC_Width]));
                    599:                case (MDOC_Offset):
                    600:                        if (-1 == offset) {
                    601:                                offset = argv->arg;
                    602:                                break;
                    603:                        }
                    604:                        return(mdoc_perr(mdoc, argv->line, argv->pos,
                    605:                                        "multiple -%s arguments",
                    606:                                        mdoc_argnames[MDOC_Offset]));
1.24      kristaps  607:                default:
                    608:                        break;
                    609:                }
                    610:        }
1.53      kristaps  611:
1.61      kristaps  612:        if (-1 == type)
                    613:                return(mdoc_err(mdoc, "no type specified"));
                    614:
                    615:        switch (type) {
                    616:        case (MDOC_Column):
                    617:                /* FALLTHROUGH */
                    618:        case (MDOC_Diag):
                    619:                /* FALLTHROUGH */
                    620:        case (MDOC_Inset):
                    621:                /* FALLTHROUGH */
                    622:        case (MDOC_Item):
                    623:                if (-1 == width)
                    624:                        break;
                    625:                return(mdoc_nwarn(mdoc, n, WARN_SYNTAX,
                    626:                                "superfluous -%s argument",
                    627:                                mdoc_argnames[MDOC_Width]));
                    628:        case (MDOC_Tag):
                    629:                if (-1 != width)
                    630:                        break;
                    631:                return(mdoc_nwarn(mdoc, n, WARN_SYNTAX,
                    632:                                "suggest -%s argument",
                    633:                                mdoc_argnames[MDOC_Width]));
                    634:        default:
                    635:                break;
                    636:        }
                    637:
                    638:        return(1);
1.24      kristaps  639: }
                    640:
                    641:
                    642: static int
1.55      kristaps  643: pre_bd(PRE_ARGS)
1.24      kristaps  644: {
1.53      kristaps  645:        int              type, err, i;
1.24      kristaps  646:        struct mdoc_arg *argv;
1.53      kristaps  647:        size_t           argc;
1.24      kristaps  648:
1.55      kristaps  649:        if (MDOC_BLOCK != n->type)
1.24      kristaps  650:                return(1);
                    651:
1.55      kristaps  652:        argc = n->data.block.argc;
1.24      kristaps  653:
1.53      kristaps  654:        /* Make sure that only one type of display is specified.  */
                    655:
1.38      kristaps  656:        /* LINTED */
1.53      kristaps  657:        for (i = 0, err = type = 0; ! err && i < (int)argc; i++) {
1.55      kristaps  658:                argv = &n->data.block.argv[i];
1.53      kristaps  659:
1.24      kristaps  660:                switch (argv->arg) {
                    661:                case (MDOC_Ragged):
                    662:                        /* FALLTHROUGH */
                    663:                case (MDOC_Unfilled):
                    664:                        /* FALLTHROUGH */
1.29      kristaps  665:                case (MDOC_Filled):
                    666:                        /* FALLTHROUGH */
1.24      kristaps  667:                case (MDOC_Literal):
                    668:                        /* FALLTHROUGH */
                    669:                case (MDOC_File):
1.53      kristaps  670:                        if (0 == type++)
                    671:                                break;
                    672:                        return(mdoc_perr(mdoc, argv->line, argv->pos,
                    673:                                        "multiple types specified"));
1.24      kristaps  674:                default:
                    675:                        break;
                    676:                }
                    677:        }
1.53      kristaps  678:
                    679:        if (type)
                    680:                return(1);
                    681:        return(mdoc_err(mdoc, "no type specified"));
1.24      kristaps  682: }
                    683:
                    684:
                    685: static int
1.55      kristaps  686: pre_ss(PRE_ARGS)
1.33      kristaps  687: {
                    688:
1.55      kristaps  689:        if (MDOC_BLOCK != n->type)
1.33      kristaps  690:                return(1);
1.55      kristaps  691:        return(check_parent(mdoc, n, MDOC_Sh, MDOC_BODY));
1.33      kristaps  692: }
                    693:
                    694:
                    695: static int
1.55      kristaps  696: pre_sh(PRE_ARGS)
1.33      kristaps  697: {
                    698:
1.55      kristaps  699:        if (MDOC_BLOCK != n->type)
1.33      kristaps  700:                return(1);
1.55      kristaps  701:        return(check_parent(mdoc, n, -1, MDOC_ROOT));
1.33      kristaps  702: }
                    703:
                    704:
                    705: static int
1.55      kristaps  706: pre_it(PRE_ARGS)
1.53      kristaps  707: {
                    708:
                    709:        /* TODO: children too big for -width? */
                    710:
1.55      kristaps  711:        if (MDOC_BLOCK != n->type)
1.53      kristaps  712:                return(1);
1.55      kristaps  713:        return(check_parent(mdoc, n, MDOC_Bl, MDOC_BODY));
1.53      kristaps  714: }
                    715:
                    716:
                    717: static int
1.55      kristaps  718: pre_st(PRE_ARGS)
1.36      kristaps  719: {
                    720:
1.55      kristaps  721:        if (1 == n->data.elem.argc)
1.36      kristaps  722:                return(1);
1.55      kristaps  723:        return(mdoc_nerr(mdoc, n, "one argument required"));
1.36      kristaps  724: }
                    725:
                    726:
                    727: static int
1.55      kristaps  728: pre_an(PRE_ARGS)
1.35      kristaps  729: {
1.36      kristaps  730:
1.55      kristaps  731:        if (1 >= n->data.elem.argc)
1.35      kristaps  732:                return(1);
1.55      kristaps  733:        return(mdoc_nerr(mdoc, n, "one argument allowed"));
1.35      kristaps  734: }
                    735:
                    736:
                    737: static int
1.55      kristaps  738: pre_rv(PRE_ARGS)
1.36      kristaps  739: {
1.53      kristaps  740:        enum mdoc_msec msecs[] = { MSEC_2, MSEC_3 };
1.36      kristaps  741:
1.55      kristaps  742:        if ( ! check_msec(mdoc, n, 2, msecs))
1.36      kristaps  743:                return(0);
1.55      kristaps  744:        return(check_stdarg(mdoc, n));
1.36      kristaps  745: }
                    746:
                    747:
                    748: static int
1.55      kristaps  749: pre_ex(PRE_ARGS)
1.33      kristaps  750: {
1.53      kristaps  751:        enum mdoc_msec msecs[] = { MSEC_1, MSEC_6, MSEC_8 };
1.35      kristaps  752:
1.55      kristaps  753:        if ( ! check_msec(mdoc, n, 3, msecs))
1.35      kristaps  754:                return(0);
1.55      kristaps  755:        return(check_stdarg(mdoc, n));
1.33      kristaps  756: }
                    757:
                    758:
                    759: static int
1.55      kristaps  760: pre_er(PRE_ARGS)
1.33      kristaps  761: {
1.53      kristaps  762:        enum mdoc_msec msecs[] = { MSEC_2 };
1.33      kristaps  763:
1.55      kristaps  764:        return(check_msec(mdoc, n, 1, msecs));
1.33      kristaps  765: }
                    766:
                    767:
                    768: static int
1.55      kristaps  769: pre_cd(PRE_ARGS)
1.33      kristaps  770: {
1.53      kristaps  771:        enum mdoc_msec msecs[] = { MSEC_4 };
1.33      kristaps  772:
1.55      kristaps  773:        return(check_msec(mdoc, n, 1, msecs));
1.33      kristaps  774: }
                    775:
                    776:
                    777: static int
1.55      kristaps  778: pre_prologue(PRE_ARGS)
1.20      kristaps  779: {
                    780:
1.46      kristaps  781:        if (SEC_PROLOGUE != mdoc->lastnamed)
1.55      kristaps  782:                return(mdoc_nerr(mdoc, n, "prologue only"));
1.20      kristaps  783:
                    784:        /* Check for ordering. */
                    785:
1.55      kristaps  786:        switch (n->tok) {
1.20      kristaps  787:        case (MDOC_Os):
1.36      kristaps  788:                if (mdoc->meta.title && mdoc->meta.date)
1.20      kristaps  789:                        break;
1.55      kristaps  790:                return(mdoc_nerr(mdoc, n, "prologue out-of-order"));
1.20      kristaps  791:        case (MDOC_Dt):
1.36      kristaps  792:                if (NULL == mdoc->meta.title && mdoc->meta.date)
1.20      kristaps  793:                        break;
1.55      kristaps  794:                return(mdoc_nerr(mdoc, n, "prologue out-of-order"));
1.20      kristaps  795:        case (MDOC_Dd):
1.36      kristaps  796:                if (NULL == mdoc->meta.title && 0 == mdoc->meta.date)
1.20      kristaps  797:                        break;
1.55      kristaps  798:                return(mdoc_nerr(mdoc, n, "prologue out-of-order"));
1.20      kristaps  799:        default:
                    800:                abort();
                    801:                /* NOTREACHED */
                    802:        }
                    803:
                    804:        /* Check for repetition. */
                    805:
1.55      kristaps  806:        switch (n->tok) {
1.20      kristaps  807:        case (MDOC_Os):
1.36      kristaps  808:                if (NULL == mdoc->meta.os)
1.20      kristaps  809:                        return(1);
                    810:                break;
                    811:        case (MDOC_Dd):
                    812:                if (0 == mdoc->meta.date)
                    813:                        return(1);
                    814:                break;
                    815:        case (MDOC_Dt):
1.36      kristaps  816:                if (NULL == mdoc->meta.title)
1.20      kristaps  817:                        return(1);
                    818:                break;
                    819:        default:
                    820:                abort();
                    821:                /* NOTREACHED */
                    822:        }
                    823:
1.55      kristaps  824:        return(mdoc_nerr(mdoc, n, "prologue repetition"));
1.20      kristaps  825: }
                    826:
                    827:
1.35      kristaps  828: static int
1.55      kristaps  829: post_bf(POST_ARGS)
1.41      kristaps  830: {
                    831:        char             *p;
                    832:        struct mdoc_node *head;
                    833:
                    834:        if (MDOC_BLOCK != mdoc->last->type)
                    835:                return(1);
1.53      kristaps  836:
1.41      kristaps  837:        head = mdoc->last->data.block.head;
                    838:
                    839:        if (0 == mdoc->last->data.block.argc) {
1.53      kristaps  840:                if (NULL == head->child)
                    841:                        return(mdoc_err(mdoc, "argument expected"));
                    842:
                    843:                p = head->child->data.text.string;
                    844:                if (xstrcmp(p, "Em"))
                    845:                        return(1);
                    846:                else if (xstrcmp(p, "Li"))
                    847:                        return(1);
                    848:                else if (xstrcmp(p, "Sm"))
                    849:                        return(1);
                    850:                return(mdoc_nerr(mdoc, head->child, "invalid font"));
1.41      kristaps  851:        }
1.53      kristaps  852:
1.41      kristaps  853:        if (head->child)
1.53      kristaps  854:                return(mdoc_err(mdoc, "argument expected"));
                    855:
1.41      kristaps  856:        if (1 == mdoc->last->data.block.argc)
                    857:                return(1);
1.53      kristaps  858:        return(mdoc_err(mdoc, "argument expected"));
1.41      kristaps  859: }
                    860:
                    861:
                    862: static int
1.55      kristaps  863: post_nm(POST_ARGS)
1.37      kristaps  864: {
                    865:
                    866:        if (mdoc->last->child)
                    867:                return(1);
                    868:        if (mdoc->meta.name)
                    869:                return(1);
1.53      kristaps  870:        return(mdoc_err(mdoc, "not yet invoked with name"));
1.37      kristaps  871: }
                    872:
                    873:
                    874: static int
1.55      kristaps  875: post_xr(POST_ARGS)
1.36      kristaps  876: {
                    877:        struct mdoc_node *n;
                    878:
                    879:        if (NULL == (n = mdoc->last->child->next))
                    880:                return(1);
                    881:        if (MSEC_DEFAULT != mdoc_atomsec(n->data.text.string))
                    882:                return(1);
                    883:        return(mdoc_nerr(mdoc, n, "invalid manual section"));
                    884: }
                    885:
                    886:
                    887: static int
1.55      kristaps  888: post_at(POST_ARGS)
1.36      kristaps  889: {
                    890:
1.37      kristaps  891:        if (NULL == mdoc->last->child)
                    892:                return(1);
1.36      kristaps  893:        if (ATT_DEFAULT != mdoc_atoatt(mdoc->last->child->data.text.string))
                    894:                return(1);
1.53      kristaps  895:        return(mdoc_err(mdoc, "require valid symbol"));
1.36      kristaps  896: }
                    897:
                    898:
                    899: static int
1.55      kristaps  900: post_an(POST_ARGS)
1.35      kristaps  901: {
                    902:
                    903:        if (0 != mdoc->last->data.elem.argc) {
                    904:                if (NULL == mdoc->last->child)
                    905:                        return(1);
1.53      kristaps  906:                return(mdoc_err(mdoc, "argument(s) expected"));
1.35      kristaps  907:        }
                    908:
                    909:        if (mdoc->last->child)
                    910:                return(1);
1.53      kristaps  911:        return(mdoc_err(mdoc, "argument(s) expected"));
1.35      kristaps  912: }
                    913:
                    914:
                    915: static int
1.55      kristaps  916: post_ex(POST_ARGS)
1.35      kristaps  917: {
                    918:
                    919:        if (0 == mdoc->last->data.elem.argc) {
                    920:                if (mdoc->last->child)
                    921:                        return(1);
1.53      kristaps  922:                return(mdoc_err(mdoc, "argument(s) expected"));
1.35      kristaps  923:        }
                    924:        if (mdoc->last->child)
1.53      kristaps  925:                return(mdoc_err(mdoc, "argument(s) expected"));
1.35      kristaps  926:        if (1 != mdoc->last->data.elem.argc)
1.53      kristaps  927:                return(mdoc_err(mdoc, "argument(s) expected"));
1.35      kristaps  928:        if (MDOC_Std != mdoc->last->data.elem.argv[0].arg)
1.53      kristaps  929:                return(mdoc_err(mdoc, "argument(s) expected"));
                    930:
1.35      kristaps  931:        return(1);
                    932: }
                    933:
                    934:
1.25      kristaps  935: static int
1.55      kristaps  936: post_it(POST_ARGS)
1.25      kristaps  937: {
1.53      kristaps  938:        int               type, sv, i;
1.25      kristaps  939: #define        TYPE_NONE        (0)
                    940: #define        TYPE_BODY        (1)
                    941: #define        TYPE_HEAD        (2)
1.47      kristaps  942: #define        TYPE_OHEAD       (3)
1.53      kristaps  943:        size_t            argc;
1.25      kristaps  944:        struct mdoc_node *n;
                    945:
                    946:        if (MDOC_BLOCK != mdoc->last->type)
                    947:                return(1);
                    948:
1.53      kristaps  949:        n = mdoc->last->parent->parent;
1.25      kristaps  950:
                    951:        argc = n->data.block.argc;
                    952:        type = TYPE_NONE;
1.38      kristaps  953:        sv = -1;
1.26      kristaps  954:
                    955:        /* Some types require block-head, some not. */
1.25      kristaps  956:
1.38      kristaps  957:        /* LINTED */
1.53      kristaps  958:        for (i = 0; TYPE_NONE == type && i < (int)argc; i++)
                    959:                switch (n->data.block.argv[i].arg) {
1.25      kristaps  960:                case (MDOC_Tag):
                    961:                        /* FALLTHROUGH */
                    962:                case (MDOC_Diag):
                    963:                        /* FALLTHROUGH */
                    964:                case (MDOC_Hang):
                    965:                        /* FALLTHROUGH */
                    966:                case (MDOC_Ohang):
                    967:                        /* FALLTHROUGH */
                    968:                case (MDOC_Inset):
                    969:                        type = TYPE_HEAD;
1.53      kristaps  970:                        sv = n->data.block.argv[i].arg;
1.25      kristaps  971:                        break;
                    972:                case (MDOC_Bullet):
                    973:                        /* FALLTHROUGH */
                    974:                case (MDOC_Dash):
                    975:                        /* FALLTHROUGH */
                    976:                case (MDOC_Enum):
                    977:                        /* FALLTHROUGH */
                    978:                case (MDOC_Hyphen):
                    979:                        /* FALLTHROUGH */
                    980:                case (MDOC_Item):
1.47      kristaps  981:                        type = TYPE_BODY;
1.53      kristaps  982:                        sv = n->data.block.argv[i].arg;
1.47      kristaps  983:                        break;
1.25      kristaps  984:                case (MDOC_Column):
1.47      kristaps  985:                        type = TYPE_OHEAD;
1.53      kristaps  986:                        sv = n->data.block.argv[i].arg;
1.25      kristaps  987:                        break;
                    988:                default:
                    989:                        break;
                    990:                }
                    991:
                    992:        assert(TYPE_NONE != type);
                    993:
1.47      kristaps  994:        n = mdoc->last->data.block.head;
                    995:
1.25      kristaps  996:        if (TYPE_HEAD == type) {
1.33      kristaps  997:                if (NULL == n->child)
1.53      kristaps  998:                        if ( ! mdoc_warn(mdoc, WARN_SYNTAX,
                    999:                                        "argument(s) suggested"))
1.25      kristaps 1000:                                return(0);
                   1001:
1.33      kristaps 1002:                n = mdoc->last->data.block.body;
                   1003:                if (NULL == n->child)
1.53      kristaps 1004:                        if ( ! mdoc_warn(mdoc, WARN_SYNTAX,
                   1005:                                        "multiline body suggested"))
1.25      kristaps 1006:                                return(0);
                   1007:
1.47      kristaps 1008:        } else if (TYPE_BODY == type) {
                   1009:                if (n->child)
1.53      kristaps 1010:                        if ( ! mdoc_warn(mdoc, WARN_SYNTAX,
                   1011:                                        "no argument suggested"))
1.47      kristaps 1012:                                return(0);
                   1013:
                   1014:                n = mdoc->last->data.block.body;
                   1015:                if (NULL == n->child)
1.53      kristaps 1016:                        if ( ! mdoc_warn(mdoc, WARN_SYNTAX,
                   1017:                                        "multiline body suggested"))
1.47      kristaps 1018:                                return(0);
                   1019:        } else {
                   1020:                if (NULL == n->child)
1.53      kristaps 1021:                        if ( ! mdoc_warn(mdoc, WARN_SYNTAX,
                   1022:                                        "argument(s) suggested"))
1.47      kristaps 1023:                                return(0);
                   1024:
                   1025:                n = mdoc->last->data.block.body;
                   1026:                if (n->child)
1.53      kristaps 1027:                        if ( ! mdoc_warn(mdoc, WARN_SYNTAX,
                   1028:                                        "no multiline body suggested"))
1.47      kristaps 1029:                                return(0);
1.25      kristaps 1030:        }
                   1031:
1.47      kristaps 1032:        if (MDOC_Column != sv)
1.26      kristaps 1033:                return(1);
                   1034:
1.38      kristaps 1035:        argc = mdoc->last->parent->parent->data.block.argv->sz;
1.26      kristaps 1036:        n = mdoc->last->data.block.head->child;
1.25      kristaps 1037:
1.26      kristaps 1038:        for (i = 0; n; n = n->next)
                   1039:                i++;
                   1040:
1.53      kristaps 1041:        if (i == (int)argc)
1.26      kristaps 1042:                return(1);
1.53      kristaps 1043:
                   1044:        return(mdoc_err(mdoc, "need %zu columns (have %d)", argc, i));
1.25      kristaps 1045: #undef TYPE_NONE
                   1046: #undef TYPE_BODY
                   1047: #undef TYPE_HEAD
1.47      kristaps 1048: #undef TYPE_OHEAD
1.25      kristaps 1049: }
                   1050:
                   1051:
1.24      kristaps 1052: static int
1.55      kristaps 1053: post_bl(POST_ARGS)
1.24      kristaps 1054: {
1.53      kristaps 1055:        struct mdoc_node        *n;
1.24      kristaps 1056:
                   1057:        if (MDOC_BODY != mdoc->last->type)
                   1058:                return(1);
                   1059:
1.38      kristaps 1060:        /* LINTED */
1.24      kristaps 1061:        for (n = mdoc->last->child; n; n = n->next) {
                   1062:                if (MDOC_BLOCK == n->type)
1.25      kristaps 1063:                        if (MDOC_It == n->tok)
1.24      kristaps 1064:                                continue;
                   1065:                break;
                   1066:        }
1.53      kristaps 1067:
1.24      kristaps 1068:        if (NULL == n)
                   1069:                return(1);
1.53      kristaps 1070:
                   1071:        return(mdoc_nerr(mdoc, n, "bad child of parent list"));
1.24      kristaps 1072: }
                   1073:
                   1074:
1.34      kristaps 1075: static int
1.37      kristaps 1076: ebool(struct mdoc *mdoc)
1.34      kristaps 1077: {
                   1078:        struct mdoc_node *n;
                   1079:
1.38      kristaps 1080:        /* LINTED */
1.34      kristaps 1081:        for (n = mdoc->last->child; n; n = n->next) {
                   1082:                if (MDOC_TEXT != n->type)
                   1083:                        break;
                   1084:                if (xstrcmp(n->data.text.string, "on"))
                   1085:                        continue;
                   1086:                if (xstrcmp(n->data.text.string, "off"))
                   1087:                        continue;
                   1088:                break;
                   1089:        }
1.53      kristaps 1090:
1.34      kristaps 1091:        if (NULL == n)
                   1092:                return(1);
1.53      kristaps 1093:        return(mdoc_nerr(mdoc, n, "expected boolean"));
1.37      kristaps 1094: }
                   1095:
                   1096:
                   1097: static int
1.55      kristaps 1098: post_root(POST_ARGS)
1.37      kristaps 1099: {
                   1100:
1.46      kristaps 1101:        if (NULL == mdoc->first->child)
1.53      kristaps 1102:                return(mdoc_err(mdoc, "document lacks data"));
1.46      kristaps 1103:        if (SEC_PROLOGUE == mdoc->lastnamed)
1.53      kristaps 1104:                return(mdoc_err(mdoc, "document lacks prologue"));
                   1105:
1.46      kristaps 1106:        if (MDOC_BLOCK != mdoc->first->child->type)
1.54      kristaps 1107:                return(mdoc_err(mdoc, "lacking post-prologue %s",
1.53      kristaps 1108:                                        mdoc_macronames[MDOC_Sh]));
1.46      kristaps 1109:        if (MDOC_Sh != mdoc->first->child->tok)
1.54      kristaps 1110:                return(mdoc_err(mdoc, "lacking post-prologue %s",
1.53      kristaps 1111:                                        mdoc_macronames[MDOC_Sh]));
                   1112:
1.37      kristaps 1113:        return(1);
1.34      kristaps 1114: }
                   1115:
                   1116:
1.20      kristaps 1117: static int
1.55      kristaps 1118: post_sh(POST_ARGS)
1.14      kristaps 1119: {
1.46      kristaps 1120:
                   1121:        if (MDOC_HEAD == mdoc->last->type)
                   1122:                return(post_sh_head(mdoc));
                   1123:        if (MDOC_BODY == mdoc->last->type)
                   1124:                return(post_sh_body(mdoc));
1.53      kristaps 1125:
1.46      kristaps 1126:        return(1);
                   1127: }
                   1128:
                   1129:
                   1130: static int
1.55      kristaps 1131: post_sh_body(POST_ARGS)
1.46      kristaps 1132: {
                   1133:        struct mdoc_node *n;
                   1134:
                   1135:        if (SEC_NAME != mdoc->lastnamed)
                   1136:                return(1);
                   1137:
1.51      kristaps 1138:        /*
                   1139:         * Warn if the NAME section doesn't contain the `Nm' and `Nd'
                   1140:         * macros (can have multiple `Nm' and one `Nd').  Note that the
                   1141:         * children of the BODY declaration can also be "text".
                   1142:         */
                   1143:
1.46      kristaps 1144:        if (NULL == (n = mdoc->last->child))
1.54      kristaps 1145:                return(mdoc_warn(mdoc, WARN_SYNTAX,
                   1146:                                        "section should have %s and %s",
1.51      kristaps 1147:                                        mdoc_macronames[MDOC_Nm],
                   1148:                                        mdoc_macronames[MDOC_Nd]));
                   1149:
                   1150:        for ( ; n && n->next; n = n->next) {
                   1151:                if (MDOC_ELEM == n->type && MDOC_Nm == n->tok)
                   1152:                        continue;
                   1153:                if (MDOC_TEXT == n->type)
                   1154:                        continue;
1.54      kristaps 1155:                if ( ! (mdoc_nwarn(mdoc, n, WARN_SYNTAX,
                   1156:                                        "section should have %s first",
1.51      kristaps 1157:                                        mdoc_macronames[MDOC_Nm])))
                   1158:                        return(0);
                   1159:        }
                   1160:
                   1161:        if (MDOC_ELEM == n->type && MDOC_Nd == n->tok)
1.46      kristaps 1162:                return(1);
                   1163:
1.54      kristaps 1164:        return(mdoc_warn(mdoc, WARN_SYNTAX,
                   1165:                                "section should have %s last",
1.51      kristaps 1166:                                mdoc_macronames[MDOC_Nd]));
1.46      kristaps 1167: }
                   1168:
                   1169:
                   1170: static int
1.55      kristaps 1171: post_sh_head(POST_ARGS)
1.46      kristaps 1172: {
1.36      kristaps 1173:        char              buf[64];
1.21      kristaps 1174:        enum mdoc_sec     sec;
                   1175:
1.25      kristaps 1176:        assert(MDOC_Sh == mdoc->last->tok);
1.21      kristaps 1177:
1.54      kristaps 1178:        if ( ! xstrlcats(buf, mdoc->last->child, sizeof(buf)))
                   1179:                return(mdoc_err(mdoc, "argument too long"));
1.14      kristaps 1180:
1.46      kristaps 1181:        sec = mdoc_atosec(buf);
                   1182:
                   1183:        if (SEC_BODY == mdoc->lastnamed && SEC_NAME != sec)
1.54      kristaps 1184:                return(mdoc_warn(mdoc, WARN_SYNTAX,
                   1185:                                "section NAME should be first"));
1.46      kristaps 1186:        if (SEC_CUSTOM == sec)
1.21      kristaps 1187:                return(1);
1.46      kristaps 1188:        if (sec == mdoc->lastnamed)
1.54      kristaps 1189:                return(mdoc_warn(mdoc, WARN_SYNTAX,
                   1190:                                "section repeated"));
1.46      kristaps 1191:        if (sec < mdoc->lastnamed)
1.54      kristaps 1192:                return(mdoc_warn(mdoc, WARN_SYNTAX,
                   1193:                                "section out of order"));
1.46      kristaps 1194:
                   1195:        return(1);
1.11      kristaps 1196: }
                   1197:
                   1198:
1.57      kristaps 1199: static int
                   1200: post_fd(POST_ARGS)
1.11      kristaps 1201: {
1.39      kristaps 1202:
1.57      kristaps 1203:        if (SEC_SYNOPSIS == mdoc->last->sec)
1.25      kristaps 1204:                return(1);
1.57      kristaps 1205:        return(mdoc_warn(mdoc, WARN_COMPAT,
                   1206:                        "suggested only in section SYNOPSIS"));
1.11      kristaps 1207: }

CVSweb