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

Annotation of src/usr.bin/mandoc/mdoc_validate.c, Revision 1.53

1.53    ! schwarze    1: /*     $Id: mdoc_validate.c,v 1.52 2010/05/14 19:52:43 schwarze Exp $ */
1.1       kristaps    2: /*
1.2       schwarze    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.2       schwarze    6:  * purpose with or without fee is hereby granted, provided that the above
                      7:  * copyright notice and this permission notice appear in all copies.
1.1       kristaps    8:  *
1.2       schwarze    9:  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
                     10:  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
                     11:  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
                     12:  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
                     13:  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
                     14:  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
                     15:  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.1       kristaps   16:  */
                     17: #include <sys/types.h>
                     18:
                     19: #include <assert.h>
                     20: #include <ctype.h>
1.31      schwarze   21: #include <limits.h>
1.1       kristaps   22: #include <stdlib.h>
                     23: #include <string.h>
                     24:
                     25: #include "libmdoc.h"
1.15      schwarze   26: #include "libmandoc.h"
1.1       kristaps   27:
                     28: /* FIXME: .Bl -diag can't have non-text children in HEAD. */
                     29: /* TODO: ignoring Pp (it's superfluous in some invocations). */
                     30:
1.28      schwarze   31: #define        PRE_ARGS  struct mdoc *mdoc, const struct mdoc_node *n
                     32: #define        POST_ARGS struct mdoc *mdoc
1.1       kristaps   33:
                     34: typedef        int     (*v_pre)(PRE_ARGS);
                     35: typedef        int     (*v_post)(POST_ARGS);
                     36:
                     37: struct valids {
                     38:        v_pre   *pre;
                     39:        v_post  *post;
                     40: };
                     41:
1.44      schwarze   42: static int      check_parent(PRE_ARGS, enum mdoct, enum mdoc_type);
1.28      schwarze   43: static int      check_stdarg(PRE_ARGS);
                     44: static int      check_text(struct mdoc *, int, int, const char *);
                     45: static int      check_argv(struct mdoc *,
1.1       kristaps   46:                        const struct mdoc_node *,
                     47:                        const struct mdoc_argv *);
1.28      schwarze   48: static int      check_args(struct mdoc *,
1.1       kristaps   49:                        const struct mdoc_node *);
1.28      schwarze   50: static int      err_child_lt(struct mdoc *, const char *, int);
                     51: static int      warn_child_lt(struct mdoc *, const char *, int);
                     52: static int      err_child_gt(struct mdoc *, const char *, int);
                     53: static int      warn_child_gt(struct mdoc *, const char *, int);
                     54: static int      err_child_eq(struct mdoc *, const char *, int);
                     55: static int      warn_child_eq(struct mdoc *, const char *, int);
                     56: static int      warn_count(struct mdoc *, const char *,
1.1       kristaps   57:                        int, const char *, int);
1.28      schwarze   58: static int      err_count(struct mdoc *, const char *,
1.1       kristaps   59:                        int, const char *, int);
1.28      schwarze   60:
                     61: static int      berr_ge1(POST_ARGS);
                     62: static int      bwarn_ge1(POST_ARGS);
                     63: static int      ebool(POST_ARGS);
                     64: static int      eerr_eq0(POST_ARGS);
                     65: static int      eerr_eq1(POST_ARGS);
                     66: static int      eerr_ge1(POST_ARGS);
1.37      schwarze   67: static int      eerr_le1(POST_ARGS);
1.28      schwarze   68: static int      ewarn_ge1(POST_ARGS);
                     69: static int      herr_eq0(POST_ARGS);
                     70: static int      herr_ge1(POST_ARGS);
                     71: static int      hwarn_eq1(POST_ARGS);
1.48      schwarze   72: static int      hwarn_eq0(POST_ARGS);
1.28      schwarze   73: static int      hwarn_le1(POST_ARGS);
                     74:
                     75: static int      post_an(POST_ARGS);
                     76: static int      post_at(POST_ARGS);
                     77: static int      post_bf(POST_ARGS);
                     78: static int      post_bl(POST_ARGS);
                     79: static int      post_bl_head(POST_ARGS);
                     80: static int      post_it(POST_ARGS);
                     81: static int      post_lb(POST_ARGS);
                     82: static int      post_nm(POST_ARGS);
                     83: static int      post_root(POST_ARGS);
1.36      schwarze   84: static int      post_rs(POST_ARGS);
1.28      schwarze   85: static int      post_sh(POST_ARGS);
                     86: static int      post_sh_body(POST_ARGS);
                     87: static int      post_sh_head(POST_ARGS);
                     88: static int      post_st(POST_ARGS);
1.42      schwarze   89: static int      post_vt(POST_ARGS);
1.28      schwarze   90: static int      pre_an(PRE_ARGS);
                     91: static int      pre_bd(PRE_ARGS);
                     92: static int      pre_bl(PRE_ARGS);
                     93: static int      pre_dd(PRE_ARGS);
                     94: static int      pre_display(PRE_ARGS);
                     95: static int      pre_dt(PRE_ARGS);
                     96: static int      pre_it(PRE_ARGS);
                     97: static int      pre_os(PRE_ARGS);
                     98: static int      pre_rv(PRE_ARGS);
                     99: static int      pre_sh(PRE_ARGS);
                    100: static int      pre_ss(PRE_ARGS);
                    101:
                    102: static v_post   posts_an[] = { post_an, NULL };
                    103: static v_post   posts_at[] = { post_at, NULL };
1.48      schwarze  104: static v_post   posts_bd[] = { hwarn_eq0, bwarn_ge1, NULL };
1.28      schwarze  105: static v_post   posts_bf[] = { hwarn_le1, post_bf, NULL };
                    106: static v_post   posts_bl[] = { bwarn_ge1, post_bl, NULL };
                    107: static v_post   posts_bool[] = { eerr_eq1, ebool, NULL };
                    108: static v_post   posts_fo[] = { hwarn_eq1, bwarn_ge1, NULL };
                    109: static v_post   posts_it[] = { post_it, NULL };
                    110: static v_post   posts_lb[] = { eerr_eq1, post_lb, NULL };
                    111: static v_post   posts_nd[] = { berr_ge1, NULL };
                    112: static v_post   posts_nm[] = { post_nm, NULL };
                    113: static v_post   posts_notext[] = { eerr_eq0, NULL };
1.36      schwarze  114: static v_post   posts_rs[] = { berr_ge1, herr_eq0, post_rs, NULL };
1.28      schwarze  115: static v_post   posts_sh[] = { herr_ge1, bwarn_ge1, post_sh, NULL };
1.37      schwarze  116: static v_post   posts_sp[] = { eerr_le1, NULL };
1.28      schwarze  117: static v_post   posts_ss[] = { herr_ge1, NULL };
                    118: static v_post   posts_st[] = { eerr_eq1, post_st, NULL };
                    119: static v_post   posts_text[] = { eerr_ge1, NULL };
1.38      schwarze  120: static v_post   posts_text1[] = { eerr_eq1, NULL };
1.42      schwarze  121: static v_post   posts_vt[] = { post_vt, NULL };
1.28      schwarze  122: static v_post   posts_wline[] = { bwarn_ge1, herr_eq0, NULL };
                    123: static v_post   posts_wtext[] = { ewarn_ge1, NULL };
