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

Annotation of mandoc/mdoc_validate.c, Revision 1.349

1.349   ! schwarze    1: /*     $Id: mdoc_validate.c,v 1.348 2017/07/03 17:33:06 schwarze Exp $ */
1.1       kristaps    2: /*
1.183     schwarze    3:  * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
1.311     schwarze    4:  * Copyright (c) 2010-2017 Ingo Schwarze <schwarze@openbsd.org>
1.199     schwarze    5:  * Copyright (c) 2010 Joerg Sonnenberger <joerg@netbsd.org>
1.1       kristaps    6:  *
                      7:  * Permission to use, copy, modify, and distribute this software for any
1.5       kristaps    8:  * purpose with or without fee is hereby granted, provided that the above
                      9:  * copyright notice and this permission notice appear in all copies.
1.1       kristaps   10:  *
1.284     schwarze   11:  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHORS DISCLAIM ALL WARRANTIES
1.5       kristaps   12:  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
1.284     schwarze   13:  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR
1.5       kristaps   14:  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
                     15:  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
                     16:  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
                     17:  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1.1       kristaps   18:  */
1.56      kristaps   19: #include "config.h"
                     20:
1.244     schwarze   21: #include <sys/types.h>
1.196     schwarze   22: #ifndef OSNAME
1.132     kristaps   23: #include <sys/utsname.h>
                     24: #endif
1.1       kristaps   25:
                     26: #include <assert.h>
                     27: #include <ctype.h>
1.35      kristaps   28: #include <limits.h>
1.81      kristaps   29: #include <stdio.h>
1.1       kristaps   30: #include <stdlib.h>
1.2       kristaps   31: #include <string.h>
1.132     kristaps   32: #include <time.h>
1.1       kristaps   33:
1.284     schwarze   34: #include "mandoc_aux.h"
                     35: #include "mandoc.h"
1.346     schwarze   36: #include "mandoc_xr.h"
1.284     schwarze   37: #include "roff.h"
1.165     kristaps   38: #include "mdoc.h"
1.284     schwarze   39: #include "libmandoc.h"
1.287     schwarze   40: #include "roff_int.h"
1.1       kristaps   41: #include "libmdoc.h"
                     42:
                     43: /* FIXME: .Bl -diag can't have non-text children in HEAD. */
                     44:
1.286     schwarze   45: #define        POST_ARGS struct roff_man *mdoc
1.1       kristaps   46:
1.120     kristaps   47: enum   check_ineq {
                     48:        CHECK_LT,
                     49:        CHECK_GT,
                     50:        CHECK_EQ
                     51: };
                     52:
1.259     schwarze   53: typedef        void    (*v_post)(POST_ARGS);
1.1       kristaps   54:
1.317     schwarze   55: static int      build_list(struct roff_man *, int);
1.286     schwarze   56: static void     check_text(struct roff_man *, int, int, char *);
                     57: static void     check_argv(struct roff_man *,
1.285     schwarze   58:                        struct roff_node *, struct mdoc_argv *);
1.286     schwarze   59: static void     check_args(struct roff_man *, struct roff_node *);
1.336     schwarze   60: static void     check_toptext(struct roff_man *, int, int, const char *);
1.285     schwarze   61: static int      child_an(const struct roff_node *);
1.320     schwarze   62: static size_t          macro2len(enum roff_tok);
1.322     schwarze   63: static void     rewrite_macro2len(struct roff_man *, char **);
1.343     schwarze   64: static int      similar(const char *, const char *);
1.132     kristaps   65:
1.259     schwarze   66: static void     post_an(POST_ARGS);
1.299     schwarze   67: static void     post_an_norm(POST_ARGS);
1.259     schwarze   68: static void     post_at(POST_ARGS);
1.299     schwarze   69: static void     post_bd(POST_ARGS);
1.259     schwarze   70: static void     post_bf(POST_ARGS);
                     71: static void     post_bk(POST_ARGS);
                     72: static void     post_bl(POST_ARGS);
                     73: static void     post_bl_block(POST_ARGS);
                     74: static void     post_bl_head(POST_ARGS);
1.299     schwarze   75: static void     post_bl_norm(POST_ARGS);
1.259     schwarze   76: static void     post_bx(POST_ARGS);
                     77: static void     post_defaults(POST_ARGS);
1.299     schwarze   78: static void     post_display(POST_ARGS);
1.259     schwarze   79: static void     post_dd(POST_ARGS);
1.333     schwarze   80: static void     post_delim(POST_ARGS);
1.348     schwarze   81: static void     post_delim_nb(POST_ARGS);
1.259     schwarze   82: static void     post_dt(POST_ARGS);
                     83: static void     post_en(POST_ARGS);
                     84: static void     post_es(POST_ARGS);
                     85: static void     post_eoln(POST_ARGS);
                     86: static void     post_ex(POST_ARGS);
                     87: static void     post_fa(POST_ARGS);
                     88: static void     post_fn(POST_ARGS);
                     89: static void     post_fname(POST_ARGS);
                     90: static void     post_fo(POST_ARGS);
                     91: static void     post_hyph(POST_ARGS);
                     92: static void     post_ignpar(POST_ARGS);
                     93: static void     post_it(POST_ARGS);
                     94: static void     post_lb(POST_ARGS);
                     95: static void     post_nd(POST_ARGS);
                     96: static void     post_nm(POST_ARGS);
                     97: static void     post_ns(POST_ARGS);
1.299     schwarze   98: static void     post_obsolete(POST_ARGS);
1.259     schwarze   99: static void     post_os(POST_ARGS);
                    100: static void     post_par(POST_ARGS);
1.299     schwarze  101: static void     post_prevpar(POST_ARGS);
1.259     schwarze  102: static void     post_root(POST_ARGS);
                    103: static void     post_rs(POST_ARGS);
1.317     schwarze  104: static void     post_rv(POST_ARGS);
1.259     schwarze  105: static void     post_sh(POST_ARGS);
                    106: static void     post_sh_head(POST_ARGS);
                    107: static void     post_sh_name(POST_ARGS);
                    108: static void     post_sh_see_also(POST_ARGS);
                    109: static void     post_sh_authors(POST_ARGS);
                    110: static void     post_sm(POST_ARGS);
                    111: static void     post_st(POST_ARGS);
1.299     schwarze  112: static void     post_std(POST_ARGS);
1.348     schwarze  113: static void     post_sx(POST_ARGS);
1.328     schwarze  114: static void     post_useless(POST_ARGS);
1.310     schwarze  115: static void     post_xr(POST_ARGS);
1.315     schwarze  116: static void     post_xx(POST_ARGS);
1.259     schwarze  117:
1.320     schwarze  118: static const v_post __mdoc_valids[MDOC_MAX - MDOC_Dd] = {
1.299     schwarze  119:        post_dd,        /* Dd */
                    120:        post_dt,        /* Dt */
                    121:        post_os,        /* Os */
                    122:        post_sh,        /* Sh */
                    123:        post_ignpar,    /* Ss */
                    124:        post_par,       /* Pp */
                    125:        post_display,   /* D1 */
                    126:        post_display,   /* Dl */
                    127:        post_display,   /* Bd */
                    128:        NULL,           /* Ed */
                    129:        post_bl,        /* Bl */
                    130:        NULL,           /* El */
                    131:        post_it,        /* It */
1.348     schwarze  132:        post_delim_nb,  /* Ad */
1.299     schwarze  133:        post_an,        /* An */
1.320     schwarze  134:        NULL,           /* Ap */
1.299     schwarze  135:        post_defaults,  /* Ar */
                    136:        NULL,           /* Cd */
1.348     schwarze  137:        post_delim_nb,  /* Cm */
                    138:        post_delim_nb,  /* Dv */
                    139:        post_delim_nb,  /* Er */
                    140:        post_delim_nb,  /* Ev */
1.299     schwarze  141:        post_ex,        /* Ex */
                    142:        post_fa,        /* Fa */
                    143:        NULL,           /* Fd */
1.348     schwarze  144:        post_delim_nb,  /* Fl */
1.299     schwarze  145:        post_fn,        /* Fn */
1.348     schwarze  146:        post_delim_nb,  /* Ft */
                    147:        post_delim_nb,  /* Ic */
                    148:        post_delim_nb,  /* In */
1.299     schwarze  149:        post_defaults,  /* Li */
                    150:        post_nd,        /* Nd */
                    151:        post_nm,        /* Nm */
1.348     schwarze  152:        post_delim_nb,  /* Op */
1.299     schwarze  153:        post_obsolete,  /* Ot */
                    154:        post_defaults,  /* Pa */
1.317     schwarze  155:        post_rv,        /* Rv */
1.299     schwarze  156:        post_st,        /* St */
1.348     schwarze  157:        post_delim_nb,  /* Va */
                    158:        post_delim_nb,  /* Vt */
1.310     schwarze  159:        post_xr,        /* Xr */
1.299     schwarze  160:        NULL,           /* %A */
                    161:        post_hyph,      /* %B */ /* FIXME: can be used outside Rs/Re. */
                    162:        NULL,           /* %D */
                    163:        NULL,           /* %I */
                    164:        NULL,           /* %J */
                    165:        post_hyph,      /* %N */
                    166:        post_hyph,      /* %O */
                    167:        NULL,           /* %P */
                    168:        post_hyph,      /* %R */
                    169:        post_hyph,      /* %T */ /* FIXME: can be used outside Rs/Re. */
                    170:        NULL,           /* %V */
                    171:        NULL,           /* Ac */
1.348     schwarze  172:        post_delim_nb,  /* Ao */
                    173:        post_delim_nb,  /* Aq */
1.299     schwarze  174:        post_at,        /* At */
                    175:        NULL,           /* Bc */
                    176:        post_bf,        /* Bf */
1.348     schwarze  177:        post_delim_nb,  /* Bo */
1.299     schwarze  178:        NULL,           /* Bq */
1.315     schwarze  179:        post_xx,        /* Bsx */
1.299     schwarze  180:        post_bx,        /* Bx */
                    181:        post_obsolete,  /* Db */
                    182:        NULL,           /* Dc */
                    183:        NULL,           /* Do */
                    184:        NULL,           /* Dq */
                    185:        NULL,           /* Ec */
                    186:        NULL,           /* Ef */
1.348     schwarze  187:        post_delim_nb,  /* Em */
1.299     schwarze  188:        NULL,           /* Eo */
1.315     schwarze  189:        post_xx,        /* Fx */
1.348     schwarze  190:        post_delim_nb,  /* Ms */
1.335     schwarze  191:        NULL,           /* No */
1.299     schwarze  192:        post_ns,        /* Ns */
1.315     schwarze  193:        post_xx,        /* Nx */
                    194:        post_xx,        /* Ox */
1.299     schwarze  195:        NULL,           /* Pc */
                    196:        NULL,           /* Pf */
1.348     schwarze  197:        post_delim_nb,  /* Po */
                    198:        post_delim_nb,  /* Pq */
1.299     schwarze  199:        NULL,           /* Qc */
1.348     schwarze  200:        post_delim_nb,  /* Ql */
                    201:        post_delim_nb,  /* Qo */
                    202:        post_delim_nb,  /* Qq */
1.299     schwarze  203:        NULL,           /* Re */
                    204:        post_rs,        /* Rs */
                    205:        NULL,           /* Sc */
1.348     schwarze  206:        post_delim_nb,  /* So */
                    207:        post_delim_nb,  /* Sq */
1.299     schwarze  208:        post_sm,        /* Sm */
1.348     schwarze  209:        post_sx,        /* Sx */
                    210:        post_delim_nb,  /* Sy */
1.328     schwarze  211:        post_useless,   /* Tn */
1.315     schwarze  212:        post_xx,        /* Ux */
1.299     schwarze  213:        NULL,           /* Xc */
                    214:        NULL,           /* Xo */
                    215:        post_fo,        /* Fo */
                    216:        NULL,           /* Fc */
1.348     schwarze  217:        post_delim_nb,  /* Oo */
1.299     schwarze  218:        NULL,           /* Oc */
                    219:        post_bk,        /* Bk */
                    220:        NULL,           /* Ek */
                    221:        post_eoln,      /* Bt */
1.333     schwarze  222:        post_obsolete,  /* Hf */
1.299     schwarze  223:        post_obsolete,  /* Fr */
                    224:        post_eoln,      /* Ud */
                    225:        post_lb,        /* Lb */
                    226:        post_par,       /* Lp */
1.348     schwarze  227:        post_delim_nb,  /* Lk */
1.299     schwarze  228:        post_defaults,  /* Mt */
1.348     schwarze  229:        post_delim_nb,  /* Brq */
                    230:        post_delim_nb,  /* Bro */
1.299     schwarze  231:        NULL,           /* Brc */
                    232:        NULL,           /* %C */
                    233:        post_es,        /* Es */
                    234:        post_en,        /* En */
1.315     schwarze  235:        post_xx,        /* Dx */
1.299     schwarze  236:        NULL,           /* %Q */
                    237:        NULL,           /* %U */
                    238:        NULL,           /* Ta */
1.1       kristaps  239: };
1.320     schwarze  240: static const v_post *const mdoc_valids = __mdoc_valids - MDOC_Dd;
1.1       kristaps  241:
1.122     kristaps  242: #define        RSORD_MAX 14 /* Number of `Rs' blocks. */
                    243:
1.320     schwarze  244: static const enum roff_tok rsord[RSORD_MAX] = {
1.122     kristaps  245:        MDOC__A,
                    246:        MDOC__T,
                    247:        MDOC__B,
                    248:        MDOC__I,
                    249:        MDOC__J,
                    250:        MDOC__R,
                    251:        MDOC__N,
                    252:        MDOC__V,
1.186     schwarze  253:        MDOC__U,
1.122     kristaps  254:        MDOC__P,
                    255:        MDOC__Q,
1.192     schwarze  256:        MDOC__C,
1.122     kristaps  257:        MDOC__D,
1.192     schwarze  258:        MDOC__O
1.122     kristaps  259: };
                    260:
1.160     kristaps  261: static const char * const secnames[SEC__MAX] = {
                    262:        NULL,
                    263:        "NAME",
                    264:        "LIBRARY",
                    265:        "SYNOPSIS",
                    266:        "DESCRIPTION",
1.208     schwarze  267:        "CONTEXT",
1.160     kristaps  268:        "IMPLEMENTATION NOTES",
                    269:        "RETURN VALUES",
                    270:        "ENVIRONMENT",
                    271:        "FILES",
                    272:        "EXIT STATUS",
                    273:        "EXAMPLES",
                    274:        "DIAGNOSTICS",
                    275:        "COMPATIBILITY",
                    276:        "ERRORS",
                    277:        "SEE ALSO",
                    278:        "STANDARDS",
                    279:        "HISTORY",
                    280:        "AUTHORS",
                    281:        "CAVEATS",
                    282:        "BUGS",
                    283:        "SECURITY CONSIDERATIONS",
                    284:        NULL
                    285: };
1.1       kristaps  286:
1.210     schwarze  287:
1.259     schwarze  288: void
1.298     schwarze  289: mdoc_node_validate(struct roff_man *mdoc)
1.1       kristaps  290: {
1.285     schwarze  291:        struct roff_node *n;
1.320     schwarze  292:        const v_post *p;
1.1       kristaps  293:
1.242     schwarze  294:        n = mdoc->last;
1.298     schwarze  295:        mdoc->last = mdoc->last->child;
                    296:        while (mdoc->last != NULL) {
                    297:                mdoc_node_validate(mdoc);
                    298:                if (mdoc->last == n)
                    299:                        mdoc->last = mdoc->last->child;
                    300:                else
                    301:                        mdoc->last = mdoc->last->next;
                    302:        }
1.1       kristaps  303:
1.298     schwarze  304:        mdoc->last = n;
                    305:        mdoc->next = ROFF_NEXT_SIBLING;
1.242     schwarze  306:        switch (n->type) {
1.284     schwarze  307:        case ROFFT_TEXT:
1.312     schwarze  308:                if (n->sec != SEC_SYNOPSIS ||
                    309:                    (n->parent->tok != MDOC_Cd && n->parent->tok != MDOC_Fd))
1.299     schwarze  310:                        check_text(mdoc, n->line, n->pos, n->string);
1.336     schwarze  311:                if (n->parent->tok == MDOC_It ||
                    312:                    (n->parent->type == ROFFT_BODY &&
                    313:                     (n->parent->tok == MDOC_Sh ||
                    314:                      n->parent->tok == MDOC_Ss)))
                    315:                        check_toptext(mdoc, n->line, n->pos, n->string);
1.299     schwarze  316:                break;
1.284     schwarze  317:        case ROFFT_EQN:
                    318:        case ROFFT_TBL:
1.259     schwarze  319:                break;
1.284     schwarze  320:        case ROFFT_ROOT:
1.259     schwarze  321:                post_root(mdoc);
                    322:                break;
1.150     kristaps  323:        default:
1.299     schwarze  324:                check_args(mdoc, mdoc->last);
1.255     schwarze  325:
                    326:                /*
                    327:                 * Closing delimiters are not special at the
                    328:                 * beginning of a block, opening delimiters
                    329:                 * are not special at the end.
                    330:                 */
                    331:
                    332:                if (n->child != NULL)
1.314     schwarze  333:                        n->child->flags &= ~NODE_DELIMC;
1.255     schwarze  334:                if (n->last != NULL)
1.314     schwarze  335:                        n->last->flags &= ~NODE_DELIMO;
1.255     schwarze  336:
                    337:                /* Call the macro's postprocessor. */
                    338:
1.323     schwarze  339:                if (n->tok < ROFF_MAX) {
                    340:                        switch(n->tok) {
                    341:                        case ROFF_br:
1.326     schwarze  342:                        case ROFF_sp:
1.323     schwarze  343:                                post_par(mdoc);
                    344:                                break;
                    345:                        default:
1.324     schwarze  346:                                roff_validate(mdoc);
                    347:                                break;
1.323     schwarze  348:                        }
                    349:                        break;
                    350:                }
                    351:
                    352:                assert(n->tok >= MDOC_Dd && n->tok < MDOC_MAX);
1.299     schwarze  353:                p = mdoc_valids + n->tok;
1.259     schwarze  354:                if (*p)
                    355:                        (*p)(mdoc);
1.298     schwarze  356:                if (mdoc->last == n)
                    357:                        mdoc_state(mdoc, n);
1.259     schwarze  358:                break;
1.150     kristaps  359:        }
1.1       kristaps  360: }
                    361:
1.259     schwarze  362: static void
1.286     schwarze  363: check_args(struct roff_man *mdoc, struct roff_node *n)
1.1       kristaps  364: {
                    365:        int              i;
                    366:
                    367:        if (NULL == n->args)
1.133     kristaps  368:                return;
1.1       kristaps  369:
                    370:        assert(n->args->argc);
                    371:        for (i = 0; i < (int)n->args->argc; i++)
1.191     schwarze  372:                check_argv(mdoc, n, &n->args->argv[i]);
1.1       kristaps  373: }
                    374:
1.133     kristaps  375: static void
1.286     schwarze  376: check_argv(struct roff_man *mdoc, struct roff_node *n, struct mdoc_argv *v)
1.1       kristaps  377: {
                    378:        int              i;
                    379:
                    380:        for (i = 0; i < (int)v->sz; i++)
1.191     schwarze  381:                check_text(mdoc, v->line, v->pos, v->value[i]);
1.1       kristaps  382: }
                    383:
1.133     kristaps  384: static void
1.286     schwarze  385: check_text(struct roff_man *mdoc, int ln, int pos, char *p)
1.1       kristaps  386: {
1.172     kristaps  387:        char            *cp;
1.102     kristaps  388:
1.191     schwarze  389:        if (MDOC_LITERAL & mdoc->flags)
1.177     schwarze  390:                return;
                    391:
                    392:        for (cp = p; NULL != (p = strchr(p, '\t')); p++)
1.229     schwarze  393:                mandoc_msg(MANDOCERR_FI_TAB, mdoc->parse,
                    394:                    ln, pos + (int)(p - cp), NULL);
1.1       kristaps  395: }
                    396:
1.259     schwarze  397: static void
1.336     schwarze  398: check_toptext(struct roff_man *mdoc, int ln, int pos, const char *p)
1.329     schwarze  399: {
1.336     schwarze  400:        const char      *cp, *cpr;
                    401:
                    402:        if (*p == '\0')
                    403:                return;
1.329     schwarze  404:
                    405:        if ((cp = strstr(p, "OpenBSD")) != NULL)
                    406:                mandoc_msg(MANDOCERR_BX, mdoc->parse,
                    407:                    ln, pos + (cp - p), "Ox");
                    408:        if ((cp = strstr(p, "NetBSD")) != NULL)
                    409:                mandoc_msg(MANDOCERR_BX, mdoc->parse,
                    410:                    ln, pos + (cp - p), "Nx");
                    411:        if ((cp = strstr(p, "FreeBSD")) != NULL)
                    412:                mandoc_msg(MANDOCERR_BX, mdoc->parse,
                    413:                    ln, pos + (cp - p), "Fx");
                    414:        if ((cp = strstr(p, "DragonFly")) != NULL)
                    415:                mandoc_msg(MANDOCERR_BX, mdoc->parse,
                    416:                    ln, pos + (cp - p), "Dx");
1.336     schwarze  417:
                    418:        cp = p;
                    419:        while ((cp = strstr(cp + 1, "()")) != NULL) {
                    420:                for (cpr = cp - 1; cpr >= p; cpr--)
                    421:                        if (*cpr != '_' && !isalnum((unsigned char)*cpr))
                    422:                                break;
                    423:                if ((cpr < p || *cpr == ' ') && cpr + 1 < cp) {
                    424:                        cpr++;
                    425:                        mandoc_vmsg(MANDOCERR_FUNC, mdoc->parse,
                    426:                            ln, pos + (cpr - p),
                    427:                            "%.*s()", (int)(cp - cpr), cpr);
                    428:                }
                    429:        }
1.329     schwarze  430: }
                    431:
                    432: static void
1.333     schwarze  433: post_delim(POST_ARGS)
                    434: {
                    435:        const struct roff_node  *nch;
1.348     schwarze  436:        const char              *lc;
                    437:        enum mdelim              delim;
                    438:        enum roff_tok            tok;
                    439:
                    440:        tok = mdoc->last->tok;
                    441:        nch = mdoc->last->last;
                    442:        if (nch == NULL || nch->type != ROFFT_TEXT)
                    443:                return;
                    444:        lc = strchr(nch->string, '\0') - 1;
                    445:        if (lc < nch->string)
                    446:                return;
                    447:        delim = mdoc_isdelim(lc);
                    448:        if (delim == DELIM_NONE || delim == DELIM_OPEN)
                    449:                return;
                    450:        if (*lc == ')' && (tok == MDOC_Nd || tok == MDOC_Sh ||
                    451:            tok == MDOC_Ss || tok == MDOC_Fo))
                    452:                return;
                    453:
                    454:        mandoc_vmsg(MANDOCERR_DELIM, mdoc->parse,
                    455:            nch->line, nch->pos + (lc - nch->string),
                    456:            "%s%s %s", roff_name[tok],
                    457:            nch == mdoc->last->child ? "" : " ...", nch->string);
                    458: }
                    459:
                    460: static void
                    461: post_delim_nb(POST_ARGS)
                    462: {
                    463:        const struct roff_node  *nch;
1.334     schwarze  464:        const char              *lc, *cp;
                    465:        int                      nw;
1.333     schwarze  466:        enum mdelim              delim;
1.334     schwarze  467:        enum roff_tok            tok;
1.333     schwarze  468:
1.334     schwarze  469:        /*
                    470:         * Find candidates: at least two bytes,
                    471:         * the last one a closing or middle delimiter.
                    472:         */
                    473:
                    474:        tok = mdoc->last->tok;
1.333     schwarze  475:        nch = mdoc->last->last;
                    476:        if (nch == NULL || nch->type != ROFFT_TEXT)
                    477:                return;
                    478:        lc = strchr(nch->string, '\0') - 1;
                    479:        if (lc <= nch->string)
                    480:                return;
                    481:        delim = mdoc_isdelim(lc);
                    482:        if (delim == DELIM_NONE || delim == DELIM_OPEN)
                    483:                return;
1.334     schwarze  484:
                    485:        /*
                    486:         * Reduce false positives by allowing various cases.
                    487:         */
                    488:
                    489:        /* Escaped delimiters. */
                    490:        if (lc > nch->string + 1 && lc[-2] == '\\' &&
                    491:            (lc[-1] == '&' || lc[-1] == 'e'))
                    492:                return;
                    493:
                    494:        /* Specific byte sequences. */
                    495:        switch (*lc) {
                    496:        case ')':
                    497:                for (cp = lc; cp >= nch->string; cp--)
                    498:                        if (*cp == '(')
                    499:                                return;
                    500:                break;
                    501:        case '.':
                    502:                if (lc > nch->string + 1 && lc[-2] == '.' && lc[-1] == '.')
                    503:                        return;
                    504:                if (lc[-1] == '.')
                    505:                        return;
                    506:                break;
                    507:        case ';':
                    508:                if (tok == MDOC_Vt)
                    509:                        return;
                    510:                break;
                    511:        case '?':
                    512:                if (lc[-1] == '?')
                    513:                        return;
                    514:                break;
                    515:        case ']':
                    516:                for (cp = lc; cp >= nch->string; cp--)
                    517:                        if (*cp == '[')
                    518:                                return;
                    519:                break;
                    520:        case '|':
                    521:                if (lc == nch->string + 1 && lc[-1] == '|')
                    522:                        return;
                    523:        default:
                    524:                break;
                    525:        }
                    526:
                    527:        /* Exactly two non-alphanumeric bytes. */
                    528:        if (lc == nch->string + 1 && !isalnum((unsigned char)lc[-1]))
                    529:                return;
                    530:
                    531:        /* At least three alphabetic words with a sentence ending. */
                    532:        if (strchr("!.:?", *lc) != NULL && (tok == MDOC_Em ||
1.335     schwarze  533:            tok == MDOC_Li || tok == MDOC_Po || tok == MDOC_Pq ||
                    534:            tok == MDOC_Sy)) {
1.334     schwarze  535:                nw = 0;
                    536:                for (cp = lc - 1; cp >= nch->string; cp--) {
                    537:                        if (*cp == ' ') {
                    538:                                nw++;
                    539:                                if (cp > nch->string && cp[-1] == ',')
                    540:                                        cp--;
                    541:                        } else if (isalpha((unsigned int)*cp)) {
                    542:                                if (nw > 1)
                    543:                                        return;
                    544:                        } else
                    545:                                break;
                    546:                }
                    547:        }
                    548:
1.348     schwarze  549:        mandoc_vmsg(MANDOCERR_DELIM_NB, mdoc->parse,
1.333     schwarze  550:            nch->line, nch->pos + (lc - nch->string),
1.334     schwarze  551:            "%s%s %s", roff_name[tok],
1.333     schwarze  552:            nch == mdoc->last->child ? "" : " ...", nch->string);
                    553: }
                    554:
                    555: static void
1.299     schwarze  556: post_bl_norm(POST_ARGS)
1.1       kristaps  557: {
1.299     schwarze  558:        struct roff_node *n;
1.238     schwarze  559:        struct mdoc_argv *argv, *wa;
1.227     schwarze  560:        int               i;
1.238     schwarze  561:        enum mdocargt     mdoclt;
1.104     kristaps  562:        enum mdoc_list    lt;
1.1       kristaps  563:
1.299     schwarze  564:        n = mdoc->last->parent;
                    565:        n->norm->Bl.type = LIST__NONE;
1.1       kristaps  566:
1.210     schwarze  567:        /*
1.91      kristaps  568:         * First figure out which kind of list to use: bind ourselves to
                    569:         * the first mentioned list type and warn about any remaining
                    570:         * ones.  If we find no list type, we default to LIST_item.
                    571:         */
1.1       kristaps  572:
1.245     schwarze  573:        wa = (n->args == NULL) ? NULL : n->args->argv;
1.238     schwarze  574:        mdoclt = MDOC_ARG_MAX;
1.91      kristaps  575:        for (i = 0; n->args && i < (int)n->args->argc; i++) {
1.227     schwarze  576:                argv = n->args->argv + i;
1.91      kristaps  577:                lt = LIST__NONE;
1.227     schwarze  578:                switch (argv->arg) {
1.91      kristaps  579:                /* Set list types. */
1.210     schwarze  580:                case MDOC_Bullet:
1.91      kristaps  581:                        lt = LIST_bullet;
                    582:                        break;
1.210     schwarze  583:                case MDOC_Dash:
1.91      kristaps  584:                        lt = LIST_dash;
                    585:                        break;
1.210     schwarze  586:                case MDOC_Enum:
1.91      kristaps  587:                        lt = LIST_enum;
                    588:                        break;
1.210     schwarze  589:                case MDOC_Hyphen:
1.91      kristaps  590:                        lt = LIST_hyphen;
                    591:                        break;
1.210     schwarze  592:                case MDOC_Item:
1.91      kristaps  593:                        lt = LIST_item;
                    594:                        break;
1.210     schwarze  595:                case MDOC_Tag:
1.91      kristaps  596:                        lt = LIST_tag;
                    597:                        break;
1.210     schwarze  598:                case MDOC_Diag:
1.91      kristaps  599:                        lt = LIST_diag;
                    600:                        break;
1.210     schwarze  601:                case MDOC_Hang:
1.91      kristaps  602:                        lt = LIST_hang;
                    603:                        break;
1.210     schwarze  604:                case MDOC_Ohang:
1.91      kristaps  605:                        lt = LIST_ohang;
                    606:                        break;
1.210     schwarze  607:                case MDOC_Inset:
1.91      kristaps  608:                        lt = LIST_inset;
                    609:                        break;
1.210     schwarze  610:                case MDOC_Column:
1.91      kristaps  611:                        lt = LIST_column;
                    612:                        break;
                    613:                /* Set list arguments. */
1.210     schwarze  614:                case MDOC_Compact:
1.227     schwarze  615:                        if (n->norm->Bl.comp)
                    616:                                mandoc_msg(MANDOCERR_ARG_REP,
                    617:                                    mdoc->parse, argv->line,
                    618:                                    argv->pos, "Bl -compact");
                    619:                        n->norm->Bl.comp = 1;
1.91      kristaps  620:                        break;
1.210     schwarze  621:                case MDOC_Width:
1.238     schwarze  622:                        wa = argv;
1.227     schwarze  623:                        if (0 == argv->sz) {
                    624:                                mandoc_msg(MANDOCERR_ARG_EMPTY,
                    625:                                    mdoc->parse, argv->line,
                    626:                                    argv->pos, "Bl -width");
                    627:                                n->norm->Bl.width = "0n";
1.182     kristaps  628:                                break;
                    629:                        }
1.227     schwarze  630:                        if (NULL != n->norm->Bl.width)
                    631:                                mandoc_vmsg(MANDOCERR_ARG_REP,
                    632:                                    mdoc->parse, argv->line,
                    633:                                    argv->pos, "Bl -width %s",
                    634:                                    argv->value[0]);
1.322     schwarze  635:                        rewrite_macro2len(mdoc, argv->value);
1.227     schwarze  636:                        n->norm->Bl.width = argv->value[0];
1.8       kristaps  637:                        break;
1.210     schwarze  638:                case MDOC_Offset:
1.227     schwarze  639:                        if (0 == argv->sz) {
                    640:                                mandoc_msg(MANDOCERR_ARG_EMPTY,
                    641:                                    mdoc->parse, argv->line,
                    642:                                    argv->pos, "Bl -offset");
1.98      kristaps  643:                                break;
                    644:                        }
1.227     schwarze  645:                        if (NULL != n->norm->Bl.offs)
                    646:                                mandoc_vmsg(MANDOCERR_ARG_REP,
                    647:                                    mdoc->parse, argv->line,
                    648:                                    argv->pos, "Bl -offset %s",
                    649:                                    argv->value[0]);
1.322     schwarze  650:                        rewrite_macro2len(mdoc, argv->value);
1.227     schwarze  651:                        n->norm->Bl.offs = argv->value[0];
1.1       kristaps  652:                        break;
1.113     kristaps  653:                default:
                    654:                        continue;
1.1       kristaps  655:                }
1.228     schwarze  656:                if (LIST__NONE == lt)
                    657:                        continue;
1.238     schwarze  658:                mdoclt = argv->arg;
1.1       kristaps  659:
1.91      kristaps  660:                /* Check: multiple list types. */
                    661:
1.228     schwarze  662:                if (LIST__NONE != n->norm->Bl.type) {
1.239     schwarze  663:                        mandoc_vmsg(MANDOCERR_BL_REP,
1.228     schwarze  664:                            mdoc->parse, n->line, n->pos,
1.239     schwarze  665:                            "Bl -%s", mdoc_argnames[argv->arg]);
1.228     schwarze  666:                        continue;
1.109     kristaps  667:                }
1.91      kristaps  668:
                    669:                /* The list type should come first. */
                    670:
1.228     schwarze  671:                if (n->norm->Bl.width ||
                    672:                    n->norm->Bl.offs ||
                    673:                    n->norm->Bl.comp)
1.239     schwarze  674:                        mandoc_vmsg(MANDOCERR_BL_LATETYPE,
                    675:                            mdoc->parse, n->line, n->pos, "Bl -%s",
1.228     schwarze  676:                            mdoc_argnames[n->args->argv[0].arg]);
                    677:
                    678:                n->norm->Bl.type = lt;
                    679:                if (LIST_column == lt) {
                    680:                        n->norm->Bl.ncols = argv->sz;
                    681:                        n->norm->Bl.cols = (void *)argv->value;
                    682:                }
1.91      kristaps  683:        }
                    684:
                    685:        /* Allow lists to default to LIST_item. */
                    686:
1.147     kristaps  687:        if (LIST__NONE == n->norm->Bl.type) {
1.239     schwarze  688:                mandoc_msg(MANDOCERR_BL_NOTYPE, mdoc->parse,
                    689:                    n->line, n->pos, "Bl");
1.147     kristaps  690:                n->norm->Bl.type = LIST_item;
1.303     schwarze  691:                mdoclt = MDOC_Item;
1.79      kristaps  692:        }
1.1       kristaps  693:
1.210     schwarze  694:        /*
1.8       kristaps  695:         * Validate the width field.  Some list types don't need width
                    696:         * types and should be warned about them.  Others should have it
1.185     schwarze  697:         * and must also be warned.  Yet others have a default and need
                    698:         * no warning.
1.8       kristaps  699:         */
                    700:
1.147     kristaps  701:        switch (n->norm->Bl.type) {
1.210     schwarze  702:        case LIST_tag:
1.349   ! schwarze  703:                if (n->norm->Bl.width == NULL)
1.239     schwarze  704:                        mandoc_msg(MANDOCERR_BL_NOWIDTH, mdoc->parse,
                    705:                            n->line, n->pos, "Bl -tag");
1.133     kristaps  706:                break;
1.210     schwarze  707:        case LIST_column:
                    708:        case LIST_diag:
                    709:        case LIST_ohang:
                    710:        case LIST_inset:
                    711:        case LIST_item:
1.349   ! schwarze  712:                if (n->norm->Bl.width != NULL)
1.238     schwarze  713:                        mandoc_vmsg(MANDOCERR_BL_SKIPW, mdoc->parse,
                    714:                            wa->line, wa->pos, "Bl -%s",
                    715:                            mdoc_argnames[mdoclt]);
1.349   ! schwarze  716:                n->norm->Bl.width = NULL;
1.185     schwarze  717:                break;
1.210     schwarze  718:        case LIST_bullet:
                    719:        case LIST_dash:
                    720:        case LIST_hyphen:
1.349   ! schwarze  721:                if (n->norm->Bl.width == NULL)
1.185     schwarze  722:                        n->norm->Bl.width = "2n";
                    723:                break;
1.210     schwarze  724:        case LIST_enum:
1.349   ! schwarze  725:                if (n->norm->Bl.width == NULL)
1.185     schwarze  726:                        n->norm->Bl.width = "3n";
1.133     kristaps  727:                break;
1.8       kristaps  728:        default:
                    729:                break;
                    730:        }
1.1       kristaps  731: }
                    732:
1.259     schwarze  733: static void
1.299     schwarze  734: post_bd(POST_ARGS)
1.1       kristaps  735: {
1.299     schwarze  736:        struct roff_node *n;
1.227     schwarze  737:        struct mdoc_argv *argv;
                    738:        int               i;
1.210     schwarze  739:        enum mdoc_disp    dt;
1.1       kristaps  740:
1.299     schwarze  741:        n = mdoc->last;
1.93      kristaps  742:        for (i = 0; n->args && i < (int)n->args->argc; i++) {
1.227     schwarze  743:                argv = n->args->argv + i;
1.93      kristaps  744:                dt = DISP__NONE;
1.94      kristaps  745:
1.227     schwarze  746:                switch (argv->arg) {
1.210     schwarze  747:                case MDOC_Centred:
1.231     schwarze  748:                        dt = DISP_centered;
1.93      kristaps  749:                        break;
1.210     schwarze  750:                case MDOC_Ragged:
1.93      kristaps  751:                        dt = DISP_ragged;
                    752:                        break;
1.210     schwarze  753:                case MDOC_Unfilled:
1.93      kristaps  754:                        dt = DISP_unfilled;
                    755:                        break;
1.210     schwarze  756:                case MDOC_Filled:
1.93      kristaps  757:                        dt = DISP_filled;
                    758:                        break;
1.210     schwarze  759:                case MDOC_Literal:
1.93      kristaps  760:                        dt = DISP_literal;
1.79      kristaps  761:                        break;
1.210     schwarze  762:                case MDOC_File:
1.239     schwarze  763:                        mandoc_msg(MANDOCERR_BD_FILE, mdoc->parse,
                    764:                            n->line, n->pos, NULL);
1.258     schwarze  765:                        break;
1.210     schwarze  766:                case MDOC_Offset:
1.227     schwarze  767:                        if (0 == argv->sz) {
                    768:                                mandoc_msg(MANDOCERR_ARG_EMPTY,
                    769:                                    mdoc->parse, argv->line,
                    770:                                    argv->pos, "Bd -offset");
1.94      kristaps  771:                                break;
                    772:                        }
1.227     schwarze  773:                        if (NULL != n->norm->Bd.offs)
                    774:                                mandoc_vmsg(MANDOCERR_ARG_REP,
                    775:                                    mdoc->parse, argv->line,
                    776:                                    argv->pos, "Bd -offset %s",
                    777:                                    argv->value[0]);
1.322     schwarze  778:                        rewrite_macro2len(mdoc, argv->value);
1.227     schwarze  779:                        n->norm->Bd.offs = argv->value[0];
1.94      kristaps  780:                        break;
1.210     schwarze  781:                case MDOC_Compact:
1.227     schwarze  782:                        if (n->norm->Bd.comp)
                    783:                                mandoc_msg(MANDOCERR_ARG_REP,
                    784:                                    mdoc->parse, argv->line,
                    785:                                    argv->pos, "Bd -compact");
                    786:                        n->norm->Bd.comp = 1;
1.94      kristaps  787:                        break;
1.1       kristaps  788:                default:
1.94      kristaps  789:                        abort();
1.1       kristaps  790:                }
1.228     schwarze  791:                if (DISP__NONE == dt)
                    792:                        continue;
1.94      kristaps  793:
1.228     schwarze  794:                if (DISP__NONE == n->norm->Bd.type)
1.147     kristaps  795:                        n->norm->Bd.type = dt;
1.228     schwarze  796:                else
1.239     schwarze  797:                        mandoc_vmsg(MANDOCERR_BD_REP,
1.228     schwarze  798:                            mdoc->parse, n->line, n->pos,
1.239     schwarze  799:                            "Bd -%s", mdoc_argnames[argv->arg]);
1.93      kristaps  800:        }
                    801:
1.147     kristaps  802:        if (DISP__NONE == n->norm->Bd.type) {
1.239     schwarze  803:                mandoc_msg(MANDOCERR_BD_NOTYPE, mdoc->parse,
                    804:                    n->line, n->pos, "Bd");
1.147     kristaps  805:                n->norm->Bd.type = DISP_ragged;
1.93      kristaps  806:        }
1.1       kristaps  807: }
                    808:
1.317     schwarze  809: /*
                    810:  * Stand-alone line macros.
                    811:  */
                    812:
1.259     schwarze  813: static void
1.299     schwarze  814: post_an_norm(POST_ARGS)
1.1       kristaps  815: {
1.299     schwarze  816:        struct roff_node *n;
1.238     schwarze  817:        struct mdoc_argv *argv;
                    818:        size_t   i;
1.1       kristaps  819:
1.299     schwarze  820:        n = mdoc->last;
1.238     schwarze  821:        if (n->args == NULL)
1.259     schwarze  822:                return;
1.210     schwarze  823:
1.238     schwarze  824:        for (i = 1; i < n->args->argc; i++) {
                    825:                argv = n->args->argv + i;
                    826:                mandoc_vmsg(MANDOCERR_AN_REP,
                    827:                    mdoc->parse, argv->line, argv->pos,
                    828:                    "An -%s", mdoc_argnames[argv->arg]);
                    829:        }
1.120     kristaps  830:
1.238     schwarze  831:        argv = n->args->argv;
                    832:        if (argv->arg == MDOC_Split)
1.147     kristaps  833:                n->norm->An.auth = AUTH_split;
1.238     schwarze  834:        else if (argv->arg == MDOC_Nosplit)
1.147     kristaps  835:                n->norm->An.auth = AUTH_nosplit;
1.107     kristaps  836:        else
                    837:                abort();
1.1       kristaps  838: }
                    839:
1.259     schwarze  840: static void
1.317     schwarze  841: post_eoln(POST_ARGS)
                    842: {
                    843:        struct roff_node        *n;
                    844:
1.328     schwarze  845:        post_useless(mdoc);
1.317     schwarze  846:        n = mdoc->last;
                    847:        if (n->child != NULL)
1.320     schwarze  848:                mandoc_vmsg(MANDOCERR_ARG_SKIP, mdoc->parse, n->line,
                    849:                    n->pos, "%s %s", roff_name[n->tok], n->child->string);
1.317     schwarze  850:
                    851:        while (n->child != NULL)
                    852:                roff_node_delete(mdoc, n->child);
                    853:
                    854:        roff_word_alloc(mdoc, n->line, n->pos, n->tok == MDOC_Bt ?
                    855:            "is currently in beta test." : "currently under development.");
                    856:        mdoc->last->flags |= NODE_EOS | NODE_NOSRC;
                    857:        mdoc->last = n;
                    858: }
                    859:
                    860: static int
                    861: build_list(struct roff_man *mdoc, int tok)
                    862: {
                    863:        struct roff_node        *n;
                    864:        int                      ic;
                    865:
                    866:        n = mdoc->last->next;
                    867:        for (ic = 1;; ic++) {
                    868:                roff_elem_alloc(mdoc, n->line, n->pos, tok);
                    869:                mdoc->last->flags |= NODE_NOSRC;
                    870:                mdoc_node_relink(mdoc, n);
                    871:                n = mdoc->last = mdoc->last->parent;
                    872:                mdoc->next = ROFF_NEXT_SIBLING;
                    873:                if (n->next == NULL)
                    874:                        return ic;
                    875:                if (ic > 1 || n->next->next != NULL) {
                    876:                        roff_word_alloc(mdoc, n->line, n->pos, ",");
                    877:                        mdoc->last->flags |= NODE_DELIMC | NODE_NOSRC;
                    878:                }
                    879:                n = mdoc->last->next;
                    880:                if (n->next == NULL) {
                    881:                        roff_word_alloc(mdoc, n->line, n->pos, "and");
                    882:                        mdoc->last->flags |= NODE_NOSRC;
                    883:                }
                    884:        }
                    885: }
                    886:
                    887: static void
                    888: post_ex(POST_ARGS)
                    889: {
                    890:        struct roff_node        *n;
                    891:        int                      ic;
                    892:
                    893:        post_std(mdoc);
                    894:
                    895:        n = mdoc->last;
                    896:        mdoc->next = ROFF_NEXT_CHILD;
                    897:        roff_word_alloc(mdoc, n->line, n->pos, "The");
                    898:        mdoc->last->flags |= NODE_NOSRC;
                    899:
                    900:        if (mdoc->last->next != NULL)
                    901:                ic = build_list(mdoc, MDOC_Nm);
                    902:        else if (mdoc->meta.name != NULL) {
                    903:                roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Nm);
                    904:                mdoc->last->flags |= NODE_NOSRC;
                    905:                roff_word_alloc(mdoc, n->line, n->pos, mdoc->meta.name);
                    906:                mdoc->last->flags |= NODE_NOSRC;
                    907:                mdoc->last = mdoc->last->parent;
                    908:                mdoc->next = ROFF_NEXT_SIBLING;
                    909:                ic = 1;
                    910:        } else {
                    911:                mandoc_msg(MANDOCERR_EX_NONAME, mdoc->parse,
                    912:                    n->line, n->pos, "Ex");
                    913:                ic = 0;
                    914:        }
                    915:
                    916:        roff_word_alloc(mdoc, n->line, n->pos,
                    917:            ic > 1 ? "utilities exit\\~0" : "utility exits\\~0");
                    918:        mdoc->last->flags |= NODE_NOSRC;
                    919:        roff_word_alloc(mdoc, n->line, n->pos,
                    920:            "on success, and\\~>0 if an error occurs.");
                    921:        mdoc->last->flags |= NODE_EOS | NODE_NOSRC;
                    922:        mdoc->last = n;
                    923: }
                    924:
                    925: static void
                    926: post_lb(POST_ARGS)
                    927: {
                    928:        struct roff_node        *n;
                    929:        const char              *p;
                    930:
1.348     schwarze  931:        post_delim_nb(mdoc);
1.333     schwarze  932:
1.317     schwarze  933:        n = mdoc->last;
                    934:        assert(n->child->type == ROFFT_TEXT);
                    935:        mdoc->next = ROFF_NEXT_CHILD;
                    936:
                    937:        if ((p = mdoc_a2lib(n->child->string)) != NULL) {
                    938:                n->child->flags |= NODE_NOPRT;
                    939:                roff_word_alloc(mdoc, n->line, n->pos, p);
                    940:                mdoc->last->flags = NODE_NOSRC;
                    941:                mdoc->last = n;
                    942:                return;
                    943:        }
1.332     schwarze  944:
                    945:        mandoc_vmsg(MANDOCERR_LB_BAD, mdoc->parse, n->child->line,
                    946:            n->child->pos, "Lb %s", n->child->string);
1.317     schwarze  947:
                    948:        roff_word_alloc(mdoc, n->line, n->pos, "library");
                    949:        mdoc->last->flags = NODE_NOSRC;
                    950:        roff_word_alloc(mdoc, n->line, n->pos, "\\(Lq");
                    951:        mdoc->last->flags = NODE_DELIMO | NODE_NOSRC;
                    952:        mdoc->last = mdoc->last->next;
                    953:        roff_word_alloc(mdoc, n->line, n->pos, "\\(Rq");
                    954:        mdoc->last->flags = NODE_DELIMC | NODE_NOSRC;
                    955:        mdoc->last = n;
                    956: }
                    957:
                    958: static void
                    959: post_rv(POST_ARGS)
                    960: {
                    961:        struct roff_node        *n;
                    962:        int                      ic;
                    963:
                    964:        post_std(mdoc);
                    965:
                    966:        n = mdoc->last;
                    967:        mdoc->next = ROFF_NEXT_CHILD;
                    968:        if (n->child != NULL) {
                    969:                roff_word_alloc(mdoc, n->line, n->pos, "The");
                    970:                mdoc->last->flags |= NODE_NOSRC;
                    971:                ic = build_list(mdoc, MDOC_Fn);
                    972:                roff_word_alloc(mdoc, n->line, n->pos,
                    973:                    ic > 1 ? "functions return" : "function returns");
                    974:                mdoc->last->flags |= NODE_NOSRC;
                    975:                roff_word_alloc(mdoc, n->line, n->pos,
                    976:                    "the value\\~0 if successful;");
                    977:        } else
                    978:                roff_word_alloc(mdoc, n->line, n->pos, "Upon successful "
                    979:                    "completion, the value\\~0 is returned;");
                    980:        mdoc->last->flags |= NODE_NOSRC;
                    981:
                    982:        roff_word_alloc(mdoc, n->line, n->pos, "otherwise "
                    983:            "the value\\~\\-1 is returned and the global variable");
                    984:        mdoc->last->flags |= NODE_NOSRC;
                    985:        roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Va);
                    986:        mdoc->last->flags |= NODE_NOSRC;
                    987:        roff_word_alloc(mdoc, n->line, n->pos, "errno");
                    988:        mdoc->last->flags |= NODE_NOSRC;
                    989:        mdoc->last = mdoc->last->parent;
                    990:        mdoc->next = ROFF_NEXT_SIBLING;
                    991:        roff_word_alloc(mdoc, n->line, n->pos,
                    992:            "is set to indicate the error.");
                    993:        mdoc->last->flags |= NODE_EOS | NODE_NOSRC;
                    994:        mdoc->last = n;
                    995: }
                    996:
                    997: static void
1.299     schwarze  998: post_std(POST_ARGS)
1.1       kristaps  999: {
1.299     schwarze 1000:        struct roff_node *n;
1.1       kristaps 1001:
1.348     schwarze 1002:        post_delim(mdoc);
                   1003:
1.299     schwarze 1004:        n = mdoc->last;
                   1005:        if (n->args && n->args->argc == 1)
                   1006:                if (n->args->argv[0].arg == MDOC_Std)
1.259     schwarze 1007:                        return;
1.133     kristaps 1008:
1.225     schwarze 1009:        mandoc_msg(MANDOCERR_ARG_STD, mdoc->parse,
1.320     schwarze 1010:            n->line, n->pos, roff_name[n->tok]);
1.1       kristaps 1011: }
                   1012:
1.259     schwarze 1013: static void
1.317     schwarze 1014: post_st(POST_ARGS)
                   1015: {
                   1016:        struct roff_node         *n, *nch;
                   1017:        const char               *p;
                   1018:
                   1019:        n = mdoc->last;
                   1020:        nch = n->child;
                   1021:        assert(nch->type == ROFFT_TEXT);
                   1022:
                   1023:        if ((p = mdoc_a2st(nch->string)) == NULL) {
                   1024:                mandoc_vmsg(MANDOCERR_ST_BAD, mdoc->parse,
                   1025:                    nch->line, nch->pos, "St %s", nch->string);
                   1026:                roff_node_delete(mdoc, n);
                   1027:                return;
                   1028:        }
                   1029:
                   1030:        nch->flags |= NODE_NOPRT;
                   1031:        mdoc->next = ROFF_NEXT_CHILD;
                   1032:        roff_word_alloc(mdoc, nch->line, nch->pos, p);
                   1033:        mdoc->last->flags |= NODE_NOSRC;
                   1034:        mdoc->last= n;
                   1035: }
                   1036:
                   1037: static void
1.299     schwarze 1038: post_obsolete(POST_ARGS)
1.218     schwarze 1039: {
1.299     schwarze 1040:        struct roff_node *n;
1.218     schwarze 1041:
1.299     schwarze 1042:        n = mdoc->last;
1.284     schwarze 1043:        if (n->type == ROFFT_ELEM || n->type == ROFFT_BLOCK)
1.218     schwarze 1044:                mandoc_msg(MANDOCERR_MACRO_OBS, mdoc->parse,
1.320     schwarze 1045:                    n->line, n->pos, roff_name[n->tok]);
1.328     schwarze 1046: }
                   1047:
                   1048: static void
                   1049: post_useless(POST_ARGS)
                   1050: {
                   1051:        struct roff_node *n;
                   1052:
                   1053:        n = mdoc->last;
                   1054:        mandoc_msg(MANDOCERR_MACRO_USELESS, mdoc->parse,
                   1055:            n->line, n->pos, roff_name[n->tok]);
1.218     schwarze 1056: }
                   1057:
1.317     schwarze 1058: /*
                   1059:  * Block macros.
                   1060:  */
                   1061:
1.259     schwarze 1062: static void
1.1       kristaps 1063: post_bf(POST_ARGS)
                   1064: {
1.285     schwarze 1065:        struct roff_node *np, *nch;
1.105     kristaps 1066:
                   1067:        /*
                   1068:         * Unlike other data pointers, these are "housed" by the HEAD
                   1069:         * element, which contains the goods.
                   1070:         */
1.1       kristaps 1071:
1.278     schwarze 1072:        np = mdoc->last;
1.284     schwarze 1073:        if (np->type != ROFFT_HEAD)
1.259     schwarze 1074:                return;
1.1       kristaps 1075:
1.284     schwarze 1076:        assert(np->parent->type == ROFFT_BLOCK);
1.297     schwarze 1077:        assert(np->parent->tok == MDOC_Bf);
1.1       kristaps 1078:
1.226     schwarze 1079:        /* Check the number of arguments. */
1.105     kristaps 1080:
1.226     schwarze 1081:        nch = np->child;
1.297     schwarze 1082:        if (np->parent->args == NULL) {
                   1083:                if (nch == NULL) {
1.239     schwarze 1084:                        mandoc_msg(MANDOCERR_BF_NOFONT, mdoc->parse,
                   1085:                            np->line, np->pos, "Bf");
1.259     schwarze 1086:                        return;
1.226     schwarze 1087:                }
                   1088:                nch = nch->next;
1.133     kristaps 1089:        }
1.297     schwarze 1090:        if (nch != NULL)
1.226     schwarze 1091:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   1092:                    nch->line, nch->pos, "Bf ... %s", nch->string);
1.105     kristaps 1093:
                   1094:        /* Extract argument into data. */
1.210     schwarze 1095:
1.297     schwarze 1096:        if (np->parent->args != NULL) {
                   1097:                switch (np->parent->args->argv[0].arg) {
                   1098:                case MDOC_Emphasis:
1.147     kristaps 1099:                        np->norm->Bf.font = FONT_Em;
1.297     schwarze 1100:                        break;
                   1101:                case MDOC_Literal:
1.147     kristaps 1102:                        np->norm->Bf.font = FONT_Li;
1.297     schwarze 1103:                        break;
                   1104:                case MDOC_Symbolic:
1.147     kristaps 1105:                        np->norm->Bf.font = FONT_Sy;
1.297     schwarze 1106:                        break;
                   1107:                default:
1.105     kristaps 1108:                        abort();
1.297     schwarze 1109:                }
1.259     schwarze 1110:                return;
1.79      kristaps 1111:        }
1.1       kristaps 1112:
1.105     kristaps 1113:        /* Extract parameter into data. */
1.1       kristaps 1114:
1.297     schwarze 1115:        if ( ! strcmp(np->child->string, "Em"))
1.147     kristaps 1116:                np->norm->Bf.font = FONT_Em;
1.297     schwarze 1117:        else if ( ! strcmp(np->child->string, "Li"))
1.147     kristaps 1118:                np->norm->Bf.font = FONT_Li;
1.297     schwarze 1119:        else if ( ! strcmp(np->child->string, "Sy"))
1.147     kristaps 1120:                np->norm->Bf.font = FONT_Sy;
1.210     schwarze 1121:        else
1.226     schwarze 1122:                mandoc_vmsg(MANDOCERR_BF_BADFONT, mdoc->parse,
                   1123:                    np->child->line, np->child->pos,
                   1124:                    "Bf %s", np->child->string);