1.47      schwarze  124: static v_post   posts_xr[] = { ewarn_ge1, NULL };
1.28      schwarze  125: static v_pre    pres_an[] = { pre_an, NULL };
                    126: static v_pre    pres_bd[] = { pre_display, pre_bd, NULL };
                    127: static v_pre    pres_bl[] = { pre_bl, NULL };
                    128: static v_pre    pres_d1[] = { pre_display, NULL };
                    129: static v_pre    pres_dd[] = { pre_dd, NULL };
                    130: static v_pre    pres_dt[] = { pre_dt, NULL };
1.48      schwarze  131: static v_pre    pres_er[] = { NULL, NULL };
1.53    ! schwarze  132: static v_pre    pres_ex[] = { NULL, NULL };
        !           133: static v_pre    pres_fd[] = { NULL, NULL };
1.28      schwarze  134: static v_pre    pres_it[] = { pre_it, NULL };
1.53    ! schwarze  135: static v_pre    pres_lb[] = { NULL, NULL };
1.28      schwarze  136: static v_pre    pres_os[] = { pre_os, NULL };
                    137: static v_pre    pres_rv[] = { pre_rv, NULL };
                    138: static v_pre    pres_sh[] = { pre_sh, NULL };
                    139: static v_pre    pres_ss[] = { pre_ss, NULL };
1.1       kristaps  140:
                    141: const  struct valids mdoc_valids[MDOC_MAX] = {
1.7       schwarze  142:        { NULL, NULL },                         /* Ap */
1.1       kristaps  143:        { pres_dd, posts_text },                /* Dd */
                    144:        { pres_dt, NULL },                      /* Dt */
                    145:        { pres_os, NULL },                      /* Os */
                    146:        { pres_sh, posts_sh },                  /* Sh */
                    147:        { pres_ss, posts_ss },                  /* Ss */
1.31      schwarze  148:        { NULL, posts_notext },                 /* Pp */
1.1       kristaps  149:        { pres_d1, posts_wline },               /* D1 */
                    150:        { pres_d1, posts_wline },               /* Dl */
                    151:        { pres_bd, posts_bd },                  /* Bd */
                    152:        { NULL, NULL },                         /* Ed */
                    153:        { pres_bl, posts_bl },                  /* Bl */
                    154:        { NULL, NULL },                         /* El */
                    155:        { pres_it, posts_it },                  /* It */
                    156:        { NULL, posts_text },                   /* Ad */
                    157:        { pres_an, posts_an },                  /* An */
                    158:        { NULL, NULL },                         /* Ar */
1.50      schwarze  159:        { NULL, posts_text },                   /* Cd */
1.1       kristaps  160:        { NULL, NULL },                         /* Cm */
                    161:        { NULL, NULL },                         /* Dv */
                    162:        { pres_er, posts_text },                /* Er */
                    163:        { NULL, NULL },                         /* Ev */
1.35      schwarze  164:        { pres_ex, NULL },                      /* Ex */
1.1       kristaps  165:        { NULL, NULL },                         /* Fa */
                    166:        { pres_fd, posts_wtext },               /* Fd */
                    167:        { NULL, NULL },                         /* Fl */
                    168:        { NULL, posts_text },                   /* Fn */
                    169:        { NULL, posts_wtext },                  /* Ft */
                    170:        { NULL, posts_text },                   /* Ic */
1.38      schwarze  171:        { NULL, posts_text1 },                  /* In */
1.1       kristaps  172:        { NULL, NULL },                         /* Li */
1.25      schwarze  173:        { NULL, posts_nd },                     /* Nd */
1.1       kristaps  174:        { NULL, posts_nm },                     /* Nm */
                    175:        { NULL, posts_wline },                  /* Op */
                    176:        { NULL, NULL },                         /* Ot */
                    177:        { NULL, NULL },                         /* Pa */
1.35      schwarze  178:        { pres_rv, NULL },                      /* Rv */
1.1       kristaps  179:        { NULL, posts_st },                     /* St */
                    180:        { NULL, NULL },                         /* Va */
1.42      schwarze  181:        { NULL, posts_vt },                     /* Vt */
1.1       kristaps  182:        { NULL, posts_xr },                     /* Xr */
                    183:        { NULL, posts_text },                   /* %A */
1.37      schwarze  184:        { NULL, posts_text },                   /* %B */ /* FIXME: can be used outside Rs/Re. */
1.40      schwarze  185:        { NULL, posts_text },                   /* %D */ /* FIXME: check date with mandoc_a2time(). */
1.1       kristaps  186:        { NULL, posts_text },                   /* %I */
                    187:        { NULL, posts_text },                   /* %J */
                    188:        { NULL, posts_text },                   /* %N */
                    189:        { NULL, posts_text },                   /* %O */
                    190:        { NULL, posts_text },                   /* %P */
                    191:        { NULL, posts_text },                   /* %R */
1.37      schwarze  192:        { NULL, posts_text },                   /* %T */ /* FIXME: can be used outside Rs/Re. */
1.1       kristaps  193:        { NULL, posts_text },                   /* %V */
                    194:        { NULL, NULL },                         /* Ac */
                    195:        { NULL, NULL },                         /* Ao */
                    196:        { NULL, posts_wline },                  /* Aq */
                    197:        { NULL, posts_at },                     /* At */
                    198:        { NULL, NULL },                         /* Bc */
                    199:        { NULL, posts_bf },                     /* Bf */
                    200:        { NULL, NULL },                         /* Bo */
                    201:        { NULL, posts_wline },                  /* Bq */
                    202:        { NULL, NULL },                         /* Bsx */
                    203:        { NULL, NULL },                         /* Bx */
                    204:        { NULL, posts_bool },                   /* Db */
                    205:        { NULL, NULL },                         /* Dc */
                    206:        { NULL, NULL },                         /* Do */
                    207:        { NULL, posts_wline },                  /* Dq */
                    208:        { NULL, NULL },                         /* Ec */
                    209:        { NULL, NULL },                         /* Ef */
                    210:        { NULL, NULL },                         /* Em */
                    211:        { NULL, NULL },                         /* Eo */
                    212:        { NULL, NULL },                         /* Fx */
                    213:        { NULL, posts_text },                   /* Ms */
                    214:        { NULL, posts_notext },                 /* No */
                    215:        { NULL, posts_notext },                 /* Ns */
                    216:        { NULL, NULL },                         /* Nx */
                    217:        { NULL, NULL },                         /* Ox */
                    218:        { NULL, NULL },                         /* Pc */
1.38      schwarze  219:        { NULL, posts_text1 },                  /* Pf */
1.1       kristaps  220:        { NULL, NULL },                         /* Po */
                    221:        { NULL, posts_wline },                  /* Pq */
                    222:        { NULL, NULL },                         /* Qc */
                    223:        { NULL, posts_wline },                  /* Ql */
                    224:        { NULL, NULL },                         /* Qo */
                    225:        { NULL, posts_wline },                  /* Qq */
                    226:        { NULL, NULL },                         /* Re */
1.36      schwarze  227:        { NULL, posts_rs },                     /* Rs */
1.1       kristaps  228:        { NULL, NULL },                         /* Sc */
                    229:        { NULL, NULL },                         /* So */
                    230:        { NULL, posts_wline },                  /* Sq */
                    231:        { NULL, posts_bool },                   /* Sm */
                    232:        { NULL, posts_text },                   /* Sx */
                    233:        { NULL, posts_text },                   /* Sy */
                    234:        { NULL, posts_text },                   /* Tn */
                    235:        { NULL, NULL },                         /* Ux */
                    236:        { NULL, NULL },                         /* Xc */
                    237:        { NULL, NULL },                         /* Xo */
                    238:        { NULL, posts_fo },                     /* Fo */
                    239:        { NULL, NULL },                         /* Fc */
                    240:        { NULL, NULL },                         /* Oo */
                    241:        { NULL, NULL },                         /* Oc */
                    242:        { NULL, posts_wline },                  /* Bk */
                    243:        { NULL, NULL },                         /* Ek */
                    244:        { NULL, posts_notext },                 /* Bt */
                    245:        { NULL, NULL },                         /* Hf */
                    246:        { NULL, NULL },                         /* Fr */
                    247:        { NULL, posts_notext },                 /* Ud */
                    248:        { pres_lb, posts_lb },                  /* Lb */
1.31      schwarze  249:        { NULL, posts_notext },                 /* Lp */
1.38      schwarze  250:        { NULL, posts_text },                   /* Lk */
1.1       kristaps  251:        { NULL, posts_text },                   /* Mt */
                    252:        { NULL, posts_wline },                  /* Brq */
                    253:        { NULL, NULL },                         /* Bro */
                    254:        { NULL, NULL },                         /* Brc */
                    255:        { NULL, posts_text },                   /* %C */
                    256:        { NULL, NULL },                         /* Es */
                    257:        { NULL, NULL },                         /* En */
                    258:        { NULL, NULL },                         /* Dx */
                    259:        { NULL, posts_text },                   /* %Q */
1.31      schwarze  260:        { NULL, posts_notext },                 /* br */
                    261:        { NULL, posts_sp },                     /* sp */
1.38      schwarze  262:        { NULL, posts_text1 },                  /* %U */
1.1       kristaps  263: };
                    264:
                    265:
                    266: int