1.1       kristaps 1125: }
                   1126:
1.259     schwarze 1127: static void
1.250     schwarze 1128: post_fname(POST_ARGS)
                   1129: {
1.285     schwarze 1130:        const struct roff_node  *n;
1.252     schwarze 1131:        const char              *cp;
                   1132:        size_t                   pos;
1.250     schwarze 1133:
                   1134:        n = mdoc->last->child;
                   1135:        pos = strcspn(n->string, "()");
1.252     schwarze 1136:        cp = n->string + pos;
                   1137:        if ( ! (cp[0] == '\0' || (cp[0] == '(' && cp[1] == '*')))
1.250     schwarze 1138:                mandoc_msg(MANDOCERR_FN_PAREN, mdoc->parse,
                   1139:                    n->line, n->pos + pos, n->string);
1.347     schwarze 1140:        if (n->sec == SEC_SYNOPSIS && mdoc->meta.msec != NULL)
                   1141:                mandoc_xr_add(mdoc->meta.msec, n->string, -1, -1);
1.250     schwarze 1142: }
                   1143:
1.259     schwarze 1144: static void
1.250     schwarze 1145: post_fn(POST_ARGS)
                   1146: {
                   1147:
                   1148:        post_fname(mdoc);
                   1149:        post_fa(mdoc);
                   1150: }
                   1151:
1.259     schwarze 1152: static void
1.242     schwarze 1153: post_fo(POST_ARGS)
                   1154: {
1.285     schwarze 1155:        const struct roff_node  *n;
1.274     schwarze 1156:
                   1157:        n = mdoc->last;
1.242     schwarze 1158:
1.284     schwarze 1159:        if (n->type != ROFFT_HEAD)
1.274     schwarze 1160:                return;
                   1161:
                   1162:        if (n->child == NULL) {
                   1163:                mandoc_msg(MANDOCERR_FO_NOHEAD, mdoc->parse,
                   1164:                    n->line, n->pos, "Fo");
                   1165:                return;
                   1166:        }
                   1167:        if (n->child != n->last) {
                   1168:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   1169:                    n->child->next->line, n->child->next->pos,
                   1170:                    "Fo ... %s", n->child->next->string);
                   1171:                while (n->child != n->last)
1.287     schwarze 1172:                        roff_node_delete(mdoc, n->last);
1.348     schwarze 1173:        } else
                   1174:                post_delim(mdoc);
1.274     schwarze 1175:
                   1176:        post_fname(mdoc);
1.249     schwarze 1177: }
                   1178:
1.259     schwarze 1179: static void
1.249     schwarze 1180: post_fa(POST_ARGS)
                   1181: {
1.285     schwarze 1182:        const struct roff_node *n;
1.249     schwarze 1183:        const char *cp;
                   1184:
                   1185:        for (n = mdoc->last->child; n != NULL; n = n->next) {
                   1186:                for (cp = n->string; *cp != '\0'; cp++) {
                   1187:                        /* Ignore callbacks and alterations. */
                   1188:                        if (*cp == '(' || *cp == '{')
                   1189:                                break;
                   1190:                        if (*cp != ',')
                   1191:                                continue;
                   1192:                        mandoc_msg(MANDOCERR_FA_COMMA, mdoc->parse,
                   1193:                            n->line, n->pos + (cp - n->string),
                   1194:                            n->string);
                   1195:                        break;
                   1196:                }
                   1197:        }
1.348     schwarze 1198:        post_delim_nb(mdoc);
1.57      kristaps 1199: }
                   1200:
1.259     schwarze 1201: static void
1.1       kristaps 1202: post_nm(POST_ARGS)
                   1203: {
1.285     schwarze 1204:        struct roff_node        *n;
1.266     schwarze 1205:
                   1206:        n = mdoc->last;
                   1207:
1.347     schwarze 1208:        if ((n->sec == SEC_NAME || n->sec == SEC_SYNOPSIS) &&
                   1209:            n->child != NULL && n->child->type == ROFFT_TEXT &&
                   1210:            mdoc->meta.msec != NULL)
                   1211:                mandoc_xr_add(mdoc->meta.msec, n->child->string, -1, -1);
                   1212:
1.266     schwarze 1213:        if (n->last != NULL &&
                   1214:            (n->last->tok == MDOC_Pp ||
                   1215:             n->last->tok == MDOC_Lp))
                   1216:                mdoc_node_relink(mdoc, n->last);
1.129     kristaps 1217:
1.311     schwarze 1218:        if (mdoc->meta.name == NULL)
                   1219:                deroff(&mdoc->meta.name, n);
1.1       kristaps 1220:
1.311     schwarze 1221:        if (mdoc->meta.name == NULL ||
                   1222:            (mdoc->lastsec == SEC_NAME && n->child == NULL))
1.239     schwarze 1223:                mandoc_msg(MANDOCERR_NM_NONAME, mdoc->parse,
1.266     schwarze 1224:                    n->line, n->pos, "Nm");
1.318     schwarze 1225:
1.348     schwarze 1226:        switch (n->type) {
                   1227:        case ROFFT_ELEM:
                   1228:                post_delim_nb(mdoc);
                   1229:                break;
                   1230:        case ROFFT_HEAD:
1.333     schwarze 1231:                post_delim(mdoc);
1.348     schwarze 1232:                break;
                   1233:        default:
                   1234:                return;
                   1235:        }
1.333     schwarze 1236:
1.348     schwarze 1237:        if ((n->child != NULL && n->child->type == ROFFT_TEXT) ||
1.318     schwarze 1238:            mdoc->meta.name == NULL)
                   1239:                return;
                   1240:
                   1241:        mdoc->next = ROFF_NEXT_CHILD;
                   1242:        roff_word_alloc(mdoc, n->line, n->pos, mdoc->meta.name);
                   1243:        mdoc->last->flags |= NODE_NOSRC;
                   1244:        mdoc->last = n;
1.1       kristaps 1245: }
                   1246:
1.259     schwarze 1247: static void
1.242     schwarze 1248: post_nd(POST_ARGS)
                   1249: {
1.285     schwarze 1250:        struct roff_node        *n;
1.267     schwarze 1251:
                   1252:        n = mdoc->last;
                   1253:
1.284     schwarze 1254:        if (n->type != ROFFT_BODY)
1.267     schwarze 1255:                return;
1.319     schwarze 1256:
                   1257:        if (n->sec != SEC_NAME)
                   1258:                mandoc_msg(MANDOCERR_ND_LATE, mdoc->parse,
                   1259:                    n->line, n->pos, "Nd");
1.267     schwarze 1260:
                   1261:        if (n->child == NULL)
                   1262:                mandoc_msg(MANDOCERR_ND_EMPTY, mdoc->parse,
                   1263:                    n->line, n->pos, "Nd");
1.348     schwarze 1264:        else
                   1265:                post_delim(mdoc);
1.242     schwarze 1266:
1.259     schwarze 1267:        post_hyph(mdoc);
1.242     schwarze 1268: }
                   1269:
1.259     schwarze 1270: static void
1.299     schwarze 1271: post_display(POST_ARGS)
1.128     kristaps 1272: {
1.299     schwarze 1273:        struct roff_node *n, *np;
1.210     schwarze 1274:
1.273     schwarze 1275:        n = mdoc->last;
1.299     schwarze 1276:        switch (n->type) {
                   1277:        case ROFFT_BODY:
1.306     schwarze 1278:                if (n->end != ENDBODY_NOT) {
1.307     schwarze 1279:                        if (n->tok == MDOC_Bd &&
                   1280:                            n->body->parent->args == NULL)
1.306     schwarze 1281:                                roff_node_delete(mdoc, n);
                   1282:                } else if (n->child == NULL)
1.299     schwarze 1283:                        mandoc_msg(MANDOCERR_BLK_EMPTY, mdoc->parse,
1.320     schwarze 1284:                            n->line, n->pos, roff_name[n->tok]);
1.299     schwarze 1285:                else if (n->tok == MDOC_D1)
                   1286:                        post_hyph(mdoc);
                   1287:                break;
                   1288:        case ROFFT_BLOCK:
                   1289:                if (n->tok == MDOC_Bd) {
1.300     schwarze 1290:                        if (n->args == NULL) {
                   1291:                                mandoc_msg(MANDOCERR_BD_NOARG,
                   1292:                                    mdoc->parse, n->line, n->pos, "Bd");
                   1293:                                mdoc->next = ROFF_NEXT_SIBLING;
                   1294:                                while (n->body->child != NULL)
                   1295:                                        mdoc_node_relink(mdoc,
                   1296:                                            n->body->child);
                   1297:                                roff_node_delete(mdoc, n);
                   1298:                                break;
                   1299:                        }
1.299     schwarze 1300:                        post_bd(mdoc);
                   1301:                        post_prevpar(mdoc);
                   1302:                }
                   1303:                for (np = n->parent; np != NULL; np = np->parent) {
                   1304:                        if (np->type == ROFFT_BLOCK && np->tok == MDOC_Bd) {
                   1305:                                mandoc_vmsg(MANDOCERR_BD_NEST,
                   1306:                                    mdoc->parse, n->line, n->pos,
1.320     schwarze 1307:                                    "%s in Bd", roff_name[n->tok]);
1.299     schwarze 1308:                                break;
                   1309:                        }
                   1310:                }
                   1311:                break;
                   1312:        default:
                   1313:                break;
                   1314:        }
1.128     kristaps 1315: }
                   1316:
1.259     schwarze 1317: static void
1.123     kristaps 1318: post_defaults(POST_ARGS)
                   1319: {
1.285     schwarze 1320:        struct roff_node *nn;
1.123     kristaps 1321:
1.333     schwarze 1322:        if (mdoc->last->child != NULL) {
1.348     schwarze 1323:                post_delim_nb(mdoc);
1.333     schwarze 1324:                return;
                   1325:        }
                   1326:
1.123     kristaps 1327:        /*
                   1328:         * The `Ar' defaults to "file ..." if no value is provided as an
1.129     kristaps 1329:         * argument; the `Mt' and `Pa' macros use "~"; the `Li' just
                   1330:         * gets an empty string.
1.123     kristaps 1331:         */
                   1332:
                   1333:        nn = mdoc->last;
                   1334:        switch (nn->tok) {
1.210     schwarze 1335:        case MDOC_Ar:
1.298     schwarze 1336:                mdoc->next = ROFF_NEXT_CHILD;
1.289     schwarze 1337:                roff_word_alloc(mdoc, nn->line, nn->pos, "file");
1.313     schwarze 1338:                mdoc->last->flags |= NODE_NOSRC;
1.289     schwarze 1339:                roff_word_alloc(mdoc, nn->line, nn->pos, "...");
1.313     schwarze 1340:                mdoc->last->flags |= NODE_NOSRC;
1.123     kristaps 1341:                break;
1.210     schwarze 1342:        case MDOC_Pa:
                   1343:        case MDOC_Mt:
1.298     schwarze 1344:                mdoc->next = ROFF_NEXT_CHILD;
1.289     schwarze 1345:                roff_word_alloc(mdoc, nn->line, nn->pos, "~");
1.313     schwarze 1346:                mdoc->last->flags |= NODE_NOSRC;
1.123     kristaps 1347:                break;
                   1348:        default:
                   1349:                abort();
1.210     schwarze 1350:        }
1.123     kristaps 1351:        mdoc->last = nn;
                   1352: }
1.1       kristaps 1353:
1.259     schwarze 1354: static void
1.1       kristaps 1355: post_at(POST_ARGS)
                   1356: {
1.316     schwarze 1357:        struct roff_node        *n, *nch;
                   1358:        const char              *att;
1.1       kristaps 1359:
1.242     schwarze 1360:        n = mdoc->last;
1.316     schwarze 1361:        nch = n->child;
1.242     schwarze 1362:
1.126     kristaps 1363:        /*
                   1364:         * If we have a child, look it up in the standard keys.  If a
                   1365:         * key exist, use that instead of the child; if it doesn't,
                   1366:         * prefix "AT&T UNIX " to the existing data.
                   1367:         */
1.210     schwarze 1368:
1.316     schwarze 1369:        att = NULL;
                   1370:        if (nch != NULL && ((att = mdoc_a2att(nch->string)) == NULL))
1.239     schwarze 1371:                mandoc_vmsg(MANDOCERR_AT_BAD, mdoc->parse,
1.316     schwarze 1372:                    nch->line, nch->pos, "At %s", nch->string);
                   1373:
                   1374:        mdoc->next = ROFF_NEXT_CHILD;
                   1375:        if (att != NULL) {
                   1376:                roff_word_alloc(mdoc, nch->line, nch->pos, att);
                   1377:                nch->flags |= NODE_NOPRT;
1.213     schwarze 1378:        } else
1.316     schwarze 1379:                roff_word_alloc(mdoc, n->line, n->pos, "AT&T UNIX");
                   1380:        mdoc->last->flags |= NODE_NOSRC;
                   1381:        mdoc->last = n;
1.1       kristaps 1382: }
                   1383:
1.259     schwarze 1384: static void
1.1       kristaps 1385: post_an(POST_ARGS)
                   1386: {
1.285     schwarze 1387:        struct roff_node *np, *nch;
1.1       kristaps 1388:
1.299     schwarze 1389:        post_an_norm(mdoc);
                   1390:
1.107     kristaps 1391:        np = mdoc->last;
1.271     schwarze 1392:        nch = np->child;
                   1393:        if (np->norm->An.auth == AUTH__NONE) {
                   1394:                if (nch == NULL)
                   1395:                        mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
                   1396:                            np->line, np->pos, "An");
1.333     schwarze 1397:                else
1.348     schwarze 1398:                        post_delim_nb(mdoc);
1.271     schwarze 1399:        } else if (nch != NULL)
1.269     schwarze 1400:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   1401:                    nch->line, nch->pos, "An ... %s", nch->string);
1.218     schwarze 1402: }
                   1403:
1.259     schwarze 1404: static void
1.218     schwarze 1405: post_en(POST_ARGS)
                   1406: {
                   1407:
1.299     schwarze 1408:        post_obsolete(mdoc);
1.284     schwarze 1409:        if (mdoc->last->type == ROFFT_BLOCK)
1.218     schwarze 1410:                mdoc->last->norm->Es = mdoc->last_es;
                   1411: }
                   1412:
1.259     schwarze 1413: static void
1.218     schwarze 1414: post_es(POST_ARGS)
                   1415: {
                   1416:
1.299     schwarze 1417:        post_obsolete(mdoc);
1.218     schwarze 1418:        mdoc->last_es = mdoc->last;
1.315     schwarze 1419: }
                   1420:
                   1421: static void
                   1422: post_xx(POST_ARGS)
                   1423: {
                   1424:        struct roff_node        *n;
                   1425:        const char              *os;
                   1426:
1.348     schwarze 1427:        post_delim_nb(mdoc);
1.333     schwarze 1428:
1.315     schwarze 1429:        n = mdoc->last;
                   1430:        switch (n->tok) {
                   1431:        case MDOC_Bsx:
                   1432:                os = "BSD/OS";
                   1433:                break;
                   1434:        case MDOC_Dx:
                   1435:                os = "DragonFly";
                   1436:                break;
                   1437:        case MDOC_Fx:
                   1438:                os = "FreeBSD";
                   1439:                break;
                   1440:        case MDOC_Nx:
                   1441:                os = "NetBSD";
                   1442:                break;
                   1443:        case MDOC_Ox:
                   1444:                os = "OpenBSD";
                   1445:                break;
                   1446:        case MDOC_Ux:
                   1447:                os = "UNIX";
                   1448:                break;
                   1449:        default:
                   1450:                abort();
                   1451:        }
                   1452:        mdoc->next = ROFF_NEXT_CHILD;
                   1453:        roff_word_alloc(mdoc, n->line, n->pos, os);
                   1454:        mdoc->last->flags |= NODE_NOSRC;
                   1455:        mdoc->last = n;
1.1       kristaps 1456: }
                   1457:
1.259     schwarze 1458: static void
1.1       kristaps 1459: post_it(POST_ARGS)
                   1460: {
1.285     schwarze 1461:        struct roff_node *nbl, *nit, *nch;
1.162     kristaps 1462:        int               i, cols;
1.89      kristaps 1463:        enum mdoc_list    lt;
1.1       kristaps 1464:
1.299     schwarze 1465:        post_prevpar(mdoc);
                   1466:
1.224     schwarze 1467:        nit = mdoc->last;
1.284     schwarze 1468:        if (nit->type != ROFFT_BLOCK)
1.259     schwarze 1469:                return;
1.1       kristaps 1470:
1.224     schwarze 1471:        nbl = nit->parent->parent;
                   1472:        lt = nbl->norm->Bl.type;
1.89      kristaps 1473:
                   1474:        switch (lt) {
1.210     schwarze 1475:        case LIST_tag:
                   1476:        case LIST_hang:
                   1477:        case LIST_ohang:
                   1478:        case LIST_inset:
                   1479:        case LIST_diag:
1.264     schwarze 1480:                if (nit->head->child == NULL)
1.239     schwarze 1481:                        mandoc_vmsg(MANDOCERR_IT_NOHEAD,
1.224     schwarze 1482:                            mdoc->parse, nit->line, nit->pos,
1.239     schwarze 1483:                            "Bl -%s It",
1.224     schwarze 1484:                            mdoc_argnames[nbl->args->argv[0].arg]);
1.1       kristaps 1485:                break;
1.210     schwarze 1486:        case LIST_bullet:
                   1487:        case LIST_dash:
                   1488:        case LIST_enum:
                   1489:        case LIST_hyphen:
1.264     schwarze 1490:                if (nit->body == NULL || nit->body->child == NULL)
1.239     schwarze 1491:                        mandoc_vmsg(MANDOCERR_IT_NOBODY,
1.225     schwarze 1492:                            mdoc->parse, nit->line, nit->pos,
1.239     schwarze 1493:                            "Bl -%s It",
1.225     schwarze 1494:                            mdoc_argnames[nbl->args->argv[0].arg]);
1.1       kristaps 1495:                /* FALLTHROUGH */
1.210     schwarze 1496:        case LIST_item:
1.304     schwarze 1497:                if ((nch = nit->head->child) != NULL)
1.320     schwarze 1498:                        mandoc_vmsg(MANDOCERR_ARG_SKIP, mdoc->parse,
                   1499:                            nit->line, nit->pos, "It %s",
                   1500:                            nch->string == NULL ? roff_name[nch->tok] :
                   1501:                            nch->string);
1.1       kristaps 1502:                break;
1.210     schwarze 1503:        case LIST_column:
1.224     schwarze 1504:                cols = (int)nbl->norm->Bl.ncols;
1.89      kristaps 1505:
1.264     schwarze 1506:                assert(nit->head->child == NULL);
1.89      kristaps 1507:
1.345     schwarze 1508:                if (nit->head->next->child == NULL &&
                   1509:                    nit->head->next->next == NULL) {
                   1510:                        mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
                   1511:                            nit->line, nit->pos, "It");
                   1512:                        roff_node_delete(mdoc, nit);
                   1513:                        break;
                   1514:                }
                   1515:
1.297     schwarze 1516:                i = 0;
1.345     schwarze 1517:                for (nch = nit->child; nch != NULL; nch = nch->next) {
                   1518:                        if (nch->type != ROFFT_BODY)
                   1519:                                continue;
                   1520:                        if (i++ && nch->flags & NODE_LINE)
                   1521:                                mandoc_msg(MANDOCERR_TA_LINE, mdoc->parse,
                   1522:                                    nch->line, nch->pos, "Ta");
                   1523:                }
1.236     schwarze 1524:                if (i < cols || i > cols + 1)
1.276     schwarze 1525:                        mandoc_vmsg(MANDOCERR_BL_COL,
1.236     schwarze 1526:                            mdoc->parse, nit->line, nit->pos,
1.276     schwarze 1527:                            "%d columns, %d cells", cols, i);
1.345     schwarze 1528:                else if (nit->head->next->child != NULL &&
                   1529:                    nit->head->next->child->line > nit->line)
                   1530:                        mandoc_msg(MANDOCERR_IT_NOARG, mdoc->parse,
                   1531:                            nit->line, nit->pos, "Bl -column It");
1.236     schwarze 1532:                break;
1.1       kristaps 1533:        default:
1.225     schwarze 1534:                abort();
1.1       kristaps 1535:        }
                   1536: }
                   1537:
1.259     schwarze 1538: static void
1.210     schwarze 1539: post_bl_block(POST_ARGS)
1.131     kristaps 1540: {
1.285     schwarze 1541:        struct roff_node *n, *ni, *nc;
1.131     kristaps 1542:
1.299     schwarze 1543:        post_prevpar(mdoc);
                   1544:
1.131     kristaps 1545:        n = mdoc->last;
1.297     schwarze 1546:        for (ni = n->body->child; ni != NULL; ni = ni->next) {
                   1547:                if (ni->body == NULL)
1.189     schwarze 1548:                        continue;
                   1549:                nc = ni->body->last;
1.297     schwarze 1550:                while (nc != NULL) {
1.189     schwarze 1551:                        switch (nc->tok) {
1.210     schwarze 1552:                        case MDOC_Pp:
                   1553:                        case MDOC_Lp:
1.323     schwarze 1554:                        case ROFF_br:
1.189     schwarze 1555:                                break;
                   1556:                        default:
                   1557:                                nc = NULL;
                   1558:                                continue;
                   1559:                        }
1.297     schwarze 1560:                        if (ni->next == NULL) {
1.219     schwarze 1561:                                mandoc_msg(MANDOCERR_PAR_MOVE,
                   1562:                                    mdoc->parse, nc->line, nc->pos,
1.320     schwarze 1563:                                    roff_name[nc->tok]);
1.259     schwarze 1564:                                mdoc_node_relink(mdoc, nc);
1.297     schwarze 1565:                        } else if (n->norm->Bl.comp == 0 &&
                   1566:                            n->norm->Bl.type != LIST_column) {
1.219     schwarze 1567:                                mandoc_vmsg(MANDOCERR_PAR_SKIP,
                   1568:                                    mdoc->parse, nc->line, nc->pos,
1.320     schwarze 1569:                                    "%s before It", roff_name[nc->tok]);
1.287     schwarze 1570:                                roff_node_delete(mdoc, nc);
1.189     schwarze 1571:                        } else
                   1572:                                break;
                   1573:                        nc = ni->body->last;
                   1574:                }
                   1575:        }
1.131     kristaps 1576: }
                   1577:
1.254     schwarze 1578: /*
                   1579:  * If the argument of -offset or -width is a macro,
                   1580:  * replace it with the associated default width.
                   1581:  */
1.322     schwarze 1582: static void
                   1583: rewrite_macro2len(struct roff_man *mdoc, char **arg)
1.131     kristaps 1584: {
                   1585:        size_t            width;
1.320     schwarze 1586:        enum roff_tok     tok;
1.131     kristaps 1587:
1.254     schwarze 1588:        if (*arg == NULL)
                   1589:                return;
                   1590:        else if ( ! strcmp(*arg, "Ds"))
1.131     kristaps 1591:                width = 6;
1.322     schwarze 1592:        else if ((tok = roffhash_find(mdoc->mdocmac, *arg, 0)) == TOKEN_NONE)
1.254     schwarze 1593:                return;
1.228     schwarze 1594:        else
                   1595:                width = macro2len(tok);
1.131     kristaps 1596:
1.254     schwarze 1597:        free(*arg);
                   1598:        mandoc_asprintf(arg, "%zun", width);
1.131     kristaps 1599: }
                   1600:
1.259     schwarze 1601: static void
1.210     schwarze 1602: post_bl_head(POST_ARGS)
1.14      kristaps 1603: {
1.285     schwarze 1604:        struct roff_node *nbl, *nh, *nch, *nnext;
1.237     schwarze 1605:        struct mdoc_argv *argv;
1.130     kristaps 1606:        int               i, j;
1.14      kristaps 1607:
1.299     schwarze 1608:        post_bl_norm(mdoc);
                   1609:
1.270     schwarze 1610:        nh = mdoc->last;
                   1611:        if (nh->norm->Bl.type != LIST_column) {
                   1612:                if ((nch = nh->child) == NULL)
                   1613:                        return;
                   1614:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   1615:                    nch->line, nch->pos, "Bl ... %s", nch->string);
                   1616:                while (nch != NULL) {
1.287     schwarze 1617:                        roff_node_delete(mdoc, nch);
1.270     schwarze 1618:                        nch = nh->child;
                   1619:                }
1.259     schwarze 1620:                return;
                   1621:        }
1.14      kristaps 1622:
1.130     kristaps 1623:        /*
1.237     schwarze 1624:         * Append old-style lists, where the column width specifiers
1.130     kristaps 1625:         * trail as macro parameters, to the new-style ("normal-form")
                   1626:         * lists where they're argument values following -column.
                   1627:         */
                   1628:
1.270     schwarze 1629:        if (nh->child == NULL)
1.259     schwarze 1630:                return;
1.130     kristaps 1631:
1.270     schwarze 1632:        nbl = nh->parent;
                   1633:        for (j = 0; j < (int)nbl->args->argc; j++)
                   1634:                if (nbl->args->argv[j].arg == MDOC_Column)
1.130     kristaps 1635:                        break;
                   1636:
1.270     schwarze 1637:        assert(j < (int)nbl->args->argc);
1.130     kristaps 1638:
                   1639:        /*
1.169     kristaps 1640:         * Accommodate for new-style groff column syntax.  Shuffle the
1.130     kristaps 1641:         * child nodes, all of which must be TEXT, as arguments for the
                   1642:         * column field.  Then, delete the head children.
                   1643:         */
                   1644:
1.270     schwarze 1645:        argv = nbl->args->argv + j;
1.237     schwarze 1646:        i = argv->sz;
1.301     schwarze 1647:        for (nch = nh->child; nch != NULL; nch = nch->next)
                   1648:                argv->sz++;
1.237     schwarze 1649:        argv->value = mandoc_reallocarray(argv->value,
                   1650:            argv->sz, sizeof(char *));
1.130     kristaps 1651:
1.270     schwarze 1652:        nh->norm->Bl.ncols = argv->sz;
                   1653:        nh->norm->Bl.cols = (void *)argv->value;
1.130     kristaps 1654:
1.270     schwarze 1655:        for (nch = nh->child; nch != NULL; nch = nnext) {
                   1656:                argv->value[i++] = nch->string;
                   1657:                nch->string = NULL;
                   1658:                nnext = nch->next;
1.287     schwarze 1659:                roff_node_delete(NULL, nch);
1.65      kristaps 1660:        }
1.270     schwarze 1661:        nh->child = NULL;
1.14      kristaps 1662: }
                   1663:
1.259     schwarze 1664: static void
1.1       kristaps 1665: post_bl(POST_ARGS)
                   1666: {
1.285     schwarze 1667:        struct roff_node        *nparent, *nprev; /* of the Bl block */
                   1668:        struct roff_node        *nblock, *nbody;  /* of the Bl */
                   1669:        struct roff_node        *nchild, *nnext;  /* of the Bl body */
1.331     schwarze 1670:        const char              *prev_Er;
                   1671:        int                      order;
1.195     schwarze 1672:
                   1673:        nbody = mdoc->last;
                   1674:        switch (nbody->type) {
1.284     schwarze 1675:        case ROFFT_BLOCK:
1.259     schwarze 1676:                post_bl_block(mdoc);
                   1677:                return;
1.284     schwarze 1678:        case ROFFT_HEAD:
1.259     schwarze 1679:                post_bl_head(mdoc);
                   1680:                return;
1.284     schwarze 1681:        case ROFFT_BODY:
1.195     schwarze 1682:                break;
                   1683:        default:
1.259     schwarze 1684:                return;
1.195     schwarze 1685:        }
1.298     schwarze 1686:        if (nbody->end != ENDBODY_NOT)
                   1687:                return;
1.1       kristaps 1688:
1.195     schwarze 1689:        nchild = nbody->child;
1.273     schwarze 1690:        if (nchild == NULL) {
1.275     schwarze 1691:                mandoc_msg(MANDOCERR_BLK_EMPTY, mdoc->parse,
1.273     schwarze 1692:                    nbody->line, nbody->pos, "Bl");
                   1693:                return;
                   1694:        }
                   1695:        while (nchild != NULL) {
1.308     schwarze 1696:                nnext = nchild->next;
1.265     schwarze 1697:                if (nchild->tok == MDOC_It ||
                   1698:                    (nchild->tok == MDOC_Sm &&
1.308     schwarze 1699:                     nnext != NULL && nnext->tok == MDOC_It)) {
                   1700:                        nchild = nnext;
                   1701:                        continue;
                   1702:                }
                   1703:
                   1704:                /*
                   1705:                 * In .Bl -column, the first rows may be implicit,
                   1706:                 * that is, they may not start with .It macros.
                   1707:                 * Such rows may be followed by nodes generated on the
                   1708:                 * roff level, for example .TS, which cannot be moved
                   1709:                 * out of the list.  In that case, wrap such roff nodes
                   1710:                 * into an implicit row.
                   1711:                 */
                   1712:
                   1713:                if (nchild->prev != NULL) {
                   1714:                        mdoc->last = nchild;
                   1715:                        mdoc->next = ROFF_NEXT_SIBLING;
                   1716:                        roff_block_alloc(mdoc, nchild->line,
                   1717:                            nchild->pos, MDOC_It);
                   1718:                        roff_head_alloc(mdoc, nchild->line,
                   1719:                            nchild->pos, MDOC_It);
                   1720:                        mdoc->next = ROFF_NEXT_SIBLING;
                   1721:                        roff_body_alloc(mdoc, nchild->line,
                   1722:                            nchild->pos, MDOC_It);
                   1723:                        while (nchild->tok != MDOC_It) {
                   1724:                                mdoc_node_relink(mdoc, nchild);
                   1725:                                if ((nchild = nnext) == NULL)
                   1726:                                        break;
                   1727:                                nnext = nchild->next;
                   1728:                                mdoc->next = ROFF_NEXT_SIBLING;
                   1729:                        }
                   1730:                        mdoc->last = nbody;
1.55      kristaps 1731:                        continue;
1.141     kristaps 1732:                }
                   1733:
1.221     schwarze 1734:                mandoc_msg(MANDOCERR_BL_MOVE, mdoc->parse,
1.320     schwarze 1735:                    nchild->line, nchild->pos, roff_name[nchild->tok]);
1.195     schwarze 1736:
                   1737:                /*
                   1738:                 * Move the node out of the Bl block.
                   1739:                 * First, collect all required node pointers.
                   1740:                 */
                   1741:
                   1742:                nblock  = nbody->parent;
                   1743:                nprev   = nblock->prev;
                   1744:                nparent = nblock->parent;
                   1745:
                   1746:                /*
                   1747:                 * Unlink this child.
                   1748:                 */
                   1749:
1.301     schwarze 1750:                nbody->child = nnext;
                   1751:                if (nnext == NULL)
1.195     schwarze 1752:                        nbody->last  = NULL;
1.301     schwarze 1753:                else
1.195     schwarze 1754:                        nnext->prev = NULL;
                   1755:
                   1756:                /*
                   1757:                 * Relink this child.
                   1758:                 */
                   1759:
                   1760:                nchild->parent = nparent;
                   1761:                nchild->prev   = nprev;
                   1762:                nchild->next   = nblock;
                   1763:
                   1764:                nblock->prev = nchild;
1.297     schwarze 1765:                if (nprev == NULL)
1.195     schwarze 1766:                        nparent->child = nchild;
                   1767:                else
                   1768:                        nprev->next = nchild;
                   1769:
                   1770:                nchild = nnext;
1.1       kristaps 1771:        }
1.331     schwarze 1772:
1.340     schwarze 1773:        if (mdoc->meta.os_e != MANDOC_OS_NETBSD)
1.331     schwarze 1774:                return;
                   1775:
                   1776:        prev_Er = NULL;
                   1777:        for (nchild = nbody->child; nchild != NULL; nchild = nchild->next) {
                   1778:                if (nchild->tok != MDOC_It)
                   1779:                        continue;
                   1780:                if ((nnext = nchild->head->child) == NULL)
                   1781:                        continue;
                   1782:                if (nnext->type == ROFFT_BLOCK)
                   1783:                        nnext = nnext->body->child;
                   1784:                if (nnext == NULL || nnext->tok != MDOC_Er)
                   1785:                        continue;
                   1786:                nnext = nnext->child;
                   1787:                if (prev_Er != NULL) {
                   1788:                        order = strcmp(prev_Er, nnext->string);
                   1789:                        if (order > 0)
                   1790:                                mandoc_vmsg(MANDOCERR_ER_ORDER,
                   1791:                                    mdoc->parse, nnext->line, nnext->pos,
1.340     schwarze 1792:                                    "Er %s %s (NetBSD)",
                   1793:                                    prev_Er, nnext->string);
1.331     schwarze 1794:                        else if (order == 0)
                   1795:                                mandoc_vmsg(MANDOCERR_ER_REP,
                   1796:                                    mdoc->parse, nnext->line, nnext->pos,
1.340     schwarze 1797:                                    "Er %s (NetBSD)", prev_Er);
1.331     schwarze 1798:                }
                   1799:                prev_Er = nnext->string;
                   1800:        }
1.1       kristaps 1801: }
                   1802:
1.259     schwarze 1803: static void
1.242     schwarze 1804: post_bk(POST_ARGS)
                   1805: {
1.285     schwarze 1806:        struct roff_node        *n;
1.242     schwarze 1807:
1.270     schwarze 1808:        n = mdoc->last;
                   1809:
1.284     schwarze 1810:        if (n->type == ROFFT_BLOCK && n->body->child == NULL) {
1.275     schwarze 1811:                mandoc_msg(MANDOCERR_BLK_EMPTY,
1.270     schwarze 1812:                    mdoc->parse, n->line, n->pos, "Bk");
1.287     schwarze 1813:                roff_node_delete(mdoc, n);
1.270     schwarze 1814:        }
1.242     schwarze 1815: }
                   1816:
1.259     schwarze 1817: static void
1.297     schwarze 1818: post_sm(POST_ARGS)
1.1       kristaps 1819: {
1.285     schwarze 1820:        struct roff_node        *nch;
1.228     schwarze 1821:
                   1822:        nch = mdoc->last->child;
1.1       kristaps 1823:
1.257     schwarze 1824:        if (nch == NULL) {
                   1825:                mdoc->flags ^= MDOC_SMOFF;
1.259     schwarze 1826:                return;
1.151     schwarze 1827:        }
1.133     kristaps 1828:
1.284     schwarze 1829:        assert(nch->type == ROFFT_TEXT);
1.1       kristaps 1830:
1.257     schwarze 1831:        if ( ! strcmp(nch->string, "on")) {
                   1832:                mdoc->flags &= ~MDOC_SMOFF;
1.259     schwarze 1833:                return;
1.197     schwarze 1834:        }
1.257     schwarze 1835:        if ( ! strcmp(nch->string, "off")) {
                   1836:                mdoc->flags |= MDOC_SMOFF;
1.259     schwarze 1837:                return;
1.197     schwarze 1838:        }
1.133     kristaps 1839:
1.228     schwarze 1840:        mandoc_vmsg(MANDOCERR_SM_BAD,
                   1841:            mdoc->parse, nch->line, nch->pos,
1.320     schwarze 1842:            "%s %s", roff_name[mdoc->last->tok], nch->string);
1.259     schwarze 1843:        mdoc_node_relink(mdoc, nch);
                   1844:        return;
1.1       kristaps 1845: }
                   1846:
1.259     schwarze 1847: static void
1.1       kristaps 1848: post_root(POST_ARGS)
                   1849: {
1.342     schwarze 1850:        const char *openbsd_arch[] = {
                   1851:                "alpha", "amd64", "arm64", "armv7", "hppa", "i386",
                   1852:                "landisk", "loongson", "luna88k", "macppc", "mips64",
                   1853:                "octeon", "sgi", "socppc", "sparc64", NULL
                   1854:        };
                   1855:        const char *netbsd_arch[] = {
                   1856:                "acorn26", "acorn32", "algor", "alpha", "amiga",
                   1857:                "arc", "atari",
                   1858:                "bebox", "cats", "cesfic", "cobalt", "dreamcast",
                   1859:                "emips", "evbarm", "evbmips", "evbppc", "evbsh3", "evbsh5",
                   1860:                "hp300", "hpcarm", "hpcmips", "hpcsh", "hppa",
                   1861:                "i386", "ibmnws", "luna68k",
                   1862:                "mac68k", "macppc", "mipsco", "mmeye", "mvme68k", "mvmeppc",
                   1863:                "netwinder", "news68k", "newsmips", "next68k",
                   1864:                "pc532", "playstation2", "pmax", "pmppc", "prep",
                   1865:                "sandpoint", "sbmips", "sgimips", "shark",
                   1866:                "sparc", "sparc64", "sun2", "sun3",
                   1867:                "vax", "walnut", "x68k", "x86", "x86_64", "xen", NULL
                   1868:         };
                   1869:        const char **arches[] = { NULL, netbsd_arch, openbsd_arch };
                   1870:
1.285     schwarze 1871:        struct roff_node *n;
1.342     schwarze 1872:        const char **arch;
1.1       kristaps 1873:
1.234     schwarze 1874:        /* Add missing prologue data. */
1.133     kristaps 1875:
1.243     schwarze 1876:        if (mdoc->meta.date == NULL)
1.337     schwarze 1877:                mdoc->meta.date = mdoc->quick ? mandoc_strdup("") :
                   1878:                    mandoc_normdate(mdoc, NULL, 0, 0);
1.243     schwarze 1879:
                   1880:        if (mdoc->meta.title == NULL) {
                   1881:                mandoc_msg(MANDOCERR_DT_NOTITLE,
                   1882:                    mdoc->parse, 0, 0, "EOF");
                   1883:                mdoc->meta.title = mandoc_strdup("UNTITLED");
                   1884:        }
                   1885:
                   1886:        if (mdoc->meta.vol == NULL)
                   1887:                mdoc->meta.vol = mandoc_strdup("LOCAL");
                   1888:
                   1889:        if (mdoc->meta.os == NULL) {
                   1890:                mandoc_msg(MANDOCERR_OS_MISSING,
                   1891:                    mdoc->parse, 0, 0, NULL);
                   1892:                mdoc->meta.os = mandoc_strdup("");
1.339     schwarze 1893:        } else if (mdoc->meta.os_e &&
                   1894:            (mdoc->meta.rcsids & (1 << mdoc->meta.os_e)) == 0)
1.340     schwarze 1895:                mandoc_msg(MANDOCERR_RCS_MISSING, mdoc->parse, 0, 0,
                   1896:                    mdoc->meta.os_e == MANDOC_OS_OPENBSD ?
                   1897:                    "(OpenBSD)" : "(NetBSD)");
1.342     schwarze 1898:
                   1899:        if (mdoc->meta.arch != NULL &&
                   1900:            (arch = arches[mdoc->meta.os_e]) != NULL) {
                   1901:                while (*arch != NULL && strcmp(*arch, mdoc->meta.arch))
                   1902:                        arch++;
                   1903:                if (*arch == NULL) {
                   1904:                        n = mdoc->first->child;
                   1905:                        while (n->tok != MDOC_Dt)
                   1906:                                n = n->next;
                   1907:                        n = n->child->next->next;
                   1908:                        mandoc_vmsg(MANDOCERR_ARCH_BAD,
                   1909:                            mdoc->parse, n->line, n->pos,
                   1910:                            "Dt ... %s %s", mdoc->meta.arch,
                   1911:                            mdoc->meta.os_e == MANDOC_OS_OPENBSD ?
                   1912:                            "(OpenBSD)" : "(NetBSD)");
                   1913:                }
                   1914:        }
1.133     kristaps 1915:
                   1916:        /* Check that we begin with a proper `Sh'. */
                   1917:
1.246     schwarze 1918:        n = mdoc->first->child;
1.290     schwarze 1919:        while (n != NULL && n->tok != TOKEN_NONE &&
                   1920:            mdoc_macros[n->tok].flags & MDOC_PROLOGUE)
1.246     schwarze 1921:                n = n->next;
                   1922:
                   1923:        if (n == NULL)
                   1924:                mandoc_msg(MANDOCERR_DOC_EMPTY, mdoc->parse, 0, 0, NULL);
                   1925:        else if (n->tok != MDOC_Sh)
1.217     schwarze 1926:                mandoc_msg(MANDOCERR_SEC_BEFORE, mdoc->parse,
1.320     schwarze 1927:                    n->line, n->pos, roff_name[n->tok]);
1.1       kristaps 1928: }
                   1929:
1.259     schwarze 1930: static void
1.43      kristaps 1931: post_rs(POST_ARGS)
                   1932: {
1.285     schwarze 1933:        struct roff_node *np, *nch, *next, *prev;
1.122     kristaps 1934:        int               i, j;
1.43      kristaps 1935:
1.268     schwarze 1936:        np = mdoc->last;
                   1937:
1.284     schwarze 1938:        if (np->type != ROFFT_BODY)
1.259     schwarze 1939:                return;
1.268     schwarze 1940:
                   1941:        if (np->child == NULL) {
                   1942:                mandoc_msg(MANDOCERR_RS_EMPTY, mdoc->parse,
                   1943:                    np->line, np->pos, "Rs");
1.259     schwarze 1944:                return;
1.151     schwarze 1945:        }
1.43      kristaps 1946:
1.122     kristaps 1947:        /*
                   1948:         * The full `Rs' block needs special handling to order the
                   1949:         * sub-elements according to `rsord'.  Pick through each element
1.230     schwarze 1950:         * and correctly order it.  This is an insertion sort.
1.122     kristaps 1951:         */
                   1952:
                   1953:        next = NULL;
1.268     schwarze 1954:        for (nch = np->child->next; nch != NULL; nch = next) {
                   1955:                /* Determine order number of this child. */
1.122     kristaps 1956:                for (i = 0; i < RSORD_MAX; i++)
1.268     schwarze 1957:                        if (rsord[i] == nch->tok)
1.122     kristaps 1958:                                break;
                   1959:
1.230     schwarze 1960:                if (i == RSORD_MAX) {
1.320     schwarze 1961:                        mandoc_msg(MANDOCERR_RS_BAD, mdoc->parse,
                   1962:                            nch->line, nch->pos, roff_name[nch->tok]);
1.230     schwarze 1963:                        i = -1;
1.268     schwarze 1964:                } else if (nch->tok == MDOC__J || nch->tok == MDOC__B)
                   1965:                        np->norm->Rs.quote_T++;
1.230     schwarze 1966:
1.210     schwarze 1967:                /*
1.268     schwarze 1968:                 * Remove this child from the chain.  This somewhat
1.287     schwarze 1969:                 * repeats roff_node_unlink(), but since we're
1.122     kristaps 1970:                 * just re-ordering, there's no need for the
                   1971:                 * full unlink process.
                   1972:                 */
1.210     schwarze 1973:
1.268     schwarze 1974:                if ((next = nch->next) != NULL)
                   1975:                        next->prev = nch->prev;
1.122     kristaps 1976:
1.268     schwarze 1977:                if ((prev = nch->prev) != NULL)
                   1978:                        prev->next = nch->next;
1.122     kristaps 1979:
1.268     schwarze 1980:                nch->prev = nch->next = NULL;
1.122     kristaps 1981:
1.210     schwarze 1982:                /*
1.122     kristaps 1983:                 * Scan back until we reach a node that's
1.268     schwarze 1984:                 * to be ordered before this child.
1.122     kristaps 1985:                 */
                   1986:
                   1987:                for ( ; prev ; prev = prev->prev) {
                   1988:                        /* Determine order of `prev'. */
                   1989:                        for (j = 0; j < RSORD_MAX; j++)
                   1990:                                if (rsord[j] == prev->tok)
                   1991:                                        break;
1.230     schwarze 1992:                        if (j == RSORD_MAX)
                   1993:                                j = -1;
1.122     kristaps 1994:
                   1995:                        if (j <= i)
                   1996:                                break;
                   1997:                }
                   1998:
                   1999:                /*
1.268     schwarze 2000:                 * Set this child back into its correct place
                   2001:                 * in front of the `prev' node.
1.122     kristaps 2002:                 */
                   2003:
1.268     schwarze 2004:                nch->prev = prev;
1.122     kristaps 2005:
1.268     schwarze 2006:                if (prev == NULL) {
                   2007:                        np->child->prev = nch;
                   2008:                        nch->next = np->child;
                   2009:                        np->child = nch;
                   2010:                } else {
1.122     kristaps 2011:                        if (prev->next)
1.268     schwarze 2012:                                prev->next->prev = nch;
                   2013:                        nch->next = prev->next;
                   2014:                        prev->next = nch;
1.43      kristaps 2015:                }
1.122     kristaps 2016:        }
1.196     schwarze 2017: }
                   2018:
                   2019: /*
                   2020:  * For some arguments of some macros,
                   2021:  * convert all breakable hyphens into ASCII_HYPH.
                   2022:  */
1.259     schwarze 2023: static void
1.196     schwarze 2024: post_hyph(POST_ARGS)
                   2025: {
1.285     schwarze 2026:        struct roff_node        *nch;
1.196     schwarze 2027:        char                    *cp;
                   2028:
1.273     schwarze 2029:        for (nch = mdoc->last->child; nch != NULL; nch = nch->next) {
1.284     schwarze 2030:                if (nch->type != ROFFT_TEXT)
1.196     schwarze 2031:                        continue;
                   2032:                cp = nch->string;
1.273     schwarze 2033:                if (*cp == '\0')
1.196     schwarze 2034:                        continue;
1.273     schwarze 2035:                while (*(++cp) != '\0')
                   2036:                        if (*cp == '-' &&
1.196     schwarze 2037:                            isalpha((unsigned char)cp[-1]) &&
                   2038:                            isalpha((unsigned char)cp[1]))
                   2039:                                *cp = ASCII_HYPH;
                   2040:        }
1.242     schwarze 2041: }
                   2042:
1.259     schwarze 2043: static void
1.155     kristaps 2044: post_ns(POST_ARGS)
                   2045: {
1.344     schwarze 2046:        struct roff_node        *n;
1.155     kristaps 2047:
1.344     schwarze 2048:        n = mdoc->last;
                   2049:        if (n->flags & NODE_LINE ||
                   2050:            (n->next != NULL && n->next->flags & NODE_DELIMC))
1.240     schwarze 2051:                mandoc_msg(MANDOCERR_NS_SKIP, mdoc->parse,
1.344     schwarze 2052:                    n->line, n->pos, NULL);
1.43      kristaps 2053: }
                   2054:
1.259     schwarze 2055: static void
1.348     schwarze 2056: post_sx(POST_ARGS)
                   2057: {
                   2058:        post_delim(mdoc);
                   2059:        post_hyph(mdoc);
                   2060: }
                   2061:
                   2062: static void
1.1       kristaps 2063: post_sh(POST_ARGS)
                   2064: {
                   2065:
1.242     schwarze 2066:        post_ignpar(mdoc);
                   2067:
1.247     schwarze 2068:        switch (mdoc->last->type) {
1.284     schwarze 2069:        case ROFFT_HEAD:
1.259     schwarze 2070:                post_sh_head(mdoc);
                   2071:                break;
1.284     schwarze 2072:        case ROFFT_BODY:
1.247     schwarze 2073:                switch (mdoc->lastsec)  {
                   2074:                case SEC_NAME:
1.259     schwarze 2075:                        post_sh_name(mdoc);
                   2076:                        break;
1.248     schwarze 2077:                case SEC_SEE_ALSO:
1.259     schwarze 2078:                        post_sh_see_also(mdoc);
                   2079:                        break;
1.247     schwarze 2080:                case SEC_AUTHORS:
1.259     schwarze 2081:                        post_sh_authors(mdoc);
                   2082:                        break;
1.247     schwarze 2083:                default:
                   2084:                        break;
                   2085:                }
                   2086:                break;
                   2087:        default:
                   2088:                break;
                   2089:        }
1.1       kristaps 2090: }
                   2091:
1.259     schwarze 2092: static void
1.247     schwarze 2093: post_sh_name(POST_ARGS)
1.1       kristaps 2094: {
1.285     schwarze 2095:        struct roff_node *n;
1.282     schwarze 2096:        int hasnm, hasnd;
1.1       kristaps 2097:
1.282     schwarze 2098:        hasnm = hasnd = 0;
1.1       kristaps 2099:
1.282     schwarze 2100:        for (n = mdoc->last->child; n != NULL; n = n->next) {
                   2101:                switch (n->tok) {
                   2102:                case MDOC_Nm:
1.311     schwarze 2103:                        if (hasnm && n->child != NULL)
                   2104:                                mandoc_vmsg(MANDOCERR_NAMESEC_PUNCT,
                   2105:                                    mdoc->parse, n->line, n->pos,
                   2106:                                    "Nm %s", n->child->string);
1.282     schwarze 2107:                        hasnm = 1;
1.311     schwarze 2108:                        continue;
1.282     schwarze 2109:                case MDOC_Nd:
                   2110:                        hasnd = 1;
                   2111:                        if (n->next != NULL)
                   2112:                                mandoc_msg(MANDOCERR_NAMESEC_ND,
                   2113:                                    mdoc->parse, n->line, n->pos, NULL);
                   2114:                        break;
1.288     schwarze 2115:                case TOKEN_NONE:
1.311     schwarze 2116:                        if (n->type == ROFFT_TEXT &&
                   2117:                            n->string[0] == ',' && n->string[1] == '\0' &&
                   2118:                            n->next != NULL && n->next->tok == MDOC_Nm) {
                   2119:                                n = n->next;
                   2120:                                continue;
                   2121:                        }
1.283     schwarze 2122:                        /* FALLTHROUGH */
1.282     schwarze 2123:                default:
                   2124:                        mandoc_msg(MANDOCERR_NAMESEC_BAD, mdoc->parse,
1.320     schwarze 2125:                            n->line, n->pos, roff_name[n->tok]);
1.311     schwarze 2126:                        continue;
1.282     schwarze 2127:                }
1.311     schwarze 2128:                break;
1.133     kristaps 2129:        }
1.1       kristaps 2130:
1.282     schwarze 2131:        if ( ! hasnm)
                   2132:                mandoc_msg(MANDOCERR_NAMESEC_NONM, mdoc->parse,
                   2133:                    mdoc->last->line, mdoc->last->pos, NULL);
                   2134:        if ( ! hasnd)
                   2135:                mandoc_msg(MANDOCERR_NAMESEC_NOND, mdoc->parse,
                   2136:                    mdoc->last->line, mdoc->last->pos, NULL);
1.248     schwarze 2137: }
                   2138:
1.259     schwarze 2139: static void
1.248     schwarze 2140: post_sh_see_also(POST_ARGS)
                   2141: {
1.285     schwarze 2142:        const struct roff_node  *n;
1.277     schwarze 2143:        const char              *name, *sec;
1.248     schwarze 2144:        const char              *lastname, *lastsec, *lastpunct;
                   2145:        int                      cmp;
                   2146:
                   2147:        n = mdoc->last->child;
                   2148:        lastname = lastsec = lastpunct = NULL;
                   2149:        while (n != NULL) {
1.301     schwarze 2150:                if (n->tok != MDOC_Xr ||
                   2151:                    n->child == NULL ||
                   2152:                    n->child->next == NULL)
1.248     schwarze 2153:                        break;
                   2154:
                   2155:                /* Process one .Xr node. */
                   2156:
                   2157:                name = n->child->string;
                   2158:                sec = n->child->next->string;
                   2159:                if (lastsec != NULL) {
                   2160:                        if (lastpunct[0] != ',' || lastpunct[1] != '\0')
                   2161:                                mandoc_vmsg(MANDOCERR_XR_PUNCT,
                   2162:                                    mdoc->parse, n->line, n->pos,
                   2163:                                    "%s before %s(%s)", lastpunct,
                   2164:                                    name, sec);
                   2165:                        cmp = strcmp(lastsec, sec);
                   2166:                        if (cmp > 0)
                   2167:                                mandoc_vmsg(MANDOCERR_XR_ORDER,
                   2168:                                    mdoc->parse, n->line, n->pos,
                   2169:                                    "%s(%s) after %s(%s)", name,
                   2170:                                    sec, lastname, lastsec);
1.253     schwarze 2171:                        else if (cmp == 0 &&
                   2172:                            strcasecmp(lastname, name) > 0)
1.248     schwarze 2173:                                mandoc_vmsg(MANDOCERR_XR_ORDER,
                   2174:                                    mdoc->parse, n->line, n->pos,
                   2175:                                    "%s after %s", name, lastname);
                   2176:                }
                   2177:                lastname = name;
                   2178:                lastsec = sec;
                   2179:
                   2180:                /* Process the following node. */
                   2181:
                   2182:                n = n->next;
                   2183:                if (n == NULL)
                   2184:                        break;
                   2185:                if (n->tok == MDOC_Xr) {
                   2186:                        lastpunct = "none";
                   2187:                        continue;
                   2188:                }
1.284     schwarze 2189:                if (n->type != ROFFT_TEXT)
1.248     schwarze 2190:                        break;
                   2191:                for (name = n->string; *name != '\0'; name++)
                   2192:                        if (isalpha((const unsigned char)*name))
1.259     schwarze 2193:                                return;
1.248     schwarze 2194:                lastpunct = n->string;
1.327     schwarze 2195:                if (n->next == NULL || n->next->tok == MDOC_Rs)
1.248     schwarze 2196:                        mandoc_vmsg(MANDOCERR_XR_PUNCT, mdoc->parse,
                   2197:                            n->line, n->pos, "%s after %s(%s)",
                   2198:                            lastpunct, lastname, lastsec);
                   2199:                n = n->next;
                   2200:        }
1.247     schwarze 2201: }
                   2202:
                   2203: static int