1.28      schwarze  267: mdoc_valid_pre(struct mdoc *mdoc, const struct mdoc_node *n)
1.1       kristaps  268: {
                    269:        v_pre           *p;
                    270:        int              line, pos;
                    271:        const char      *tp;
                    272:
                    273:        if (MDOC_TEXT == n->type) {
                    274:                tp = n->string;
                    275:                line = n->line;
                    276:                pos = n->pos;
                    277:                return(check_text(mdoc, line, pos, tp));
                    278:        }
                    279:
                    280:        if ( ! check_args(mdoc, n))
                    281:                return(0);
                    282:        if (NULL == mdoc_valids[n->tok].pre)
                    283:                return(1);
                    284:        for (p = mdoc_valids[n->tok].pre; *p; p++)
                    285:                if ( ! (*p)(mdoc, n))
                    286:                        return(0);
                    287:        return(1);
                    288: }
                    289:
                    290:
                    291: int
                    292: mdoc_valid_post(struct mdoc *mdoc)
                    293: {
                    294:        v_post          *p;
                    295:
                    296:        if (MDOC_VALID & mdoc->last->flags)
                    297:                return(1);
                    298:        mdoc->last->flags |= MDOC_VALID;
                    299:
                    300:        if (MDOC_TEXT == mdoc->last->type)
                    301:                return(1);
                    302:        if (MDOC_ROOT == mdoc->last->type)
                    303:                return(post_root(mdoc));
                    304:
                    305:        if (NULL == mdoc_valids[mdoc->last->tok].post)
                    306:                return(1);
                    307:        for (p = mdoc_valids[mdoc->last->tok].post; *p; p++)
                    308:                if ( ! (*p)(mdoc))
                    309:                        return(0);
                    310:
                    311:        return(1);
                    312: }
                    313:
                    314:
                    315: static inline int
                    316: warn_count(struct mdoc *m, const char *k,
                    317:                int want, const char *v, int has)
                    318: {
                    319:
1.16      schwarze  320:        return(mdoc_vwarn(m, m->last->line, m->last->pos,
1.1       kristaps  321:                "suggests %s %s %d (has %d)", v, k, want, has));
                    322: }
                    323:
                    324:
                    325: static inline int
                    326: err_count(struct mdoc *m, const char *k,
                    327:                int want, const char *v, int has)
                    328: {
                    329:
1.17      schwarze  330:        return(mdoc_verr(m, m->last->line, m->last->pos,
1.1       kristaps  331:                "requires %s %s %d (has %d)", v, k, want, has));
                    332: }
                    333:
                    334:
                    335: /*
                    336:  * Build these up with macros because they're basically the same check
                    337:  * for different inequalities.  Yes, this could be done with functions,
                    338:  * but this is reasonable for now.
                    339:  */
                    340:
                    341: #define CHECK_CHILD_DEFN(lvl, name, ineq)                      \
                    342: static int                                                     \
                    343: lvl##_child_##name(struct mdoc *mdoc, const char *p, int sz)   \
                    344: {                                                              \
1.12      schwarze  345:        if (mdoc->last->nchild ineq sz)                         \
1.1       kristaps  346:                return(1);                                      \
1.12      schwarze  347:        return(lvl##_count(mdoc, #ineq, sz, p, mdoc->last->nchild)); \
1.1       kristaps  348: }
                    349:
                    350: #define CHECK_BODY_DEFN(name, lvl, func, num)                  \
                    351: static int                                                     \
                    352: b##lvl##_##name(POST_ARGS)                                     \
                    353: {                                                              \
                    354:        if (MDOC_BODY != mdoc->last->type)                      \
                    355:                return(1);                                      \
                    356:        return(func(mdoc, "multi-line arguments", (num)));      \
                    357: }
                    358:
                    359: #define CHECK_ELEM_DEFN(name, lvl, func, num)                  \
                    360: static int                                                     \
                    361: e##lvl##_##name(POST_ARGS)                                     \
                    362: {                                                              \
                    363:        assert(MDOC_ELEM == mdoc->last->type);                  \
                    364:        return(func(mdoc, "line arguments", (num)));            \
                    365: }
                    366:
                    367: #define CHECK_HEAD_DEFN(name, lvl, func, num)                  \
                    368: static int                                                     \
                    369: h##lvl##_##name(POST_ARGS)                                     \
                    370: {                                                              \
                    371:        if (MDOC_HEAD != mdoc->last->type)                      \
                    372:                return(1);                                      \
                    373:        return(func(mdoc, "line arguments", (num)));            \
                    374: }
                    375:
                    376:
                    377: CHECK_CHILD_DEFN(warn, gt, >)                  /* warn_child_gt() */
                    378: CHECK_CHILD_DEFN(err, gt, >)                   /* err_child_gt() */
                    379: CHECK_CHILD_DEFN(warn, eq, ==)                 /* warn_child_eq() */
                    380: CHECK_CHILD_DEFN(err, eq, ==)                  /* err_child_eq() */
                    381: CHECK_CHILD_DEFN(err, lt, <)                   /* err_child_lt() */
                    382: CHECK_CHILD_DEFN(warn, lt, <)                  /* warn_child_lt() */
                    383: CHECK_BODY_DEFN(ge1, warn, warn_child_gt, 0)   /* bwarn_ge1() */
1.25      schwarze  384: CHECK_BODY_DEFN(ge1, err, err_child_gt, 0)     /* berr_ge1() */
1.1       kristaps  385: CHECK_ELEM_DEFN(ge1, warn, warn_child_gt, 0)   /* ewarn_gt1() */
                    386: CHECK_ELEM_DEFN(eq1, err, err_child_eq, 1)     /* eerr_eq1() */
1.37      schwarze  387: CHECK_ELEM_DEFN(le1, err, err_child_lt, 2)     /* eerr_le1() */
1.1       kristaps  388: CHECK_ELEM_DEFN(eq0, err, err_child_eq, 0)     /* eerr_eq0() */
                    389: CHECK_ELEM_DEFN(ge1, err, err_child_gt, 0)     /* eerr_ge1() */
                    390: CHECK_HEAD_DEFN(eq0, err, err_child_eq, 0)     /* herr_eq0() */
                    391: CHECK_HEAD_DEFN(le1, warn, warn_child_lt, 2)   /* hwarn_le1() */
                    392: CHECK_HEAD_DEFN(ge1, err, err_child_gt, 0)     /* herr_ge1() */
                    393: CHECK_HEAD_DEFN(eq1, warn, warn_child_eq, 1)   /* hwarn_eq1() */
1.48      schwarze  394: CHECK_HEAD_DEFN(eq0, warn, warn_child_eq, 0)   /* hwarn_eq0() */
1.1       kristaps  395:
                    396:
                    397: static int
                    398: check_stdarg(PRE_ARGS)
                    399: {
                    400:
                    401:        if (n->args && 1 == n->args->argc)
                    402:                if (MDOC_Std == n->args->argv[0].arg)
                    403:                        return(1);
1.21      schwarze  404:        return(mdoc_nwarn(mdoc, n, EARGVAL));
1.1       kristaps  405: }
                    406:
                    407:
                    408: static int
                    409: check_args(struct mdoc *m, const struct mdoc_node *n)
                    410: {
                    411:        int              i;
                    412:
                    413:        if (NULL == n->args)
                    414:                return(1);
                    415:
                    416:        assert(n->args->argc);
                    417:        for (i = 0; i < (int)n->args->argc; i++)
                    418:                if ( ! check_argv(m, n, &n->args->argv[i]))
                    419:                        return(0);
                    420:
                    421:        return(1);
                    422: }
                    423:
                    424:
                    425: static int
                    426: check_argv(struct mdoc *m, const struct mdoc_node *n,
                    427:                const struct mdoc_argv *v)
                    428: {
                    429:        int              i;
                    430:
                    431:        for (i = 0; i < (int)v->sz; i++)
                    432:                if ( ! check_text(m, v->line, v->pos, v->value[i]))
                    433:                        return(0);
                    434:
                    435:        if (MDOC_Std == v->arg) {
                    436:                /* `Nm' name must be set. */
                    437:                if (v->sz || m->meta.name)
                    438:                        return(1);
1.19      schwarze  439:                return(mdoc_nerr(m, n, ENAME));
1.1       kristaps  440:        }
                    441:
                    442:        return(1);
                    443: }
                    444:
                    445:
                    446: static int
                    447: check_text(struct mdoc *mdoc, int line, int pos, const char *p)
                    448: {
1.15      schwarze  449:        int              c;
1.1       kristaps  450:
1.15      schwarze  451:        for ( ; *p; p++, pos++) {
1.1       kristaps  452:                if ('\t' == *p) {
                    453:                        if ( ! (MDOC_LITERAL & mdoc->flags))
1.49      schwarze  454:                                if ( ! mdoc_pwarn(mdoc, line, pos, EPRINT))
1.1       kristaps  455:                                        return(0);
                    456:                } else if ( ! isprint((u_char)*p))
1.49      schwarze  457:                        if ( ! mdoc_pwarn(mdoc, line, pos, EPRINT))
1.1       kristaps  458:                                return(0);
                    459:
                    460:                if ('\\' != *p)
                    461:                        continue;
                    462:
1.15      schwarze  463:                c = mandoc_special(p);
1.1       kristaps  464:                if (c) {
1.15      schwarze  465:                        p += c - 1;
                    466:                        pos += c - 1;
1.1       kristaps  467:                        continue;
                    468:                }
                    469:                if ( ! (MDOC_IGN_ESCAPE & mdoc->pflags))
1.20      schwarze  470:                        return(mdoc_perr(mdoc, line, pos, EESCAPE));
1.24      schwarze  471:                if ( ! mdoc_pwarn(mdoc, line, pos, EESCAPE))
1.1       kristaps  472:                        return(0);
                    473:        }
                    474:
                    475:        return(1);
                    476: }
                    477:
                    478:
                    479:
                    480:
                    481: static int
1.44      schwarze  482: check_parent(PRE_ARGS, enum mdoct tok, enum mdoc_type t)
1.1       kristaps  483: {
                    484:
                    485:        assert(n->parent);
                    486:        if ((MDOC_ROOT == t || tok == n->parent->tok) &&
                    487:                        (t == n->parent->type))
                    488:                return(1);
                    489:
1.17      schwarze  490:        return(mdoc_verr(mdoc, n->line, n->pos, "require parent %s",
1.1       kristaps  491:                MDOC_ROOT == t ? "<root>" : mdoc_macronames[tok]));
                    492: }
                    493:
                    494:
                    495:
                    496: static int
                    497: pre_display(PRE_ARGS)
                    498: {
                    499:        struct mdoc_node *node;
                    500:
                    501:        /* Display elements (`Bd', `D1'...) cannot be nested. */
                    502:
                    503:        if (MDOC_BLOCK != n->type)
                    504:                return(1);
                    505:
                    506:        /* LINTED */
                    507:        for (node = mdoc->last->parent; node; node = node->parent)
                    508:                if (MDOC_BLOCK == node->type)
                    509:                        if (MDOC_Bd == node->tok)
                    510:                                break;
                    511:        if (NULL == node)
                    512:                return(1);
                    513:
1.19      schwarze  514:        return(mdoc_nerr(mdoc, n, ENESTDISP));
1.1       kristaps  515: }
                    516:
                    517:
                    518: static int
                    519: pre_bl(PRE_ARGS)
                    520: {
1.11      schwarze  521:        int              pos, type, width, offset;
1.1       kristaps  522:
                    523:        if (MDOC_BLOCK != n->type)
                    524:                return(1);
                    525:        if (NULL == n->args)
1.19      schwarze  526:                return(mdoc_nerr(mdoc, n, ELISTTYPE));
1.1       kristaps  527:
                    528:        /* Make sure that only one type of list is specified.  */
                    529:
1.11      schwarze  530:        type = offset = width = -1;
1.1       kristaps  531:
                    532:        /* LINTED */
1.5       schwarze  533:        for (pos = 0; pos < (int)n->args->argc; pos++)
                    534:                switch (n->args->argv[pos].arg) {
1.1       kristaps  535:                case (MDOC_Bullet):
                    536:                        /* FALLTHROUGH */
                    537:                case (MDOC_Dash):
                    538:                        /* FALLTHROUGH */
                    539:                case (MDOC_Enum):
                    540:                        /* FALLTHROUGH */
                    541:                case (MDOC_Hyphen):
                    542:                        /* FALLTHROUGH */
                    543:                case (MDOC_Item):
                    544:                        /* FALLTHROUGH */
                    545:                case (MDOC_Tag):
                    546:                        /* FALLTHROUGH */
                    547:                case (MDOC_Diag):
                    548:                        /* FALLTHROUGH */
                    549:                case (MDOC_Hang):
                    550:                        /* FALLTHROUGH */
                    551:                case (MDOC_Ohang):
                    552:                        /* FALLTHROUGH */
                    553:                case (MDOC_Inset):
                    554:                        /* FALLTHROUGH */
                    555:                case (MDOC_Column):
1.48      schwarze  556:                        /*
                    557:                         * Note that if a duplicate is detected, we
                    558:                         * remove the duplicate instead of passing it
                    559:                         * over.  If we don't do this, mdoc_action will
                    560:                         * become confused when it scans over multiple
                    561:                         * types whilst setting its bitmasks.
                    562:                         *
                    563:                         * FIXME: this should occur in mdoc_action.c.
                    564:                         */
1.46      schwarze  565:                        if (type >= 0) {
                    566:                                if ( ! mdoc_nwarn(mdoc, n, EMULTILIST))
                    567:                                        return(0);
                    568:                                mdoc_argn_free(n->args, pos);
                    569:                                break;
                    570:                        }
1.5       schwarze  571:                        type = n->args->argv[pos].arg;
                    572:                        break;
1.37      schwarze  573:                case (MDOC_Compact):
                    574:                        if (type < 0 && ! mdoc_nwarn(mdoc, n, ENOTYPE))
                    575:                                return(0);
                    576:                        break;
1.1       kristaps  577:                case (MDOC_Width):
1.37      schwarze  578:                        if (width >= 0)
1.19      schwarze  579:                                return(mdoc_nerr(mdoc, n, EARGREP));
1.37      schwarze  580:                        if (type < 0 && ! mdoc_nwarn(mdoc, n, ENOTYPE))
                    581:                                return(0);
1.5       schwarze  582:                        width = n->args->argv[pos].arg;
                    583:                        break;
1.1       kristaps  584:                case (MDOC_Offset):
1.37      schwarze  585:                        if (offset >= 0)
1.19      schwarze  586:                                return(mdoc_nerr(mdoc, n, EARGREP));
1.37      schwarze  587:                        if (type < 0 && ! mdoc_nwarn(mdoc, n, ENOTYPE))
                    588:                                return(0);
1.5       schwarze  589:                        offset = n->args->argv[pos].arg;
                    590:                        break;
1.1       kristaps  591:                default:
                    592:                        break;
                    593:                }
                    594:
1.37      schwarze  595:        if (type < 0)
1.19      schwarze  596:                return(mdoc_nerr(mdoc, n, ELISTTYPE));
1.1       kristaps  597:
1.5       schwarze  598:        /*
                    599:         * Validate the width field.  Some list types don't need width
                    600:         * types and should be warned about them.  Others should have it
                    601:         * and must also be warned.
                    602:         */
                    603:
1.1       kristaps  604:        switch (type) {
1.5       schwarze  605:        case (MDOC_Tag):
1.37      schwarze  606:                if (width < 0 && ! mdoc_nwarn(mdoc, n, EMISSWIDTH))
1.5       schwarze  607:                        return(0);
                    608:                break;
1.1       kristaps  609:        case (MDOC_Column):
                    610:                /* FALLTHROUGH */
                    611:        case (MDOC_Diag):
                    612:                /* FALLTHROUGH */
1.40      schwarze  613:        case (MDOC_Ohang):
                    614:                /* FALLTHROUGH */
1.1       kristaps  615:        case (MDOC_Inset):
                    616:                /* FALLTHROUGH */
                    617:        case (MDOC_Item):
1.37      schwarze  618:                if (width >= 0 && ! mdoc_nwarn(mdoc, n, ENOWIDTH))
1.5       schwarze  619:                        return(0);
                    620:                break;
                    621:        default:
                    622:                break;
                    623:        }
                    624:
1.1       kristaps  625:        return(1);
                    626: }
                    627:
                    628:
                    629: static int
                    630: pre_bd(PRE_ARGS)
                    631: {
                    632:        int              i, type, err;
                    633:
                    634:        if (MDOC_BLOCK != n->type)
                    635:                return(1);
                    636:        if (NULL == n->args)
1.19      schwarze  637:                return(mdoc_nerr(mdoc, n, EDISPTYPE));
1.1       kristaps  638:
                    639:        /* Make sure that only one type of display is specified.  */
                    640:
                    641:        /* LINTED */
                    642:        for (i = 0, err = type = 0; ! err &&
                    643:                        i < (int)n->args->argc; i++)
                    644:                switch (n->args->argv[i].arg) {
1.38      schwarze  645:                case (MDOC_Centred):
                    646:                        /* FALLTHROUGH */
1.1       kristaps  647:                case (MDOC_Ragged):
                    648:                        /* FALLTHROUGH */
                    649:                case (MDOC_Unfilled):
                    650:                        /* FALLTHROUGH */
                    651:                case (MDOC_Filled):
                    652:                        /* FALLTHROUGH */
                    653:                case (MDOC_Literal):
                    654:                        if (0 == type++)
                    655:                                break;
1.19      schwarze  656:                        return(mdoc_nerr(mdoc, n, EMULTIDISP));
1.1       kristaps  657:                default:
                    658:                        break;
                    659:                }
                    660:
                    661:        if (type)
                    662:                return(1);
1.19      schwarze  663:        return(mdoc_nerr(mdoc, n, EDISPTYPE));
1.1       kristaps  664: }
                    665:
                    666:
                    667: static int
                    668: pre_ss(PRE_ARGS)
                    669: {
                    670:
                    671:        if (MDOC_BLOCK != n->type)
                    672:                return(1);
                    673:        return(check_parent(mdoc, n, MDOC_Sh, MDOC_BODY));
                    674: }
                    675:
                    676:
                    677: static int
                    678: pre_sh(PRE_ARGS)
                    679: {
                    680:
                    681:        if (MDOC_BLOCK != n->type)
                    682:                return(1);
1.50      schwarze  683:        return(check_parent(mdoc, n, MDOC_MAX, MDOC_ROOT));
1.1       kristaps  684: }
                    685:
                    686:
                    687: static int
                    688: pre_it(PRE_ARGS)
                    689: {
                    690:
                    691:        if (MDOC_BLOCK != n->type)
                    692:                return(1);
                    693:        return(check_parent(mdoc, n, MDOC_Bl, MDOC_BODY));
                    694: }
                    695:
                    696:
                    697: static int
                    698: pre_an(PRE_ARGS)
                    699: {
                    700:
                    701:        if (NULL == n->args || 1 == n->args->argc)
                    702:                return(1);
1.17      schwarze  703:        return(mdoc_verr(mdoc, n->line, n->pos,
                    704:                                "only one argument allowed"));
1.1       kristaps  705: }
                    706:
                    707:
                    708: static int
                    709: pre_rv(PRE_ARGS)
                    710: {
                    711:
                    712:        return(check_stdarg(mdoc, n));
                    713: }
                    714:
                    715:
                    716: static int
                    717: pre_dt(PRE_ARGS)
                    718: {
1.40      schwarze  719:
                    720:        /* FIXME: make sure is capitalised. */
1.1       kristaps  721:
                    722:        if (0 == mdoc->meta.date || mdoc->meta.os)
1.21      schwarze  723:                if ( ! mdoc_nwarn(mdoc, n, EPROLOOO))
1.1       kristaps  724:                        return(0);
                    725:        if (mdoc->meta.title)
1.21      schwarze  726:                if ( ! mdoc_nwarn(mdoc, n, EPROLREP))
1.1       kristaps  727:                        return(0);
                    728:        return(1);
                    729: }
                    730:
                    731:
                    732: static int
                    733: pre_os(PRE_ARGS)
                    734: {
                    735:
                    736:        if (NULL == mdoc->meta.title || 0 == mdoc->meta.date)
1.21      schwarze  737:                if ( ! mdoc_nwarn(mdoc, n, EPROLOOO))
1.1       kristaps  738:                        return(0);
                    739:        if (mdoc->meta.os)
1.21      schwarze  740:                if ( ! mdoc_nwarn(mdoc, n, EPROLREP))
1.1       kristaps  741:                        return(0);
                    742:        return(1);
                    743: }
                    744:
                    745:
                    746: static int
                    747: pre_dd(PRE_ARGS)
                    748: {
                    749:
                    750:        if (mdoc->meta.title || mdoc->meta.os)
1.21      schwarze  751:                if ( ! mdoc_nwarn(mdoc, n, EPROLOOO))
1.1       kristaps  752:                        return(0);
                    753:        if (mdoc->meta.date)
1.21      schwarze  754:                if ( ! mdoc_nwarn(mdoc, n, EPROLREP))
1.1       kristaps  755:                        return(0);
                    756:        return(1);
                    757: }
                    758:
                    759:
                    760: static int
                    761: post_bf(POST_ARGS)
                    762: {
                    763:        char             *p;
                    764:        struct mdoc_node *head;
                    765:
                    766:        if (MDOC_BLOCK != mdoc->last->type)
                    767:                return(1);
                    768:
                    769:        head = mdoc->last->head;
                    770:
1.10      schwarze  771:        if (mdoc->last->args && head->child)
1.19      schwarze  772:                return(mdoc_nerr(mdoc, mdoc->last, ELINE));
1.10      schwarze  773:        else if (mdoc->last->args)
                    774:                return(1);
                    775:
                    776:        if (NULL == head->child || MDOC_TEXT != head->child->type)
1.19      schwarze  777:                return(mdoc_nerr(mdoc, mdoc->last, ELINE));
1.1       kristaps  778:
1.10      schwarze  779:        p = head->child->string;
1.1       kristaps  780:
1.10      schwarze  781:        if (0 == strcmp(p, "Em"))
                    782:                return(1);
                    783:        else if (0 == strcmp(p, "Li"))
                    784:                return(1);
1.30      schwarze  785:        else if (0 == strcmp(p, "Sy"))
1.10      schwarze  786:                return(1);
1.1       kristaps  787:
1.19      schwarze  788:        return(mdoc_nerr(mdoc, head, EFONT));
1.27      schwarze  789: }
                    790:
                    791:
                    792: static int
                    793: post_lb(POST_ARGS)
                    794: {
                    795:
                    796:        if (mdoc_a2lib(mdoc->last->child->string))
                    797:                return(1);
                    798:        return(mdoc_nwarn(mdoc, mdoc->last, ELIB));
1.42      schwarze  799: }
                    800:
                    801:
                    802: static int
                    803: post_vt(POST_ARGS)
                    804: {
                    805:        const struct mdoc_node *n;
                    806:
                    807:        /*
                    808:         * The Vt macro comes in both ELEM and BLOCK form, both of which
                    809:         * have different syntaxes (yet more context-sensitive
                    810:         * behaviour).  ELEM types must have a child; BLOCK types,
                    811:         * specifically the BODY, should only have TEXT children.
                    812:         */
                    813:
                    814:        if (MDOC_ELEM == mdoc->last->type)
                    815:                return(eerr_ge1(mdoc));
                    816:        if (MDOC_BODY != mdoc->last->type)
                    817:                return(1);
                    818:
                    819:        for (n = mdoc->last->child; n; n = n->next)
1.52      schwarze  820:                if (MDOC_TEXT != n->type)
1.42      schwarze  821:                        if ( ! mdoc_nwarn(mdoc, n, EBADCHILD))
                    822:                                return(0);
                    823:
                    824:        return(1);
1.1       kristaps  825: }
                    826:
                    827:
                    828: static int
                    829: post_nm(POST_ARGS)
                    830: {
                    831:
                    832:        if (mdoc->last->child)
                    833:                return(1);
                    834:        if (mdoc->meta.name)
                    835:                return(1);
1.19      schwarze  836:        return(mdoc_nerr(mdoc, mdoc->last, ENAME));
1.1       kristaps  837: }
                    838:
                    839:
                    840: static int
                    841: post_at(POST_ARGS)
                    842: {
                    843:
                    844:        if (NULL == mdoc->last->child)
                    845:                return(1);
                    846:        if (MDOC_TEXT != mdoc->last->child->type)
1.19      schwarze  847:                return(mdoc_nerr(mdoc, mdoc->last, EATT));
1.1       kristaps  848:        if (mdoc_a2att(mdoc->last->child->string))
                    849:                return(1);
1.53    ! schwarze  850:        return(mdoc_nwarn(mdoc, mdoc->last, EATT));
1.1       kristaps  851: }
                    852:
                    853:
                    854: static int
                    855: post_an(POST_ARGS)
                    856: {
                    857:
                    858:        if (mdoc->last->args) {
                    859:                if (NULL == mdoc->last->child)
                    860:                        return(1);
1.34      schwarze  861:                return(mdoc_nerr(mdoc, mdoc->last, ENOLINE));
1.1       kristaps  862:        }
                    863:
                    864:        if (mdoc->last->child)
                    865:                return(1);
1.19      schwarze  866:        return(mdoc_nerr(mdoc, mdoc->last, ELINE));
1.1       kristaps  867: }
                    868:
                    869:
                    870: static int
                    871: post_it(POST_ARGS)
                    872: {
                    873:        int               type, i, cols;
                    874:        struct mdoc_node *n, *c;
                    875:
                    876:        if (MDOC_BLOCK != mdoc->last->type)
                    877:                return(1);
                    878:
                    879:        n = mdoc->last->parent->parent;
                    880:        if (NULL == n->args)
1.19      schwarze  881:                return(mdoc_nerr(mdoc, mdoc->last, ELISTTYPE));
1.1       kristaps  882:
                    883:        /* Some types require block-head, some not. */
                    884:
                    885:        /* LINTED */
                    886:        for (cols = type = -1, i = 0; -1 == type &&
                    887:                        i < (int)n->args->argc; i++)
                    888:                switch (n->args->argv[i].arg) {
                    889:                case (MDOC_Tag):
                    890:                        /* FALLTHROUGH */
                    891:                case (MDOC_Diag):
                    892:                        /* FALLTHROUGH */
                    893:                case (MDOC_Hang):
                    894:                        /* FALLTHROUGH */
                    895:                case (MDOC_Ohang):
                    896:                        /* FALLTHROUGH */
                    897:                case (MDOC_Inset):
                    898:                        /* FALLTHROUGH */
                    899:                case (MDOC_Bullet):
                    900:                        /* FALLTHROUGH */
                    901:                case (MDOC_Dash):
                    902:                        /* FALLTHROUGH */
                    903:                case (MDOC_Enum):
                    904:                        /* FALLTHROUGH */
                    905:                case (MDOC_Hyphen):
                    906:                        /* FALLTHROUGH */
                    907:                case (MDOC_Item):
                    908:                        type = n->args->argv[i].arg;
                    909:                        break;
                    910:                case (MDOC_Column):
                    911:                        type = n->args->argv[i].arg;
                    912:                        cols = (int)n->args->argv[i].sz;
                    913:                        break;
                    914:                default:
                    915:                        break;
                    916:                }
                    917:
                    918:        if (-1 == type)
1.19      schwarze  919:                return(mdoc_nerr(mdoc, mdoc->last, ELISTTYPE));
1.1       kristaps  920:
                    921:        switch (type) {
                    922:        case (MDOC_Tag):
                    923:                if (NULL == mdoc->last->head->child)
1.21      schwarze  924:                        if ( ! mdoc_nwarn(mdoc, mdoc->last, ELINE))
1.1       kristaps  925:                                return(0);
                    926:                break;
                    927:        case (MDOC_Hang):
                    928:                /* FALLTHROUGH */
                    929:        case (MDOC_Ohang):
                    930:                /* FALLTHROUGH */
                    931:        case (MDOC_Inset):
                    932:                /* FALLTHROUGH */
                    933:        case (MDOC_Diag):
                    934:                if (NULL == mdoc->last->head->child)
1.21      schwarze  935:                        if ( ! mdoc_nwarn(mdoc, mdoc->last, ELINE))
1.1       kristaps  936:                                return(0);
                    937:                if (NULL == mdoc->last->body->child)
1.21      schwarze  938:                        if ( ! mdoc_nwarn(mdoc, mdoc->last, EMULTILINE))
1.1       kristaps  939:                                return(0);
                    940:                break;
                    941:        case (MDOC_Bullet):
                    942:                /* FALLTHROUGH */
                    943:        case (MDOC_Dash):
                    944:                /* FALLTHROUGH */
                    945:        case (MDOC_Enum):
                    946:                /* FALLTHROUGH */
                    947:        case (MDOC_Hyphen):
                    948:                /* FALLTHROUGH */
                    949:        case (MDOC_Item):
                    950:                if (mdoc->last->head->child)
1.21      schwarze  951:                        if ( ! mdoc_nwarn(mdoc, mdoc->last, ENOLINE))
1.1       kristaps  952:                                return(0);
                    953:                if (NULL == mdoc->last->body->child)
1.21      schwarze  954:                        if ( ! mdoc_nwarn(mdoc, mdoc->last, EMULTILINE))
1.1       kristaps  955:                                return(0);
                    956:                break;
                    957:        case (MDOC_Column):
                    958:                if (NULL == mdoc->last->head->child)
1.21      schwarze  959:                        if ( ! mdoc_nwarn(mdoc, mdoc->last, ELINE))
1.1       kristaps  960:                                return(0);
                    961:                if (mdoc->last->body->child)
1.21      schwarze  962:                        if ( ! mdoc_nwarn(mdoc, mdoc->last, ENOMULTILINE))
1.1       kristaps  963:                                return(0);
                    964:                c = mdoc->last->child;
                    965:                for (i = 0; c && MDOC_HEAD == c->type; c = c->next)
                    966:                        i++;
1.32      schwarze  967:
1.53    ! schwarze  968:                if (i < cols) {
1.32      schwarze  969:                        if ( ! mdoc_vwarn(mdoc, mdoc->last->line,
                    970:                                        mdoc->last->pos, "column "
                    971:                                        "mismatch: have %d, want %d",
                    972:                                        i, cols))
                    973:                                return(0);
1.1       kristaps  974:                        break;
1.53    ! schwarze  975:                } else if (i == cols || i == cols + 1)
1.32      schwarze  976:                        break;
                    977:
                    978:                return(mdoc_verr(mdoc, mdoc->last->line,
                    979:                                mdoc->last->pos, "column mismatch: "
                    980:                                "have %d, want %d", i, cols));
1.1       kristaps  981:        default:
                    982:                break;
                    983:        }
                    984:
                    985:        return(1);
                    986: }
                    987:
                    988:
                    989: static int
1.11      schwarze  990: post_bl_head(POST_ARGS)
                    991: {
                    992:        int                     i;
                    993:        const struct mdoc_node *n;
1.48      schwarze  994:        const struct mdoc_argv *a;
1.11      schwarze  995:
                    996:        n = mdoc->last->parent;
                    997:        assert(n->args);
                    998:
1.48      schwarze  999:        for (i = 0; i < (int)n->args->argc; i++) {
                   1000:                a = &n->args->argv[i];
                   1001:                if (a->arg == MDOC_Column) {
                   1002:                        if (a->sz && mdoc->last->nchild)
                   1003:                                return(mdoc_nerr(mdoc, n, ECOLMIS));
                   1004:                        return(1);
                   1005:                }
                   1006:        }
1.11      schwarze 1007:
1.48      schwarze 1008:        if (0 == (i = mdoc->last->nchild))
1.11      schwarze 1009:                return(1);
1.48      schwarze 1010:        return(warn_count(mdoc, "==", 0, "line arguments", i));
1.11      schwarze 1011: }
                   1012:
                   1013:
                   1014: static int
1.1       kristaps 1015: post_bl(POST_ARGS)
                   1016: {
                   1017:        struct mdoc_node        *n;
                   1018:
1.11      schwarze 1019:        if (MDOC_HEAD == mdoc->last->type)
                   1020:                return(post_bl_head(mdoc));
1.1       kristaps 1021:        if (MDOC_BODY != mdoc->last->type)
                   1022:                return(1);
                   1023:        if (NULL == mdoc->last->child)
                   1024:                return(1);
                   1025:
1.41      schwarze 1026:        /*
                   1027:         * We only allow certain children of `Bl'.  This is usually on
                   1028:         * `It', but apparently `Sm' occurs here and there, so we let
                   1029:         * that one through, too.
                   1030:         */
                   1031:
1.1       kristaps 1032:        /* LINTED */
                   1033:        for (n = mdoc->last->child; n; n = n->next) {
1.41      schwarze 1034:                if (MDOC_BLOCK == n->type && MDOC_It == n->tok)
                   1035:                        continue;
                   1036:                if (MDOC_Sm == n->tok)
                   1037:                        continue;
1.36      schwarze 1038:                return(mdoc_nerr(mdoc, n, EBADCHILD));
1.1       kristaps 1039:        }
                   1040:
                   1041:        return(1);
                   1042: }
                   1043:
                   1044:
                   1045: static int
                   1046: ebool(struct mdoc *mdoc)
                   1047: {
                   1048:        struct mdoc_node *n;
                   1049:
                   1050:        /* LINTED */
                   1051:        for (n = mdoc->last->child; n; n = n->next) {
                   1052:                if (MDOC_TEXT != n->type)
                   1053:                        break;
                   1054:                if (0 == strcmp(n->string, "on"))
                   1055:                        continue;
                   1056:                if (0 == strcmp(n->string, "off"))
                   1057:                        continue;
                   1058:                break;
                   1059:        }
                   1060:
                   1061:        if (NULL == n)
                   1062:                return(1);
1.19      schwarze 1063:        return(mdoc_nerr(mdoc, n, EBOOL));
1.1       kristaps 1064: }
                   1065:
                   1066:
                   1067: static int
                   1068: post_root(POST_ARGS)
                   1069: {
                   1070:
                   1071:        if (NULL == mdoc->first->child)
1.19      schwarze 1072:                return(mdoc_nerr(mdoc, mdoc->first, ENODAT));
1.9       schwarze 1073:        if ( ! (MDOC_PBODY & mdoc->flags))
1.19      schwarze 1074:                return(mdoc_nerr(mdoc, mdoc->first, ENOPROLOGUE));
1.1       kristaps 1075:
                   1076:        if (MDOC_BLOCK != mdoc->first->child->type)
1.19      schwarze 1077:                return(mdoc_nerr(mdoc, mdoc->first, ENODAT));
1.1       kristaps 1078:        if (MDOC_Sh != mdoc->first->child->tok)
1.19      schwarze 1079:                return(mdoc_nerr(mdoc, mdoc->first, ENODAT));
1.1       kristaps 1080:
                   1081:        return(1);
                   1082: }
                   1083:
                   1084:
                   1085: static int
                   1086: post_st(POST_ARGS)
                   1087: {
                   1088:
                   1089:        if (mdoc_a2st(mdoc->last->child->string))
                   1090:                return(1);
1.53    ! schwarze 1091:        return(mdoc_nwarn(mdoc, mdoc->last, EBADSTAND));
1.36      schwarze 1092: }
                   1093:
                   1094:
                   1095: static int
                   1096: post_rs(POST_ARGS)
                   1097: {
                   1098:        struct mdoc_node        *nn;
                   1099:
                   1100:        if (MDOC_BODY != mdoc->last->type)
                   1101:                return(1);
                   1102:
                   1103:        for (nn = mdoc->last->child; nn; nn = nn->next)
                   1104:                switch (nn->tok) {
1.38      schwarze 1105:                case(MDOC__U):
                   1106:                        /* FALLTHROUGH */
1.36      schwarze 1107:                case(MDOC__Q):
                   1108:                        /* FALLTHROUGH */
                   1109:                case(MDOC__C):
                   1110:                        /* FALLTHROUGH */
                   1111:                case(MDOC__A):
                   1112:                        /* FALLTHROUGH */
                   1113:                case(MDOC__B):
                   1114:                        /* FALLTHROUGH */
                   1115:                case(MDOC__D):
                   1116:                        /* FALLTHROUGH */
                   1117:                case(MDOC__I):
                   1118:                        /* FALLTHROUGH */
                   1119:                case(MDOC__J):
                   1120:                        /* FALLTHROUGH */
                   1121:                case(MDOC__N):
                   1122:                        /* FALLTHROUGH */
                   1123:                case(MDOC__O):
                   1124:                        /* FALLTHROUGH */
                   1125:                case(MDOC__P):
                   1126:                        /* FALLTHROUGH */
                   1127:                case(MDOC__R):
                   1128:                        /* FALLTHROUGH */
                   1129:                case(MDOC__T):
                   1130:                        /* FALLTHROUGH */
                   1131:                case(MDOC__V):
                   1132:                        break;
                   1133:                default:
                   1134:                        return(mdoc_nerr(mdoc, nn, EBADCHILD));
                   1135:                }
                   1136:
                   1137:        return(1);
1.1       kristaps 1138: }
                   1139:
                   1140:
                   1141: static int
                   1142: post_sh(POST_ARGS)
                   1143: {
                   1144:
                   1145:        if (MDOC_HEAD == mdoc->last->type)
                   1146:                return(post_sh_head(mdoc));
                   1147:        if (MDOC_BODY == mdoc->last->type)
                   1148:                return(post_sh_body(mdoc));
                   1149:
                   1150:        return(1);
                   1151: }
                   1152:
                   1153:
                   1154: static int
                   1155: post_sh_body(POST_ARGS)
                   1156: {
                   1157:        struct mdoc_node *n;
                   1158:
1.26      schwarze 1159:        if (SEC_NAME != mdoc->lastsec)
1.1       kristaps 1160:                return(1);
                   1161:
                   1162:        /*
                   1163:         * Warn if the NAME section doesn't contain the `Nm' and `Nd'
                   1164:         * macros (can have multiple `Nm' and one `Nd').  Note that the
                   1165:         * children of the BODY declaration can also be "text".
                   1166:         */
                   1167:
                   1168:        if (NULL == (n = mdoc->last->child))
1.21      schwarze 1169:                return(mdoc_nwarn(mdoc, mdoc->last, ENAMESECINC));
1.1       kristaps 1170:
                   1171:        for ( ; n && n->next; n = n->next) {
                   1172:                if (MDOC_ELEM == n->type && MDOC_Nm == n->tok)
                   1173:                        continue;
                   1174:                if (MDOC_TEXT == n->type)
                   1175:                        continue;
1.21      schwarze 1176:                if ( ! mdoc_nwarn(mdoc, mdoc->last, ENAMESECINC))
1.1       kristaps 1177:                        return(0);
                   1178:        }
                   1179:
1.34      schwarze 1180:        assert(n);
1.25      schwarze 1181:        if (MDOC_BLOCK == n->type && MDOC_Nd == n->tok)
1.1       kristaps 1182:                return(1);
1.21      schwarze 1183:        return(mdoc_nwarn(mdoc, mdoc->last, ENAMESECINC));
1.1       kristaps 1184: }
                   1185:
                   1186:
                   1187: static int
                   1188: post_sh_head(POST_ARGS)
                   1189: {
                   1190:        char                    buf[64];
                   1191:        enum mdoc_sec           sec;
                   1192:        const struct mdoc_node *n;
                   1193:
                   1194:        /*
                   1195:         * Process a new section.  Sections are either "named" or
                   1196:         * "custom"; custom sections are user-defined, while named ones
                   1197:         * usually follow a conventional order and may only appear in
                   1198:         * certain manual sections.
                   1199:         */
                   1200:
1.9       schwarze 1201:        buf[0] = 0;
1.1       kristaps 1202:
                   1203:        for (n = mdoc->last->child; n; n = n->next) {
1.9       schwarze 1204:                /* XXX - copied from compact(). */
1.1       kristaps 1205:                assert(MDOC_TEXT == n->type);
1.9       schwarze 1206:
1.1       kristaps 1207:                if (strlcat(buf, n->string, 64) >= 64)
1.19      schwarze 1208:                        return(mdoc_nerr(mdoc, n, ETOOLONG));
1.1       kristaps 1209:                if (NULL == n->next)
                   1210:                        continue;
                   1211:                if (strlcat(buf, " ", 64) >= 64)
1.19      schwarze 1212:                        return(mdoc_nerr(mdoc, n, ETOOLONG));
1.1       kristaps 1213:        }
                   1214:
1.51      schwarze 1215:        sec = mdoc_str2sec(buf);
1.1       kristaps 1216:
1.9       schwarze 1217:        /*
                   1218:         * Check: NAME should always be first, CUSTOM has no roles,
                   1219:         * non-CUSTOM has a conventional order to be followed.
                   1220:         */
1.1       kristaps 1221:
1.51      schwarze 1222:        if (SEC_NAME != sec && SEC_NONE == mdoc->lastnamed)
                   1223:                if ( ! mdoc_nwarn(mdoc, mdoc->last, ESECNAME))
                   1224:                        return(0);
                   1225:
1.1       kristaps 1226:        if (SEC_CUSTOM == sec)
                   1227:                return(1);
1.51      schwarze 1228:
1.1       kristaps 1229:        if (sec == mdoc->lastnamed)
1.23      schwarze 1230:                if ( ! mdoc_nwarn(mdoc, mdoc->last, ESECREP))
                   1231:                        return(0);
1.51      schwarze 1232:
1.1       kristaps 1233:        if (sec < mdoc->lastnamed)
1.23      schwarze 1234:                if ( ! mdoc_nwarn(mdoc, mdoc->last, ESECOOO))
                   1235:                        return(0);
1.1       kristaps 1236:
1.9       schwarze 1237:        /*
                   1238:         * Check particular section/manual conventions.  LIBRARY can
                   1239:         * only occur in msec 2, 3 (TODO: are there more of these?).
                   1240:         */
1.1       kristaps 1241:
                   1242:        switch (sec) {
                   1243:        case (SEC_LIBRARY):
                   1244:                switch (mdoc->meta.msec) {
                   1245:                case (2):
                   1246:                        /* FALLTHROUGH */
                   1247:                case (3):
                   1248:                        break;
                   1249:                default:
1.21      schwarze 1250:                        return(mdoc_nwarn(mdoc, mdoc->last, EWRONGMSEC));
1.1       kristaps 1251:                }
                   1252:                break;
                   1253:        default:
                   1254:                break;
                   1255:        }
                   1256:
                   1257:        return(1);
                   1258: }