1.285     schwarze 2204: child_an(const struct roff_node *n)
1.247     schwarze 2205: {
                   2206:
                   2207:        for (n = n->child; n != NULL; n = n->next)
1.301     schwarze 2208:                if ((n->tok == MDOC_An && n->child != NULL) || child_an(n))
1.294     schwarze 2209:                        return 1;
                   2210:        return 0;
1.247     schwarze 2211: }
                   2212:
1.259     schwarze 2213: static void
1.247     schwarze 2214: post_sh_authors(POST_ARGS)
                   2215: {
                   2216:
                   2217:        if ( ! child_an(mdoc->last))
                   2218:                mandoc_msg(MANDOCERR_AN_MISSING, mdoc->parse,
                   2219:                    mdoc->last->line, mdoc->last->pos, NULL);
1.1       kristaps 2220: }
                   2221:
1.343     schwarze 2222: /*
                   2223:  * Return an upper bound for the string distance (allowing
                   2224:  * transpositions).  Not a full Levenshtein implementation
                   2225:  * because Levenshtein is quadratic in the string length
                   2226:  * and this function is called for every standard name,
                   2227:  * so the check for each custom name would be cubic.
                   2228:  * The following crude heuristics is linear, resulting
                   2229:  * in quadratic behaviour for checking one custom name,
                   2230:  * which does not cause measurable slowdown.
                   2231:  */
                   2232: static int
                   2233: similar(const char *s1, const char *s2)
                   2234: {
                   2235:        const int       maxdist = 3;
                   2236:        int             dist = 0;
                   2237:
                   2238:        while (s1[0] != '\0' && s2[0] != '\0') {
                   2239:                if (s1[0] == s2[0]) {
                   2240:                        s1++;
                   2241:                        s2++;
                   2242:                        continue;
                   2243:                }
                   2244:                if (++dist > maxdist)
                   2245:                        return INT_MAX;
                   2246:                if (s1[1] == s2[1]) {  /* replacement */
                   2247:                        s1++;
                   2248:                        s2++;
                   2249:                } else if (s1[0] == s2[1] && s1[1] == s2[0]) {
                   2250:                        s1 += 2;        /* transposition */
                   2251:                        s2 += 2;
                   2252:                } else if (s1[0] == s2[1])  /* insertion */
                   2253:                        s2++;
                   2254:                else if (s1[1] == s2[0])  /* deletion */
                   2255:                        s1++;
                   2256:                else
                   2257:                        return INT_MAX;
                   2258:        }
                   2259:        dist += strlen(s1) + strlen(s2);
                   2260:        return dist > maxdist ? INT_MAX : dist;
                   2261: }
                   2262:
1.259     schwarze 2263: static void
1.1       kristaps 2264: post_sh_head(POST_ARGS)
                   2265: {
1.305     schwarze 2266:        struct roff_node        *nch;
                   2267:        const char              *goodsec;
1.343     schwarze 2268:        const char *const       *testsec;
                   2269:        int                      dist, mindist;
1.305     schwarze 2270:        enum roff_sec            sec;
1.1       kristaps 2271:
                   2272:        /*
                   2273:         * Process a new section.  Sections are either "named" or
1.125     kristaps 2274:         * "custom".  Custom sections are user-defined, while named ones
                   2275:         * follow a conventional order and may only appear in certain
                   2276:         * manual sections.
1.1       kristaps 2277:         */
                   2278:
1.298     schwarze 2279:        sec = mdoc->last->sec;
1.1       kristaps 2280:
1.125     kristaps 2281:        /* The NAME should be first. */
1.1       kristaps 2282:
1.302     schwarze 2283:        if (sec != SEC_NAME && mdoc->lastnamed == SEC_NONE)
1.239     schwarze 2284:                mandoc_vmsg(MANDOCERR_NAMESEC_FIRST, mdoc->parse,
1.302     schwarze 2285:                    mdoc->last->line, mdoc->last->pos, "Sh %s",
1.305     schwarze 2286:                    sec != SEC_CUSTOM ? secnames[sec] :
                   2287:                    (nch = mdoc->last->child) == NULL ? "" :
                   2288:                    nch->type == ROFFT_TEXT ? nch->string :
1.320     schwarze 2289:                    roff_name[nch->tok]);
1.125     kristaps 2290:
                   2291:        /* The SYNOPSIS gets special attention in other areas. */
                   2292:
1.298     schwarze 2293:        if (sec == SEC_SYNOPSIS) {
1.198     schwarze 2294:                roff_setreg(mdoc->roff, "nS", 1, '=');
1.125     kristaps 2295:                mdoc->flags |= MDOC_SYNOPSIS;
1.194     schwarze 2296:        } else {
1.198     schwarze 2297:                roff_setreg(mdoc->roff, "nS", 0, '=');
1.125     kristaps 2298:                mdoc->flags &= ~MDOC_SYNOPSIS;
1.194     schwarze 2299:        }
1.125     kristaps 2300:
                   2301:        /* Mark our last section. */
                   2302:
                   2303:        mdoc->lastsec = sec;
1.181     schwarze 2304:
1.125     kristaps 2305:        /* We don't care about custom sections after this. */
1.72      kristaps 2306:
1.343     schwarze 2307:        if (sec == SEC_CUSTOM) {
                   2308:                if ((nch = mdoc->last->child) == NULL ||
                   2309:                    nch->type != ROFFT_TEXT || nch->next != NULL)
                   2310:                        return;
                   2311:                goodsec = NULL;
                   2312:                mindist = INT_MAX;
                   2313:                for (testsec = secnames + 1; *testsec != NULL; testsec++) {
                   2314:                        dist = similar(nch->string, *testsec);
                   2315:                        if (dist < mindist) {
                   2316:                                goodsec = *testsec;
                   2317:                                mindist = dist;
                   2318:                        }
                   2319:                }
                   2320:                if (goodsec != NULL)
                   2321:                        mandoc_vmsg(MANDOCERR_SEC_TYPO, mdoc->parse,
                   2322:                            nch->line, nch->pos, "Sh %s instead of %s",
                   2323:                            nch->string, goodsec);
1.259     schwarze 2324:                return;
1.343     schwarze 2325:        }
1.72      kristaps 2326:
1.125     kristaps 2327:        /*
                   2328:         * Check whether our non-custom section is being repeated or is
                   2329:         * out of order.
                   2330:         */
                   2331:
1.1       kristaps 2332:        if (sec == mdoc->lastnamed)
1.239     schwarze 2333:                mandoc_vmsg(MANDOCERR_SEC_REP, mdoc->parse,
                   2334:                    mdoc->last->line, mdoc->last->pos,
1.298     schwarze 2335:                    "Sh %s", secnames[sec]);
1.72      kristaps 2336:
1.1       kristaps 2337:        if (sec < mdoc->lastnamed)
1.239     schwarze 2338:                mandoc_vmsg(MANDOCERR_SEC_ORDER, mdoc->parse,
                   2339:                    mdoc->last->line, mdoc->last->pos,
1.298     schwarze 2340:                    "Sh %s", secnames[sec]);
1.125     kristaps 2341:
                   2342:        /* Mark the last named section. */
                   2343:
                   2344:        mdoc->lastnamed = sec;
                   2345:
                   2346:        /* Check particular section/manual conventions. */
1.1       kristaps 2347:
1.298     schwarze 2348:        if (mdoc->meta.msec == NULL)
1.259     schwarze 2349:                return;
1.1       kristaps 2350:
1.217     schwarze 2351:        goodsec = NULL;
1.1       kristaps 2352:        switch (sec) {
1.210     schwarze 2353:        case SEC_ERRORS:
1.207     schwarze 2354:                if (*mdoc->meta.msec == '4')
                   2355:                        break;
1.217     schwarze 2356:                goodsec = "2, 3, 4, 9";
1.207     schwarze 2357:                /* FALLTHROUGH */
1.210     schwarze 2358:        case SEC_RETURN_VALUES:
                   2359:        case SEC_LIBRARY:
1.78      kristaps 2360:                if (*mdoc->meta.msec == '2')
                   2361:                        break;
                   2362:                if (*mdoc->meta.msec == '3')
                   2363:                        break;
1.217     schwarze 2364:                if (NULL == goodsec)
                   2365:                        goodsec = "2, 3, 9";
1.208     schwarze 2366:                /* FALLTHROUGH */
1.210     schwarze 2367:        case SEC_CONTEXT:
1.78      kristaps 2368:                if (*mdoc->meta.msec == '9')
1.1       kristaps 2369:                        break;
1.217     schwarze 2370:                if (NULL == goodsec)
                   2371:                        goodsec = "9";
                   2372:                mandoc_vmsg(MANDOCERR_SEC_MSEC, mdoc->parse,
                   2373:                    mdoc->last->line, mdoc->last->pos,
1.298     schwarze 2374:                    "Sh %s for %s only", secnames[sec], goodsec);
1.125     kristaps 2375:                break;
1.1       kristaps 2376:        default:
                   2377:                break;
                   2378:        }
1.140     kristaps 2379: }
                   2380:
1.259     schwarze 2381: static void
1.310     schwarze 2382: post_xr(POST_ARGS)
                   2383: {
                   2384:        struct roff_node *n, *nch;
                   2385:
                   2386:        n = mdoc->last;
                   2387:        nch = n->child;
                   2388:        if (nch->next == NULL) {
                   2389:                mandoc_vmsg(MANDOCERR_XR_NOSEC, mdoc->parse,
                   2390:                    n->line, n->pos, "Xr %s", nch->string);
1.346     schwarze 2391:        } else {
1.333     schwarze 2392:                assert(nch->next == n->last);
1.347     schwarze 2393:                if(mandoc_xr_add(nch->next->string, nch->string,
                   2394:                    nch->line, nch->pos))
                   2395:                        mandoc_vmsg(MANDOCERR_XR_SELF, mdoc->parse,
                   2396:                            nch->line, nch->pos, "Xr %s %s",
                   2397:                            nch->string, nch->next->string);
1.346     schwarze 2398:        }
1.348     schwarze 2399:        post_delim_nb(mdoc);
1.310     schwarze 2400: }
                   2401:
                   2402: static void
1.140     kristaps 2403: post_ignpar(POST_ARGS)
                   2404: {
1.285     schwarze 2405:        struct roff_node *np;
1.140     kristaps 2406:
1.273     schwarze 2407:        switch (mdoc->last->type) {
1.321     schwarze 2408:        case ROFFT_BLOCK:
                   2409:                post_prevpar(mdoc);
                   2410:                return;
1.284     schwarze 2411:        case ROFFT_HEAD:
1.348     schwarze 2412:                post_delim(mdoc);
1.273     schwarze 2413:                post_hyph(mdoc);
                   2414:                return;
1.284     schwarze 2415:        case ROFFT_BODY:
1.273     schwarze 2416:                break;
                   2417:        default:
1.259     schwarze 2418:                return;
1.273     schwarze 2419:        }
1.140     kristaps 2420:
1.297     schwarze 2421:        if ((np = mdoc->last->child) != NULL)
                   2422:                if (np->tok == MDOC_Pp || np->tok == MDOC_Lp) {
1.219     schwarze 2423:                        mandoc_vmsg(MANDOCERR_PAR_SKIP,
                   2424:                            mdoc->parse, np->line, np->pos,
1.320     schwarze 2425:                            "%s after %s", roff_name[np->tok],
                   2426:                            roff_name[mdoc->last->tok]);
1.287     schwarze 2427:                        roff_node_delete(mdoc, np);
1.140     kristaps 2428:                }
                   2429:
1.297     schwarze 2430:        if ((np = mdoc->last->last) != NULL)
                   2431:                if (np->tok == MDOC_Pp || np->tok == MDOC_Lp) {
1.219     schwarze 2432:                        mandoc_vmsg(MANDOCERR_PAR_SKIP, mdoc->parse,
                   2433:                            np->line, np->pos, "%s at the end of %s",
1.320     schwarze 2434:                            roff_name[np->tok],
                   2435:                            roff_name[mdoc->last->tok]);
1.287     schwarze 2436:                        roff_node_delete(mdoc, np);
1.140     kristaps 2437:                }
1.117     kristaps 2438: }
                   2439:
1.259     schwarze 2440: static void
1.299     schwarze 2441: post_prevpar(POST_ARGS)
1.117     kristaps 2442: {
1.299     schwarze 2443:        struct roff_node *n;
1.117     kristaps 2444:
1.299     schwarze 2445:        n = mdoc->last;
                   2446:        if (NULL == n->prev)
1.259     schwarze 2447:                return;
1.284     schwarze 2448:        if (n->type != ROFFT_ELEM && n->type != ROFFT_BLOCK)
1.259     schwarze 2449:                return;
1.118     kristaps 2450:
1.210     schwarze 2451:        /*
1.124     kristaps 2452:         * Don't allow prior `Lp' or `Pp' prior to a paragraph-type
                   2453:         * block:  `Lp', `Pp', or non-compact `Bd' or `Bl'.
                   2454:         */
1.118     kristaps 2455:
1.299     schwarze 2456:        if (n->prev->tok != MDOC_Pp &&
                   2457:            n->prev->tok != MDOC_Lp &&
1.323     schwarze 2458:            n->prev->tok != ROFF_br)
1.259     schwarze 2459:                return;
1.299     schwarze 2460:        if (n->tok == MDOC_Bl && n->norm->Bl.comp)
1.259     schwarze 2461:                return;
1.299     schwarze 2462:        if (n->tok == MDOC_Bd && n->norm->Bd.comp)
1.259     schwarze 2463:                return;
1.299     schwarze 2464:        if (n->tok == MDOC_It && n->parent->norm->Bl.comp)
1.259     schwarze 2465:                return;
1.188     schwarze 2466:
1.219     schwarze 2467:        mandoc_vmsg(MANDOCERR_PAR_SKIP, mdoc->parse,
1.320     schwarze 2468:            n->prev->line, n->prev->pos, "%s before %s",
                   2469:            roff_name[n->prev->tok], roff_name[n->tok]);
1.299     schwarze 2470:        roff_node_delete(mdoc, n->prev);
1.188     schwarze 2471: }
                   2472:
1.259     schwarze 2473: static void
1.188     schwarze 2474: post_par(POST_ARGS)
                   2475: {
1.285     schwarze 2476:        struct roff_node *np;
1.188     schwarze 2477:
1.269     schwarze 2478:        np = mdoc->last;
1.326     schwarze 2479:        if (np->tok != ROFF_br && np->tok != ROFF_sp)
1.299     schwarze 2480:                post_prevpar(mdoc);
1.242     schwarze 2481:
1.326     schwarze 2482:        if (np->tok == ROFF_sp) {
1.301     schwarze 2483:                if (np->child != NULL && np->child->next != NULL)
1.269     schwarze 2484:                        mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   2485:                            np->child->next->line, np->child->next->pos,
                   2486:                            "sp ... %s", np->child->next->string);
                   2487:        } else if (np->child != NULL)
                   2488:                mandoc_vmsg(MANDOCERR_ARG_SKIP,
                   2489:                    mdoc->parse, np->line, np->pos, "%s %s",
1.320     schwarze 2490:                    roff_name[np->tok], np->child->string);
1.188     schwarze 2491:
1.297     schwarze 2492:        if ((np = mdoc->last->prev) == NULL) {
1.219     schwarze 2493:                np = mdoc->last->parent;
1.297     schwarze 2494:                if (np->tok != MDOC_Sh && np->tok != MDOC_Ss)
1.259     schwarze 2495:                        return;
1.297     schwarze 2496:        } else if (np->tok != MDOC_Pp && np->tok != MDOC_Lp &&
1.323     schwarze 2497:            (mdoc->last->tok != ROFF_br ||
1.326     schwarze 2498:             (np->tok != ROFF_sp && np->tok != ROFF_br)))
1.259     schwarze 2499:                return;
1.117     kristaps 2500:
1.219     schwarze 2501:        mandoc_vmsg(MANDOCERR_PAR_SKIP, mdoc->parse,
1.320     schwarze 2502:            mdoc->last->line, mdoc->last->pos, "%s after %s",
                   2503:            roff_name[mdoc->last->tok], roff_name[np->tok]);
1.287     schwarze 2504:        roff_node_delete(mdoc, mdoc->last);
1.128     kristaps 2505: }
                   2506:
1.259     schwarze 2507: static void
1.132     kristaps 2508: post_dd(POST_ARGS)
                   2509: {
1.285     schwarze 2510:        struct roff_node *n;
1.205     schwarze 2511:        char             *datestr;
1.132     kristaps 2512:
1.298     schwarze 2513:        n = mdoc->last;
1.313     schwarze 2514:        n->flags |= NODE_NOPRT;
                   2515:
1.298     schwarze 2516:        if (mdoc->meta.date != NULL) {
                   2517:                mandoc_msg(MANDOCERR_PROLOG_REP, mdoc->parse,
                   2518:                    n->line, n->pos, "Dd");
1.158     schwarze 2519:                free(mdoc->meta.date);
1.298     schwarze 2520:        } else if (mdoc->flags & MDOC_PBODY)
                   2521:                mandoc_msg(MANDOCERR_PROLOG_LATE, mdoc->parse,
                   2522:                    n->line, n->pos, "Dd");
                   2523:        else if (mdoc->meta.title != NULL)
                   2524:                mandoc_msg(MANDOCERR_PROLOG_ORDER, mdoc->parse,
                   2525:                    n->line, n->pos, "Dd after Dt");
                   2526:        else if (mdoc->meta.os != NULL)
                   2527:                mandoc_msg(MANDOCERR_PROLOG_ORDER, mdoc->parse,
                   2528:                    n->line, n->pos, "Dd after Os");
1.158     schwarze 2529:
1.297     schwarze 2530:        if (n->child == NULL || n->child->string[0] == '\0') {
1.200     schwarze 2531:                mdoc->meta.date = mdoc->quick ? mandoc_strdup("") :
1.337     schwarze 2532:                    mandoc_normdate(mdoc, NULL, n->line, n->pos);
1.313     schwarze 2533:                return;
1.132     kristaps 2534:        }
                   2535:
1.205     schwarze 2536:        datestr = NULL;
1.291     schwarze 2537:        deroff(&datestr, n);
1.205     schwarze 2538:        if (mdoc->quick)
                   2539:                mdoc->meta.date = datestr;
                   2540:        else {
1.337     schwarze 2541:                mdoc->meta.date = mandoc_normdate(mdoc,
1.205     schwarze 2542:                    datestr, n->line, n->pos);
                   2543:                free(datestr);
1.173     kristaps 2544:        }
1.132     kristaps 2545: }
                   2546:
1.259     schwarze 2547: static void
1.132     kristaps 2548: post_dt(POST_ARGS)
                   2549: {
1.285     schwarze 2550:        struct roff_node *nn, *n;
1.132     kristaps 2551:        const char       *cp;
                   2552:        char             *p;
                   2553:
                   2554:        n = mdoc->last;
1.313     schwarze 2555:        n->flags |= NODE_NOPRT;
                   2556:
1.298     schwarze 2557:        if (mdoc->flags & MDOC_PBODY) {
                   2558:                mandoc_msg(MANDOCERR_DT_LATE, mdoc->parse,
                   2559:                    n->line, n->pos, "Dt");
1.313     schwarze 2560:                return;
1.298     schwarze 2561:        }
                   2562:
                   2563:        if (mdoc->meta.title != NULL)
                   2564:                mandoc_msg(MANDOCERR_PROLOG_REP, mdoc->parse,
                   2565:                    n->line, n->pos, "Dt");
                   2566:        else if (mdoc->meta.os != NULL)
                   2567:                mandoc_msg(MANDOCERR_PROLOG_ORDER, mdoc->parse,
                   2568:                    n->line, n->pos, "Dt after Os");
1.132     kristaps 2569:
1.243     schwarze 2570:        free(mdoc->meta.title);
                   2571:        free(mdoc->meta.msec);
                   2572:        free(mdoc->meta.vol);
                   2573:        free(mdoc->meta.arch);
                   2574:
                   2575:        mdoc->meta.title = NULL;
                   2576:        mdoc->meta.msec = NULL;
                   2577:        mdoc->meta.vol = NULL;
                   2578:        mdoc->meta.arch = NULL;
1.132     kristaps 2579:
1.280     schwarze 2580:        /* Mandatory first argument: title. */
1.132     kristaps 2581:
1.280     schwarze 2582:        nn = n->child;
                   2583:        if (nn == NULL || *nn->string == '\0') {
1.243     schwarze 2584:                mandoc_msg(MANDOCERR_DT_NOTITLE,
                   2585:                    mdoc->parse, n->line, n->pos, "Dt");
                   2586:                mdoc->meta.title = mandoc_strdup("UNTITLED");
1.280     schwarze 2587:        } else {
                   2588:                mdoc->meta.title = mandoc_strdup(nn->string);
                   2589:
                   2590:                /* Check that all characters are uppercase. */
                   2591:
                   2592:                for (p = nn->string; *p != '\0'; p++)
                   2593:                        if (islower((unsigned char)*p)) {
                   2594:                                mandoc_vmsg(MANDOCERR_TITLE_CASE,
                   2595:                                    mdoc->parse, nn->line,
                   2596:                                    nn->pos + (p - nn->string),
                   2597:                                    "Dt %s", nn->string);
                   2598:                                break;
                   2599:                        }
1.132     kristaps 2600:        }
                   2601:
1.310     schwarze 2602:        /* Mandatory second argument: section. */
1.132     kristaps 2603:
1.280     schwarze 2604:        if (nn != NULL)
                   2605:                nn = nn->next;
1.132     kristaps 2606:
1.280     schwarze 2607:        if (nn == NULL) {
1.243     schwarze 2608:                mandoc_vmsg(MANDOCERR_MSEC_MISSING,
                   2609:                    mdoc->parse, n->line, n->pos,
                   2610:                    "Dt %s", mdoc->meta.title);
1.132     kristaps 2611:                mdoc->meta.vol = mandoc_strdup("LOCAL");
1.313     schwarze 2612:                return;  /* msec and arch remain NULL. */
1.132     kristaps 2613:        }
                   2614:
1.280     schwarze 2615:        mdoc->meta.msec = mandoc_strdup(nn->string);
                   2616:
                   2617:        /* Infer volume title from section number. */
1.132     kristaps 2618:
1.180     schwarze 2619:        cp = mandoc_a2msec(nn->string);
1.280     schwarze 2620:        if (cp == NULL) {
1.239     schwarze 2621:                mandoc_vmsg(MANDOCERR_MSEC_BAD, mdoc->parse,
                   2622:                    nn->line, nn->pos, "Dt ... %s", nn->string);
1.132     kristaps 2623:                mdoc->meta.vol = mandoc_strdup(nn->string);
1.280     schwarze 2624:        } else
                   2625:                mdoc->meta.vol = mandoc_strdup(cp);
                   2626:
                   2627:        /* Optional third argument: architecture. */
                   2628:
                   2629:        if ((nn = nn->next) == NULL)
1.313     schwarze 2630:                return;
1.280     schwarze 2631:
                   2632:        for (p = nn->string; *p != '\0'; p++)
                   2633:                *p = tolower((unsigned char)*p);
                   2634:        mdoc->meta.arch = mandoc_strdup(nn->string);
1.132     kristaps 2635:
1.280     schwarze 2636:        /* Ignore fourth and later arguments. */
1.132     kristaps 2637:
1.280     schwarze 2638:        if ((nn = nn->next) != NULL)
                   2639:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   2640:                    nn->line, nn->pos, "Dt ... %s", nn->string);
1.154     kristaps 2641: }
                   2642:
1.259     schwarze 2643: static void
1.154     kristaps 2644: post_bx(POST_ARGS)
                   2645: {
1.316     schwarze 2646:        struct roff_node        *n, *nch;
1.329     schwarze 2647:        const char              *macro;
1.333     schwarze 2648:
1.348     schwarze 2649:        post_delim_nb(mdoc);
1.316     schwarze 2650:
                   2651:        n = mdoc->last;
                   2652:        nch = n->child;
                   2653:
                   2654:        if (nch != NULL) {
1.329     schwarze 2655:                macro = !strcmp(nch->string, "Open") ? "Ox" :
                   2656:                    !strcmp(nch->string, "Net") ? "Nx" :
                   2657:                    !strcmp(nch->string, "Free") ? "Fx" :
                   2658:                    !strcmp(nch->string, "DragonFly") ? "Dx" : NULL;
                   2659:                if (macro != NULL)
                   2660:                        mandoc_msg(MANDOCERR_BX, mdoc->parse,
                   2661:                            n->line, n->pos, macro);
1.316     schwarze 2662:                mdoc->last = nch;
                   2663:                nch = nch->next;
                   2664:                mdoc->next = ROFF_NEXT_SIBLING;
                   2665:                roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Ns);
                   2666:                mdoc->last->flags |= NODE_NOSRC;
                   2667:                mdoc->next = ROFF_NEXT_SIBLING;
                   2668:        } else
                   2669:                mdoc->next = ROFF_NEXT_CHILD;
                   2670:        roff_word_alloc(mdoc, n->line, n->pos, "BSD");
                   2671:        mdoc->last->flags |= NODE_NOSRC;
                   2672:
                   2673:        if (nch == NULL) {
                   2674:                mdoc->last = n;
                   2675:                return;
                   2676:        }
                   2677:
                   2678:        roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Ns);
                   2679:        mdoc->last->flags |= NODE_NOSRC;
                   2680:        mdoc->next = ROFF_NEXT_SIBLING;
                   2681:        roff_word_alloc(mdoc, n->line, n->pos, "-");
                   2682:        mdoc->last->flags |= NODE_NOSRC;
                   2683:        roff_elem_alloc(mdoc, n->line, n->pos, MDOC_Ns);
                   2684:        mdoc->last->flags |= NODE_NOSRC;
                   2685:        mdoc->last = n;
1.154     kristaps 2686:
1.210     schwarze 2687:        /*
1.154     kristaps 2688:         * Make `Bx's second argument always start with an uppercase
                   2689:         * letter.  Groff checks if it's an "accepted" term, but we just
                   2690:         * uppercase blindly.
                   2691:         */
                   2692:
1.316     schwarze 2693:        *nch->string = (char)toupper((unsigned char)*nch->string);
1.132     kristaps 2694: }
                   2695:
1.259     schwarze 2696: static void
1.132     kristaps 2697: post_os(POST_ARGS)
                   2698: {
                   2699: #ifndef OSNAME
                   2700:        struct utsname    utsname;
1.201     schwarze 2701:        static char      *defbuf;
1.132     kristaps 2702: #endif
1.285     schwarze 2703:        struct roff_node *n;
1.132     kristaps 2704:
                   2705:        n = mdoc->last;
1.313     schwarze 2706:        n->flags |= NODE_NOPRT;
                   2707:
1.298     schwarze 2708:        if (mdoc->meta.os != NULL)
                   2709:                mandoc_msg(MANDOCERR_PROLOG_REP, mdoc->parse,
                   2710:                    n->line, n->pos, "Os");
                   2711:        else if (mdoc->flags & MDOC_PBODY)
                   2712:                mandoc_msg(MANDOCERR_PROLOG_LATE, mdoc->parse,
                   2713:                    n->line, n->pos, "Os");
1.348     schwarze 2714:
                   2715:        post_delim(mdoc);
1.132     kristaps 2716:
                   2717:        /*
1.184     schwarze 2718:         * Set the operating system by way of the `Os' macro.
                   2719:         * The order of precedence is:
                   2720:         * 1. the argument of the `Os' macro, unless empty
                   2721:         * 2. the -Ios=foo command line argument, if provided
                   2722:         * 3. -DOSNAME="\"foo\"", if provided during compilation
                   2723:         * 4. "sysname release" from uname(3)
1.210     schwarze 2724:         */
1.132     kristaps 2725:
1.184     schwarze 2726:        free(mdoc->meta.os);
1.205     schwarze 2727:        mdoc->meta.os = NULL;
1.291     schwarze 2728:        deroff(&mdoc->meta.os, n);
1.205     schwarze 2729:        if (mdoc->meta.os)
1.331     schwarze 2730:                goto out;
1.201     schwarze 2731:
1.340     schwarze 2732:        if (mdoc->os_s != NULL) {
                   2733:                mdoc->meta.os = mandoc_strdup(mdoc->os_s);
1.331     schwarze 2734:                goto out;
1.201     schwarze 2735:        }
                   2736:
1.132     kristaps 2737: #ifdef OSNAME
1.201     schwarze 2738:        mdoc->meta.os = mandoc_strdup(OSNAME);
1.132     kristaps 2739: #else /*!OSNAME */
1.297     schwarze 2740:        if (defbuf == NULL) {
                   2741:                if (uname(&utsname) == -1) {
1.233     schwarze 2742:                        mandoc_msg(MANDOCERR_OS_UNAME, mdoc->parse,
                   2743:                            n->line, n->pos, "Os");
1.210     schwarze 2744:                        defbuf = mandoc_strdup("UNKNOWN");
                   2745:                } else
1.204     schwarze 2746:                        mandoc_asprintf(&defbuf, "%s %s",
                   2747:                            utsname.sysname, utsname.release);
1.201     schwarze 2748:        }
                   2749:        mdoc->meta.os = mandoc_strdup(defbuf);
1.132     kristaps 2750: #endif /*!OSNAME*/
1.331     schwarze 2751:
1.340     schwarze 2752: out:
                   2753:        if (mdoc->meta.os_e == MANDOC_OS_OTHER) {
                   2754:                if (strstr(mdoc->meta.os, "OpenBSD") != NULL)
                   2755:                        mdoc->meta.os_e = MANDOC_OS_OPENBSD;
                   2756:                else if (strstr(mdoc->meta.os, "NetBSD") != NULL)
                   2757:                        mdoc->meta.os_e = MANDOC_OS_NETBSD;
                   2758:        }
1.337     schwarze 2759:
                   2760:        /*
                   2761:         * This is the earliest point where we can check
                   2762:         * Mdocdate conventions because we don't know
                   2763:         * the operating system earlier.
                   2764:         */
1.341     schwarze 2765:
                   2766:        if (n->child != NULL)
                   2767:                mandoc_vmsg(MANDOCERR_OS_ARG, mdoc->parse,
                   2768:                    n->child->line, n->child->pos,
                   2769:                    "Os %s (%s)", n->child->string,
                   2770:                    mdoc->meta.os_e == MANDOC_OS_OPENBSD ?
                   2771:                    "OpenBSD" : "NetBSD");
1.337     schwarze 2772:
                   2773:        while (n->tok != MDOC_Dd)
                   2774:                if ((n = n->prev) == NULL)
                   2775:                        return;
                   2776:        if ((n = n->child) == NULL)
                   2777:                return;
1.338     schwarze 2778:        if (strncmp(n->string, "$" "Mdocdate", 9)) {
1.340     schwarze 2779:                if (mdoc->meta.os_e == MANDOC_OS_OPENBSD)
1.337     schwarze 2780:                        mandoc_vmsg(MANDOCERR_MDOCDATE_MISSING,
                   2781:                            mdoc->parse, n->line, n->pos,
1.340     schwarze 2782:                            "Dd %s (OpenBSD)", n->string);
1.337     schwarze 2783:        } else {
1.340     schwarze 2784:                if (mdoc->meta.os_e == MANDOC_OS_NETBSD)
1.337     schwarze 2785:                        mandoc_vmsg(MANDOCERR_MDOCDATE,
                   2786:                            mdoc->parse, n->line, n->pos,
1.340     schwarze 2787:                            "Dd %s (NetBSD)", n->string);
1.337     schwarze 2788:        }
1.160     kristaps 2789: }
                   2790:
1.298     schwarze 2791: enum roff_sec
                   2792: mdoc_a2sec(const char *p)
1.160     kristaps 2793: {
                   2794:        int              i;
                   2795:
1.210     schwarze 2796:        for (i = 0; i < (int)SEC__MAX; i++)
1.160     kristaps 2797:                if (secnames[i] && 0 == strcmp(p, secnames[i]))
1.294     schwarze 2798:                        return (enum roff_sec)i;
1.160     kristaps 2799:
1.294     schwarze 2800:        return SEC_CUSTOM;
1.132     kristaps 2801: }
                   2802:
1.161     kristaps 2803: static size_t
1.320     schwarze 2804: macro2len(enum roff_tok macro)
1.161     kristaps 2805: {
                   2806:
                   2807:        switch (macro) {
1.210     schwarze 2808:        case MDOC_Ad:
1.294     schwarze 2809:                return 12;
1.210     schwarze 2810:        case MDOC_Ao:
1.294     schwarze 2811:                return 12;
1.210     schwarze 2812:        case MDOC_An:
1.294     schwarze 2813:                return 12;
1.210     schwarze 2814:        case MDOC_Aq:
1.294     schwarze 2815:                return 12;
1.210     schwarze 2816:        case MDOC_Ar:
1.294     schwarze 2817:                return 12;
1.210     schwarze 2818:        case MDOC_Bo:
1.294     schwarze 2819:                return 12;
1.210     schwarze 2820:        case MDOC_Bq:
1.294     schwarze 2821:                return 12;
1.210     schwarze 2822:        case MDOC_Cd:
1.294     schwarze 2823:                return 12;
1.210     schwarze 2824:        case MDOC_Cm:
1.294     schwarze 2825:                return 10;
1.210     schwarze 2826:        case MDOC_Do:
1.294     schwarze 2827:                return 10;
1.210     schwarze 2828:        case MDOC_Dq:
1.294     schwarze 2829:                return 12;
1.210     schwarze 2830:        case MDOC_Dv:
1.294     schwarze 2831:                return 12;
1.210     schwarze 2832:        case MDOC_Eo:
1.294     schwarze 2833:                return 12;
1.210     schwarze 2834:        case MDOC_Em:
1.294     schwarze 2835:                return 10;
1.210     schwarze 2836:        case MDOC_Er:
1.294     schwarze 2837:                return 17;
1.210     schwarze 2838:        case MDOC_Ev:
1.294     schwarze 2839:                return 15;
1.210     schwarze 2840:        case MDOC_Fa:
1.294     schwarze 2841:                return 12;
1.210     schwarze 2842:        case MDOC_Fl:
1.294     schwarze 2843:                return 10;
1.210     schwarze 2844:        case MDOC_Fo:
1.294     schwarze 2845:                return 16;
1.210     schwarze 2846:        case MDOC_Fn:
1.294     schwarze 2847:                return 16;
1.210     schwarze 2848:        case MDOC_Ic:
1.294     schwarze 2849:                return 10;
1.210     schwarze 2850:        case MDOC_Li:
1.294     schwarze 2851:                return 16;
1.210     schwarze 2852:        case MDOC_Ms:
1.294     schwarze 2853:                return 6;
1.210     schwarze 2854:        case MDOC_Nm:
1.294     schwarze 2855:                return 10;
1.210     schwarze 2856:        case MDOC_No:
1.294     schwarze 2857:                return 12;
1.210     schwarze 2858:        case MDOC_Oo:
1.294     schwarze 2859:                return 10;
1.210     schwarze 2860:        case MDOC_Op:
1.294     schwarze 2861:                return 14;
1.210     schwarze 2862:        case MDOC_Pa:
1.294     schwarze 2863:                return 32;
1.210     schwarze 2864:        case MDOC_Pf:
1.294     schwarze 2865:                return 12;
1.210     schwarze 2866:        case MDOC_Po:
1.294     schwarze 2867:                return 12;
1.210     schwarze 2868:        case MDOC_Pq:
1.294     schwarze 2869:                return 12;
1.210     schwarze 2870:        case MDOC_Ql:
1.294     schwarze 2871:                return 16;
1.210     schwarze 2872:        case MDOC_Qo:
1.294     schwarze 2873:                return 12;
1.210     schwarze 2874:        case MDOC_So:
1.294     schwarze 2875:                return 12;
1.210     schwarze 2876:        case MDOC_Sq:
1.294     schwarze 2877:                return 12;
1.210     schwarze 2878:        case MDOC_Sy:
1.294     schwarze 2879:                return 6;
1.210     schwarze 2880:        case MDOC_Sx:
1.294     schwarze 2881:                return 16;
1.210     schwarze 2882:        case MDOC_Tn:
1.294     schwarze 2883:                return 10;
1.210     schwarze 2884:        case MDOC_Va:
1.294     schwarze 2885:                return 12;
1.210     schwarze 2886:        case MDOC_Vt:
1.294     schwarze 2887:                return 12;
1.210     schwarze 2888:        case MDOC_Xr:
1.294     schwarze 2889:                return 10;
1.161     kristaps 2890:        default:
                   2891:                break;
                   2892:        };
1.294     schwarze 2893:        return 0;
1.161     kristaps 2894: }

CVSweb