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

Annotation of mandoc/mdoc_validate.c, Revision 1.284

1.284   ! schwarze    1: /*     $Id: mdoc_validate.c,v 1.283 2015/02/23 13:55:55 schwarze Exp $ */
1.1       kristaps    2: /*
1.183     schwarze    3:  * Copyright (c) 2008-2012 Kristaps Dzonsons <kristaps@bsd.lv>
1.266     schwarze    4:  * Copyright (c) 2010-2015 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"
        !            36: #include "roff.h"
1.165     kristaps   37: #include "mdoc.h"
1.284   ! schwarze   38: #include "libmandoc.h"
1.1       kristaps   39: #include "libmdoc.h"
                     40:
                     41: /* FIXME: .Bl -diag can't have non-text children in HEAD. */
                     42:
1.91      kristaps   43: #define        PRE_ARGS  struct mdoc *mdoc, struct mdoc_node *n
1.32      kristaps   44: #define        POST_ARGS struct mdoc *mdoc
1.1       kristaps   45:
1.120     kristaps   46: enum   check_ineq {
                     47:        CHECK_LT,
                     48:        CHECK_GT,
                     49:        CHECK_EQ
                     50: };
                     51:
1.259     schwarze   52: typedef        void    (*v_pre)(PRE_ARGS);
                     53: typedef        void    (*v_post)(POST_ARGS);
1.1       kristaps   54:
                     55: struct valids {
1.241     schwarze   56:        v_pre    pre;
1.242     schwarze   57:        v_post   post;
1.1       kristaps   58: };
                     59:
1.133     kristaps   60: static void     check_text(struct mdoc *, int, int, char *);
1.210     schwarze   61: static void     check_argv(struct mdoc *,
1.92      kristaps   62:                        struct mdoc_node *, struct mdoc_argv *);
1.133     kristaps   63: static void     check_args(struct mdoc *, struct mdoc_node *);
1.247     schwarze   64: static int      child_an(const struct mdoc_node *);
1.161     kristaps   65: static enum mdoc_sec   a2sec(const char *);
                     66: static size_t          macro2len(enum mdoct);
1.254     schwarze   67: static void     rewrite_macro2len(char **);
1.132     kristaps   68:
1.259     schwarze   69: static void     post_an(POST_ARGS);
                     70: static void     post_at(POST_ARGS);
                     71: static void     post_bf(POST_ARGS);
                     72: static void     post_bk(POST_ARGS);
                     73: static void     post_bl(POST_ARGS);
                     74: static void     post_bl_block(POST_ARGS);
                     75: static void     post_bl_block_tag(POST_ARGS);
                     76: static void     post_bl_head(POST_ARGS);
                     77: static void     post_bx(POST_ARGS);
                     78: static void     post_d1(POST_ARGS);
                     79: static void     post_defaults(POST_ARGS);
                     80: static void     post_dd(POST_ARGS);
                     81: static void     post_dt(POST_ARGS);
                     82: static void     post_en(POST_ARGS);
                     83: static void     post_es(POST_ARGS);
                     84: static void     post_eoln(POST_ARGS);
                     85: static void     post_ex(POST_ARGS);
                     86: static void     post_fa(POST_ARGS);
                     87: static void     post_fn(POST_ARGS);
                     88: static void     post_fname(POST_ARGS);
                     89: static void     post_fo(POST_ARGS);
                     90: static void     post_hyph(POST_ARGS);
                     91: static void     post_ignpar(POST_ARGS);
                     92: static void     post_it(POST_ARGS);
                     93: static void     post_lb(POST_ARGS);
                     94: static void     post_literal(POST_ARGS);
                     95: static void     post_nd(POST_ARGS);
                     96: static void     post_nm(POST_ARGS);
                     97: static void     post_ns(POST_ARGS);
                     98: static void     post_os(POST_ARGS);
                     99: static void     post_par(POST_ARGS);
                    100: static void     post_root(POST_ARGS);
                    101: static void     post_rs(POST_ARGS);
                    102: static void     post_sh(POST_ARGS);
                    103: static void     post_sh_head(POST_ARGS);
                    104: static void     post_sh_name(POST_ARGS);
                    105: static void     post_sh_see_also(POST_ARGS);
                    106: static void     post_sh_authors(POST_ARGS);
                    107: static void     post_sm(POST_ARGS);
                    108: static void     post_st(POST_ARGS);
                    109: static void     post_vt(POST_ARGS);
                    110:
                    111: static void     pre_an(PRE_ARGS);
                    112: static void     pre_bd(PRE_ARGS);
                    113: static void     pre_bl(PRE_ARGS);
                    114: static void     pre_dd(PRE_ARGS);
                    115: static void     pre_display(PRE_ARGS);
                    116: static void     pre_dt(PRE_ARGS);
                    117: static void     pre_literal(PRE_ARGS);
                    118: static void     pre_obsolete(PRE_ARGS);
                    119: static void     pre_os(PRE_ARGS);
                    120: static void     pre_par(PRE_ARGS);
                    121: static void     pre_std(PRE_ARGS);
1.32      kristaps  122:
1.163     kristaps  123: static const struct valids mdoc_valids[MDOC_MAX] = {
1.10      kristaps  124:        { NULL, NULL },                         /* Ap */
1.242     schwarze  125:        { pre_dd, post_dd },                    /* Dd */
                    126:        { pre_dt, post_dt },                    /* Dt */
                    127:        { pre_os, post_os },                    /* Os */
                    128:        { NULL, post_sh },                      /* Sh */
                    129:        { NULL, post_ignpar },                  /* Ss */
                    130:        { pre_par, post_par },                  /* Pp */
                    131:        { pre_display, post_d1 },               /* D1 */
                    132:        { pre_literal, post_literal },          /* Dl */
                    133:        { pre_bd, post_literal },               /* Bd */
1.1       kristaps  134:        { NULL, NULL },                         /* Ed */
1.242     schwarze  135:        { pre_bl, post_bl },                    /* Bl */
1.1       kristaps  136:        { NULL, NULL },                         /* El */
1.242     schwarze  137:        { pre_par, post_it },                   /* It */
1.210     schwarze  138:        { NULL, NULL },                         /* Ad */
1.242     schwarze  139:        { pre_an, post_an },                    /* An */
                    140:        { NULL, post_defaults },                /* Ar */
1.210     schwarze  141:        { NULL, NULL },                         /* Cd */
1.1       kristaps  142:        { NULL, NULL },                         /* Cm */
1.210     schwarze  143:        { NULL, NULL },                         /* Dv */
                    144:        { NULL, NULL },                         /* Er */
                    145:        { NULL, NULL },                         /* Ev */
1.242     schwarze  146:        { pre_std, post_ex },                   /* Ex */
1.249     schwarze  147:        { NULL, post_fa },                      /* Fa */
1.274     schwarze  148:        { NULL, NULL },                         /* Fd */
1.1       kristaps  149:        { NULL, NULL },                         /* Fl */
1.250     schwarze  150:        { NULL, post_fn },                      /* Fn */
1.210     schwarze  151:        { NULL, NULL },                         /* Ft */
                    152:        { NULL, NULL },                         /* Ic */
1.272     schwarze  153:        { NULL, NULL },                         /* In */
1.242     schwarze  154:        { NULL, post_defaults },                /* Li */
                    155:        { NULL, post_nd },                      /* Nd */
                    156:        { NULL, post_nm },                      /* Nm */
1.139     kristaps  157:        { NULL, NULL },                         /* Op */
1.241     schwarze  158:        { pre_obsolete, NULL },                 /* Ot */
1.242     schwarze  159:        { NULL, post_defaults },                /* Pa */
1.241     schwarze  160:        { pre_std, NULL },                      /* Rv */
1.242     schwarze  161:        { NULL, post_st },                      /* St */
1.1       kristaps  162:        { NULL, NULL },                         /* Va */
1.242     schwarze  163:        { NULL, post_vt },                      /* Vt */
1.272     schwarze  164:        { NULL, NULL },                         /* Xr */
1.275     schwarze  165:        { NULL, NULL },                         /* %A */
                    166:        { NULL, post_hyph },                    /* %B */ /* FIXME: can be used outside Rs/Re. */
                    167:        { NULL, NULL },                         /* %D */
                    168:        { NULL, NULL },                         /* %I */
                    169:        { NULL, NULL },                         /* %J */
                    170:        { NULL, post_hyph },                    /* %N */
                    171:        { NULL, post_hyph },                    /* %O */
                    172:        { NULL, NULL },                         /* %P */
                    173:        { NULL, post_hyph },                    /* %R */
                    174:        { NULL, post_hyph },                    /* %T */ /* FIXME: can be used outside Rs/Re. */
                    175:        { NULL, NULL },                         /* %V */
1.1       kristaps  176:        { NULL, NULL },                         /* Ac */
                    177:        { NULL, NULL },                         /* Ao */
1.139     kristaps  178:        { NULL, NULL },                         /* Aq */
1.242     schwarze  179:        { NULL, post_at },                      /* At */
1.1       kristaps  180:        { NULL, NULL },                         /* Bc */
1.242     schwarze  181:        { NULL, post_bf },                      /* Bf */
1.1       kristaps  182:        { NULL, NULL },                         /* Bo */
1.139     kristaps  183:        { NULL, NULL },                         /* Bq */
1.1       kristaps  184:        { NULL, NULL },                         /* Bsx */
1.242     schwarze  185:        { NULL, post_bx },                      /* Bx */
1.257     schwarze  186:        { pre_obsolete, NULL },                 /* Db */
1.1       kristaps  187:        { NULL, NULL },                         /* Dc */
                    188:        { NULL, NULL },                         /* Do */
1.139     kristaps  189:        { NULL, NULL },                         /* Dq */
1.1       kristaps  190:        { NULL, NULL },                         /* Ec */
1.210     schwarze  191:        { NULL, NULL },                         /* Ef */
                    192:        { NULL, NULL },                         /* Em */
1.1       kristaps  193:        { NULL, NULL },                         /* Eo */
                    194:        { NULL, NULL },                         /* Fx */
1.210     schwarze  195:        { NULL, NULL },                         /* Ms */
1.255     schwarze  196:        { NULL, NULL },                         /* No */
1.242     schwarze  197:        { NULL, post_ns },                      /* Ns */
1.1       kristaps  198:        { NULL, NULL },                         /* Nx */
                    199:        { NULL, NULL },                         /* Ox */
                    200:        { NULL, NULL },                         /* Pc */
1.263     schwarze  201:        { NULL, NULL },                         /* Pf */
1.1       kristaps  202:        { NULL, NULL },                         /* Po */
1.139     kristaps  203:        { NULL, NULL },                         /* Pq */
1.1       kristaps  204:        { NULL, NULL },                         /* Qc */
1.139     kristaps  205:        { NULL, NULL },                         /* Ql */
1.1       kristaps  206:        { NULL, NULL },                         /* Qo */
1.139     kristaps  207:        { NULL, NULL },                         /* Qq */
1.1       kristaps  208:        { NULL, NULL },                         /* Re */
1.242     schwarze  209:        { NULL, post_rs },                      /* Rs */
1.1       kristaps  210:        { NULL, NULL },                         /* Sc */
                    211:        { NULL, NULL },                         /* So */
1.139     kristaps  212:        { NULL, NULL },                         /* Sq */
1.257     schwarze  213:        { NULL, post_sm },                      /* Sm */
1.242     schwarze  214:        { NULL, post_hyph },                    /* Sx */
1.152     schwarze  215:        { NULL, NULL },                         /* Sy */
                    216:        { NULL, NULL },                         /* Tn */
1.1       kristaps  217:        { NULL, NULL },                         /* Ux */
                    218:        { NULL, NULL },                         /* Xc */
                    219:        { NULL, NULL },                         /* Xo */
1.242     schwarze  220:        { NULL, post_fo },                      /* Fo */
1.210     schwarze  221:        { NULL, NULL },                         /* Fc */
1.1       kristaps  222:        { NULL, NULL },                         /* Oo */
                    223:        { NULL, NULL },                         /* Oc */
1.242     schwarze  224:        { NULL, post_bk },                      /* Bk */
1.1       kristaps  225:        { NULL, NULL },                         /* Ek */
1.242     schwarze  226:        { NULL, post_eoln },                    /* Bt */
1.1       kristaps  227:        { NULL, NULL },                         /* Hf */
1.241     schwarze  228:        { pre_obsolete, NULL },                 /* Fr */
1.242     schwarze  229:        { NULL, post_eoln },                    /* Ud */
                    230:        { NULL, post_lb },                      /* Lb */
                    231:        { pre_par, post_par },                  /* Lp */
1.210     schwarze  232:        { NULL, NULL },                         /* Lk */
1.242     schwarze  233:        { NULL, post_defaults },                /* Mt */
1.210     schwarze  234:        { NULL, NULL },                         /* Brq */
                    235:        { NULL, NULL },                         /* Bro */
                    236:        { NULL, NULL },                         /* Brc */
1.275     schwarze  237:        { NULL, NULL },                         /* %C */
1.242     schwarze  238:        { pre_obsolete, post_es },              /* Es */
                    239:        { pre_obsolete, post_en },              /* En */
1.1       kristaps  240:        { NULL, NULL },                         /* Dx */
1.275     schwarze  241:        { NULL, NULL },                         /* %Q */
1.242     schwarze  242:        { NULL, post_par },                     /* br */
                    243:        { NULL, post_par },                     /* sp */
1.275     schwarze  244:        { NULL, NULL },                         /* %U */
1.88      kristaps  245:        { NULL, NULL },                         /* Ta */
1.206     schwarze  246:        { NULL, NULL },                         /* ll */
1.1       kristaps  247: };
                    248:
1.122     kristaps  249: #define        RSORD_MAX 14 /* Number of `Rs' blocks. */
                    250:
                    251: static const enum mdoct rsord[RSORD_MAX] = {
                    252:        MDOC__A,
                    253:        MDOC__T,
                    254:        MDOC__B,
                    255:        MDOC__I,
                    256:        MDOC__J,
                    257:        MDOC__R,
                    258:        MDOC__N,
                    259:        MDOC__V,
1.186     schwarze  260:        MDOC__U,
1.122     kristaps  261:        MDOC__P,
                    262:        MDOC__Q,
1.192     schwarze  263:        MDOC__C,
1.122     kristaps  264:        MDOC__D,
1.192     schwarze  265:        MDOC__O
1.122     kristaps  266: };
                    267:
1.160     kristaps  268: static const char * const secnames[SEC__MAX] = {
                    269:        NULL,
                    270:        "NAME",
                    271:        "LIBRARY",
                    272:        "SYNOPSIS",
                    273:        "DESCRIPTION",
1.208     schwarze  274:        "CONTEXT",
1.160     kristaps  275:        "IMPLEMENTATION NOTES",
                    276:        "RETURN VALUES",
                    277:        "ENVIRONMENT",
                    278:        "FILES",
                    279:        "EXIT STATUS",
                    280:        "EXAMPLES",
                    281:        "DIAGNOSTICS",
                    282:        "COMPATIBILITY",
                    283:        "ERRORS",
                    284:        "SEE ALSO",
                    285:        "STANDARDS",
                    286:        "HISTORY",
                    287:        "AUTHORS",
                    288:        "CAVEATS",
                    289:        "BUGS",
                    290:        "SECURITY CONSIDERATIONS",
                    291:        NULL
                    292: };
1.1       kristaps  293:
1.210     schwarze  294:
1.259     schwarze  295: void
1.91      kristaps  296: mdoc_valid_pre(struct mdoc *mdoc, struct mdoc_node *n)
1.1       kristaps  297: {
1.241     schwarze  298:        v_pre    p;
1.1       kristaps  299:
1.150     kristaps  300:        switch (n->type) {
1.284   ! schwarze  301:        case ROFFT_TEXT:
1.279     schwarze  302:                if (n->sec != SEC_SYNOPSIS || n->parent->tok != MDOC_Fd)
                    303:                        check_text(mdoc, n->line, n->pos, n->string);
1.150     kristaps  304:                /* FALLTHROUGH */
1.284   ! schwarze  305:        case ROFFT_TBL:
1.156     kristaps  306:                /* FALLTHROUGH */
1.284   ! schwarze  307:        case ROFFT_EQN:
1.150     kristaps  308:                /* FALLTHROUGH */
1.284   ! schwarze  309:        case ROFFT_ROOT:
1.259     schwarze  310:                return;
1.150     kristaps  311:        default:
                    312:                break;
1.1       kristaps  313:        }
                    314:
1.133     kristaps  315:        check_args(mdoc, n);
1.241     schwarze  316:        p = mdoc_valids[n->tok].pre;
1.259     schwarze  317:        if (*p)
                    318:                (*p)(mdoc, n);
1.1       kristaps  319: }
                    320:
1.259     schwarze  321: void
1.1       kristaps  322: mdoc_valid_post(struct mdoc *mdoc)
                    323: {
1.242     schwarze  324:        struct mdoc_node *n;
                    325:        v_post p;
1.1       kristaps  326:
1.242     schwarze  327:        n = mdoc->last;
                    328:        if (n->flags & MDOC_VALID)
1.259     schwarze  329:                return;
1.278     schwarze  330:        n->flags |= MDOC_VALID | MDOC_ENDED;
1.1       kristaps  331:
1.242     schwarze  332:        switch (n->type) {
1.284   ! schwarze  333:        case ROFFT_TEXT:
1.157     kristaps  334:                /* FALLTHROUGH */
1.284   ! schwarze  335:        case ROFFT_EQN:
1.150     kristaps  336:                /* FALLTHROUGH */
1.284   ! schwarze  337:        case ROFFT_TBL:
1.259     schwarze  338:                break;
1.284   ! schwarze  339:        case ROFFT_ROOT:
1.259     schwarze  340:                post_root(mdoc);
                    341:                break;
1.150     kristaps  342:        default:
1.255     schwarze  343:
                    344:                /*
                    345:                 * Closing delimiters are not special at the
                    346:                 * beginning of a block, opening delimiters
                    347:                 * are not special at the end.
                    348:                 */
                    349:
                    350:                if (n->child != NULL)
                    351:                        n->child->flags &= ~MDOC_DELIMC;
                    352:                if (n->last != NULL)
                    353:                        n->last->flags &= ~MDOC_DELIMO;
                    354:
                    355:                /* Call the macro's postprocessor. */
                    356:
1.242     schwarze  357:                p = mdoc_valids[n->tok].post;
1.259     schwarze  358:                if (*p)
                    359:                        (*p)(mdoc);
                    360:                break;
1.150     kristaps  361:        }
1.1       kristaps  362: }
                    363:
1.259     schwarze  364: static void
1.191     schwarze  365: check_args(struct mdoc *mdoc, struct mdoc_node *n)
1.1       kristaps  366: {
                    367:        int              i;
                    368:
                    369:        if (NULL == n->args)
1.133     kristaps  370:                return;
1.1       kristaps  371:
                    372:        assert(n->args->argc);
                    373:        for (i = 0; i < (int)n->args->argc; i++)
1.191     schwarze  374:                check_argv(mdoc, n, &n->args->argv[i]);
1.1       kristaps  375: }
                    376:
1.133     kristaps  377: static void
1.191     schwarze  378: check_argv(struct mdoc *mdoc, struct mdoc_node *n, struct mdoc_argv *v)
1.1       kristaps  379: {
                    380:        int              i;
                    381:
                    382:        for (i = 0; i < (int)v->sz; i++)
1.191     schwarze  383:                check_text(mdoc, v->line, v->pos, v->value[i]);
1.1       kristaps  384: }
                    385:
1.133     kristaps  386: static void
1.191     schwarze  387: check_text(struct mdoc *mdoc, int ln, int pos, char *p)
1.1       kristaps  388: {
1.172     kristaps  389:        char            *cp;
1.102     kristaps  390:
1.191     schwarze  391:        if (MDOC_LITERAL & mdoc->flags)
1.177     schwarze  392:                return;
                    393:
                    394:        for (cp = p; NULL != (p = strchr(p, '\t')); p++)
1.229     schwarze  395:                mandoc_msg(MANDOCERR_FI_TAB, mdoc->parse,
                    396:                    ln, pos + (int)(p - cp), NULL);
1.1       kristaps  397: }
                    398:
1.259     schwarze  399: static void
1.1       kristaps  400: pre_display(PRE_ARGS)
                    401: {
                    402:        struct mdoc_node *node;
                    403:
1.284   ! schwarze  404:        if (n->type != ROFFT_BLOCK)
1.259     schwarze  405:                return;
1.1       kristaps  406:
1.210     schwarze  407:        for (node = mdoc->last->parent; node; node = node->parent)
1.284   ! schwarze  408:                if (node->type == ROFFT_BLOCK)
1.1       kristaps  409:                        if (MDOC_Bd == node->tok)
                    410:                                break;
1.128     kristaps  411:
1.135     kristaps  412:        if (node)
1.220     schwarze  413:                mandoc_vmsg(MANDOCERR_BD_NEST,
                    414:                    mdoc->parse, n->line, n->pos,
                    415:                    "%s in Bd", mdoc_macronames[n->tok]);
1.1       kristaps  416: }
                    417:
1.259     schwarze  418: static void
1.1       kristaps  419: pre_bl(PRE_ARGS)
                    420: {
1.238     schwarze  421:        struct mdoc_argv *argv, *wa;
1.227     schwarze  422:        int               i;
1.238     schwarze  423:        enum mdocargt     mdoclt;
1.104     kristaps  424:        enum mdoc_list    lt;
1.1       kristaps  425:
1.284   ! schwarze  426:        if (n->type != ROFFT_BLOCK)
1.259     schwarze  427:                return;
1.1       kristaps  428:
1.210     schwarze  429:        /*
1.91      kristaps  430:         * First figure out which kind of list to use: bind ourselves to
                    431:         * the first mentioned list type and warn about any remaining
                    432:         * ones.  If we find no list type, we default to LIST_item.
                    433:         */
1.1       kristaps  434:
1.245     schwarze  435:        wa = (n->args == NULL) ? NULL : n->args->argv;
1.238     schwarze  436:        mdoclt = MDOC_ARG_MAX;
1.91      kristaps  437:        for (i = 0; n->args && i < (int)n->args->argc; i++) {
1.227     schwarze  438:                argv = n->args->argv + i;
1.91      kristaps  439:                lt = LIST__NONE;
1.227     schwarze  440:                switch (argv->arg) {
1.91      kristaps  441:                /* Set list types. */
1.210     schwarze  442:                case MDOC_Bullet:
1.91      kristaps  443:                        lt = LIST_bullet;
                    444:                        break;
1.210     schwarze  445:                case MDOC_Dash:
1.91      kristaps  446:                        lt = LIST_dash;
                    447:                        break;
1.210     schwarze  448:                case MDOC_Enum:
1.91      kristaps  449:                        lt = LIST_enum;
                    450:                        break;
1.210     schwarze  451:                case MDOC_Hyphen:
1.91      kristaps  452:                        lt = LIST_hyphen;
                    453:                        break;
1.210     schwarze  454:                case MDOC_Item:
1.91      kristaps  455:                        lt = LIST_item;
                    456:                        break;
1.210     schwarze  457:                case MDOC_Tag:
1.91      kristaps  458:                        lt = LIST_tag;
                    459:                        break;
1.210     schwarze  460:                case MDOC_Diag:
1.91      kristaps  461:                        lt = LIST_diag;
                    462:                        break;
1.210     schwarze  463:                case MDOC_Hang:
1.91      kristaps  464:                        lt = LIST_hang;
                    465:                        break;
1.210     schwarze  466:                case MDOC_Ohang:
1.91      kristaps  467:                        lt = LIST_ohang;
                    468:                        break;
1.210     schwarze  469:                case MDOC_Inset:
1.91      kristaps  470:                        lt = LIST_inset;
                    471:                        break;
1.210     schwarze  472:                case MDOC_Column:
1.91      kristaps  473:                        lt = LIST_column;
                    474:                        break;
                    475:                /* Set list arguments. */
1.210     schwarze  476:                case MDOC_Compact:
1.227     schwarze  477:                        if (n->norm->Bl.comp)
                    478:                                mandoc_msg(MANDOCERR_ARG_REP,
                    479:                                    mdoc->parse, argv->line,
                    480:                                    argv->pos, "Bl -compact");
                    481:                        n->norm->Bl.comp = 1;
1.91      kristaps  482:                        break;
1.210     schwarze  483:                case MDOC_Width:
1.238     schwarze  484:                        wa = argv;
1.227     schwarze  485:                        if (0 == argv->sz) {
                    486:                                mandoc_msg(MANDOCERR_ARG_EMPTY,
                    487:                                    mdoc->parse, argv->line,
                    488:                                    argv->pos, "Bl -width");
                    489:                                n->norm->Bl.width = "0n";
1.182     kristaps  490:                                break;
                    491:                        }
1.227     schwarze  492:                        if (NULL != n->norm->Bl.width)
                    493:                                mandoc_vmsg(MANDOCERR_ARG_REP,
                    494:                                    mdoc->parse, argv->line,
                    495:                                    argv->pos, "Bl -width %s",
                    496:                                    argv->value[0]);
1.254     schwarze  497:                        rewrite_macro2len(argv->value);
1.227     schwarze  498:                        n->norm->Bl.width = argv->value[0];
1.8       kristaps  499:                        break;
1.210     schwarze  500:                case MDOC_Offset:
1.227     schwarze  501:                        if (0 == argv->sz) {
                    502:                                mandoc_msg(MANDOCERR_ARG_EMPTY,
                    503:                                    mdoc->parse, argv->line,
                    504:                                    argv->pos, "Bl -offset");
1.98      kristaps  505:                                break;
                    506:                        }
1.227     schwarze  507:                        if (NULL != n->norm->Bl.offs)
                    508:                                mandoc_vmsg(MANDOCERR_ARG_REP,
                    509:                                    mdoc->parse, argv->line,
                    510:                                    argv->pos, "Bl -offset %s",
                    511:                                    argv->value[0]);
1.254     schwarze  512:                        rewrite_macro2len(argv->value);
1.227     schwarze  513:                        n->norm->Bl.offs = argv->value[0];
1.1       kristaps  514:                        break;
1.113     kristaps  515:                default:
                    516:                        continue;
1.1       kristaps  517:                }
1.228     schwarze  518:                if (LIST__NONE == lt)
                    519:                        continue;
1.238     schwarze  520:                mdoclt = argv->arg;
1.1       kristaps  521:
1.91      kristaps  522:                /* Check: multiple list types. */
                    523:
1.228     schwarze  524:                if (LIST__NONE != n->norm->Bl.type) {
1.239     schwarze  525:                        mandoc_vmsg(MANDOCERR_BL_REP,
1.228     schwarze  526:                            mdoc->parse, n->line, n->pos,
1.239     schwarze  527:                            "Bl -%s", mdoc_argnames[argv->arg]);
1.228     schwarze  528:                        continue;
1.109     kristaps  529:                }
1.91      kristaps  530:
                    531:                /* The list type should come first. */
                    532:
1.228     schwarze  533:                if (n->norm->Bl.width ||
                    534:                    n->norm->Bl.offs ||
                    535:                    n->norm->Bl.comp)
1.239     schwarze  536:                        mandoc_vmsg(MANDOCERR_BL_LATETYPE,
                    537:                            mdoc->parse, n->line, n->pos, "Bl -%s",
1.228     schwarze  538:                            mdoc_argnames[n->args->argv[0].arg]);
                    539:
                    540:                n->norm->Bl.type = lt;
                    541:                if (LIST_column == lt) {
                    542:                        n->norm->Bl.ncols = argv->sz;
                    543:                        n->norm->Bl.cols = (void *)argv->value;
                    544:                }
1.91      kristaps  545:        }
                    546:
                    547:        /* Allow lists to default to LIST_item. */
                    548:
1.147     kristaps  549:        if (LIST__NONE == n->norm->Bl.type) {
1.239     schwarze  550:                mandoc_msg(MANDOCERR_BL_NOTYPE, mdoc->parse,
                    551:                    n->line, n->pos, "Bl");
1.147     kristaps  552:                n->norm->Bl.type = LIST_item;
1.79      kristaps  553:        }
1.1       kristaps  554:
1.210     schwarze  555:        /*
1.8       kristaps  556:         * Validate the width field.  Some list types don't need width
                    557:         * types and should be warned about them.  Others should have it
1.185     schwarze  558:         * and must also be warned.  Yet others have a default and need
                    559:         * no warning.
1.8       kristaps  560:         */
                    561:
1.147     kristaps  562:        switch (n->norm->Bl.type) {
1.210     schwarze  563:        case LIST_tag:
1.185     schwarze  564:                if (NULL == n->norm->Bl.width)
1.239     schwarze  565:                        mandoc_msg(MANDOCERR_BL_NOWIDTH, mdoc->parse,
                    566:                            n->line, n->pos, "Bl -tag");
1.133     kristaps  567:                break;
1.210     schwarze  568:        case LIST_column:
1.1       kristaps  569:                /* FALLTHROUGH */
1.210     schwarze  570:        case LIST_diag:
1.1       kristaps  571:                /* FALLTHROUGH */
1.210     schwarze  572:        case LIST_ohang:
1.53      kristaps  573:                /* FALLTHROUGH */
1.210     schwarze  574:        case LIST_inset:
1.1       kristaps  575:                /* FALLTHROUGH */
1.210     schwarze  576:        case LIST_item:
1.147     kristaps  577:                if (n->norm->Bl.width)
1.238     schwarze  578:                        mandoc_vmsg(MANDOCERR_BL_SKIPW, mdoc->parse,
                    579:                            wa->line, wa->pos, "Bl -%s",
                    580:                            mdoc_argnames[mdoclt]);
1.185     schwarze  581:                break;
1.210     schwarze  582:        case LIST_bullet:
1.185     schwarze  583:                /* FALLTHROUGH */
1.210     schwarze  584:        case LIST_dash:
1.185     schwarze  585:                /* FALLTHROUGH */
1.210     schwarze  586:        case LIST_hyphen:
1.185     schwarze  587:                if (NULL == n->norm->Bl.width)
                    588:                        n->norm->Bl.width = "2n";
                    589:                break;
1.210     schwarze  590:        case LIST_enum:
1.185     schwarze  591:                if (NULL == n->norm->Bl.width)
                    592:                        n->norm->Bl.width = "3n";
1.133     kristaps  593:                break;
1.8       kristaps  594:        default:
                    595:                break;
                    596:        }
1.259     schwarze  597:        pre_par(mdoc, n);
1.1       kristaps  598: }
                    599:
1.259     schwarze  600: static void
1.1       kristaps  601: pre_bd(PRE_ARGS)
                    602: {
1.227     schwarze  603:        struct mdoc_argv *argv;
                    604:        int               i;
1.210     schwarze  605:        enum mdoc_disp    dt;
1.1       kristaps  606:
1.241     schwarze  607:        pre_literal(mdoc, n);
                    608:
1.284   ! schwarze  609:        if (n->type != ROFFT_BLOCK)
1.259     schwarze  610:                return;
1.1       kristaps  611:
1.93      kristaps  612:        for (i = 0; n->args && i < (int)n->args->argc; i++) {
1.227     schwarze  613:                argv = n->args->argv + i;
1.93      kristaps  614:                dt = DISP__NONE;
1.94      kristaps  615:
1.227     schwarze  616:                switch (argv->arg) {
1.210     schwarze  617:                case MDOC_Centred:
1.231     schwarze  618:                        dt = DISP_centered;
1.93      kristaps  619:                        break;
1.210     schwarze  620:                case MDOC_Ragged:
1.93      kristaps  621:                        dt = DISP_ragged;
                    622:                        break;
1.210     schwarze  623:                case MDOC_Unfilled:
1.93      kristaps  624:                        dt = DISP_unfilled;
                    625:                        break;
1.210     schwarze  626:                case MDOC_Filled:
1.93      kristaps  627:                        dt = DISP_filled;
                    628:                        break;
1.210     schwarze  629:                case MDOC_Literal:
1.93      kristaps  630:                        dt = DISP_literal;
1.79      kristaps  631:                        break;
1.210     schwarze  632:                case MDOC_File:
1.239     schwarze  633:                        mandoc_msg(MANDOCERR_BD_FILE, mdoc->parse,
                    634:                            n->line, n->pos, NULL);
1.258     schwarze  635:                        break;
1.210     schwarze  636:                case MDOC_Offset:
1.227     schwarze  637:                        if (0 == argv->sz) {
                    638:                                mandoc_msg(MANDOCERR_ARG_EMPTY,
                    639:                                    mdoc->parse, argv->line,
                    640:                                    argv->pos, "Bd -offset");
1.94      kristaps  641:                                break;
                    642:                        }
1.227     schwarze  643:                        if (NULL != n->norm->Bd.offs)
                    644:                                mandoc_vmsg(MANDOCERR_ARG_REP,
                    645:                                    mdoc->parse, argv->line,
                    646:                                    argv->pos, "Bd -offset %s",
                    647:                                    argv->value[0]);
1.254     schwarze  648:                        rewrite_macro2len(argv->value);
1.227     schwarze  649:                        n->norm->Bd.offs = argv->value[0];
1.94      kristaps  650:                        break;
1.210     schwarze  651:                case MDOC_Compact:
1.227     schwarze  652:                        if (n->norm->Bd.comp)
                    653:                                mandoc_msg(MANDOCERR_ARG_REP,
                    654:                                    mdoc->parse, argv->line,
                    655:                                    argv->pos, "Bd -compact");
                    656:                        n->norm->Bd.comp = 1;
1.94      kristaps  657:                        break;
1.1       kristaps  658:                default:
1.94      kristaps  659:                        abort();
                    660:                        /* NOTREACHED */
1.1       kristaps  661:                }
1.228     schwarze  662:                if (DISP__NONE == dt)
                    663:                        continue;
1.94      kristaps  664:
1.228     schwarze  665:                if (DISP__NONE == n->norm->Bd.type)
1.147     kristaps  666:                        n->norm->Bd.type = dt;
1.228     schwarze  667:                else
1.239     schwarze  668:                        mandoc_vmsg(MANDOCERR_BD_REP,
1.228     schwarze  669:                            mdoc->parse, n->line, n->pos,
1.239     schwarze  670:                            "Bd -%s", mdoc_argnames[argv->arg]);
1.93      kristaps  671:        }
                    672:
1.147     kristaps  673:        if (DISP__NONE == n->norm->Bd.type) {
1.239     schwarze  674:                mandoc_msg(MANDOCERR_BD_NOTYPE, mdoc->parse,
                    675:                    n->line, n->pos, "Bd");
1.147     kristaps  676:                n->norm->Bd.type = DISP_ragged;
1.93      kristaps  677:        }
1.259     schwarze  678:        pre_par(mdoc, n);
1.1       kristaps  679: }
                    680:
1.259     schwarze  681: static void
1.1       kristaps  682: pre_an(PRE_ARGS)
                    683: {
1.238     schwarze  684:        struct mdoc_argv *argv;
                    685:        size_t   i;
1.1       kristaps  686:
1.238     schwarze  687:        if (n->args == NULL)
1.259     schwarze  688:                return;
1.210     schwarze  689:
1.238     schwarze  690:        for (i = 1; i < n->args->argc; i++) {
                    691:                argv = n->args->argv + i;
                    692:                mandoc_vmsg(MANDOCERR_AN_REP,
                    693:                    mdoc->parse, argv->line, argv->pos,
                    694:                    "An -%s", mdoc_argnames[argv->arg]);
                    695:        }
1.120     kristaps  696:
1.238     schwarze  697:        argv = n->args->argv;
                    698:        if (argv->arg == MDOC_Split)
1.147     kristaps  699:                n->norm->An.auth = AUTH_split;
1.238     schwarze  700:        else if (argv->arg == MDOC_Nosplit)
1.147     kristaps  701:                n->norm->An.auth = AUTH_nosplit;
1.107     kristaps  702:        else
                    703:                abort();
1.1       kristaps  704: }
                    705:
1.259     schwarze  706: static void
1.133     kristaps  707: pre_std(PRE_ARGS)
1.1       kristaps  708: {
                    709:
1.133     kristaps  710:        if (n->args && 1 == n->args->argc)
                    711:                if (MDOC_Std == n->args->argv[0].arg)
1.259     schwarze  712:                        return;
1.133     kristaps  713:
1.225     schwarze  714:        mandoc_msg(MANDOCERR_ARG_STD, mdoc->parse,
                    715:            n->line, n->pos, mdoc_macronames[n->tok]);
1.1       kristaps  716: }
                    717:
1.259     schwarze  718: static void
1.218     schwarze  719: pre_obsolete(PRE_ARGS)
                    720: {
                    721:
1.284   ! schwarze  722:        if (n->type == ROFFT_ELEM || n->type == ROFFT_BLOCK)
1.218     schwarze  723:                mandoc_msg(MANDOCERR_MACRO_OBS, mdoc->parse,
                    724:                    n->line, n->pos, mdoc_macronames[n->tok]);
                    725: }
                    726:
1.259     schwarze  727: static void
1.1       kristaps  728: pre_dt(PRE_ARGS)
                    729: {
1.54      kristaps  730:
1.243     schwarze  731:        if (mdoc->meta.title != NULL)
1.217     schwarze  732:                mandoc_msg(MANDOCERR_PROLOG_REP, mdoc->parse,
                    733:                    n->line, n->pos, "Dt");
1.243     schwarze  734:        else if (mdoc->meta.os != NULL)
                    735:                mandoc_msg(MANDOCERR_PROLOG_ORDER, mdoc->parse,
                    736:                    n->line, n->pos, "Dt after Os");
1.1       kristaps  737: }
                    738:
1.259     schwarze  739: static void
1.1       kristaps  740: pre_os(PRE_ARGS)
                    741: {
                    742:
1.243     schwarze  743:        if (mdoc->meta.os != NULL)
                    744:                mandoc_msg(MANDOCERR_PROLOG_REP, mdoc->parse,
1.217     schwarze  745:                    n->line, n->pos, "Os");
1.243     schwarze  746:        else if (mdoc->flags & MDOC_PBODY)
                    747:                mandoc_msg(MANDOCERR_PROLOG_LATE, mdoc->parse,
1.217     schwarze  748:                    n->line, n->pos, "Os");
1.1       kristaps  749: }
                    750:
1.259     schwarze  751: static void
1.1       kristaps  752: pre_dd(PRE_ARGS)
                    753: {
                    754:
1.243     schwarze  755:        if (mdoc->meta.date != NULL)
                    756:                mandoc_msg(MANDOCERR_PROLOG_REP, mdoc->parse,
1.217     schwarze  757:                    n->line, n->pos, "Dd");
1.243     schwarze  758:        else if (mdoc->flags & MDOC_PBODY)
                    759:                mandoc_msg(MANDOCERR_PROLOG_LATE, mdoc->parse,
1.217     schwarze  760:                    n->line, n->pos, "Dd");
1.243     schwarze  761:        else if (mdoc->meta.title != NULL)
                    762:                mandoc_msg(MANDOCERR_PROLOG_ORDER, mdoc->parse,
                    763:                    n->line, n->pos, "Dd after Dt");
                    764:        else if (mdoc->meta.os != NULL)
                    765:                mandoc_msg(MANDOCERR_PROLOG_ORDER, mdoc->parse,
                    766:                    n->line, n->pos, "Dd after Os");
1.1       kristaps  767: }
                    768:
1.259     schwarze  769: static void
1.1       kristaps  770: post_bf(POST_ARGS)
                    771: {
1.226     schwarze  772:        struct mdoc_node *np, *nch;
1.113     kristaps  773:        enum mdocargt     arg;
1.105     kristaps  774:
                    775:        /*
                    776:         * Unlike other data pointers, these are "housed" by the HEAD
                    777:         * element, which contains the goods.
                    778:         */
1.1       kristaps  779:
1.278     schwarze  780:        np = mdoc->last;
1.284   ! schwarze  781:        if (np->type != ROFFT_HEAD)
1.259     schwarze  782:                return;
1.1       kristaps  783:
1.284   ! schwarze  784:        assert(np->parent->type == ROFFT_BLOCK);
1.106     kristaps  785:        assert(MDOC_Bf == np->parent->tok);
1.1       kristaps  786:
1.226     schwarze  787:        /* Check the number of arguments. */
1.105     kristaps  788:
1.226     schwarze  789:        nch = np->child;
                    790:        if (NULL == np->parent->args) {
                    791:                if (NULL == nch) {
1.239     schwarze  792:                        mandoc_msg(MANDOCERR_BF_NOFONT, mdoc->parse,
                    793:                            np->line, np->pos, "Bf");
1.259     schwarze  794:                        return;
1.226     schwarze  795:                }
                    796:                nch = nch->next;
1.133     kristaps  797:        }
1.226     schwarze  798:        if (NULL != nch)
                    799:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                    800:                    nch->line, nch->pos, "Bf ... %s", nch->string);
1.105     kristaps  801:
                    802:        /* Extract argument into data. */
1.210     schwarze  803:
1.106     kristaps  804:        if (np->parent->args) {
                    805:                arg = np->parent->args->argv[0].arg;
1.105     kristaps  806:                if (MDOC_Emphasis == arg)
1.147     kristaps  807:                        np->norm->Bf.font = FONT_Em;
1.105     kristaps  808:                else if (MDOC_Literal == arg)
1.147     kristaps  809:                        np->norm->Bf.font = FONT_Li;
1.105     kristaps  810:                else if (MDOC_Symbolic == arg)
1.147     kristaps  811:                        np->norm->Bf.font = FONT_Sy;
1.105     kristaps  812:                else
                    813:                        abort();
1.259     schwarze  814:                return;
1.79      kristaps  815:        }
1.1       kristaps  816:
1.105     kristaps  817:        /* Extract parameter into data. */
1.1       kristaps  818:
1.105     kristaps  819:        if (0 == strcmp(np->child->string, "Em"))
1.147     kristaps  820:                np->norm->Bf.font = FONT_Em;
1.105     kristaps  821:        else if (0 == strcmp(np->child->string, "Li"))
1.147     kristaps  822:                np->norm->Bf.font = FONT_Li;
1.105     kristaps  823:        else if (0 == strcmp(np->child->string, "Sy"))
1.147     kristaps  824:                np->norm->Bf.font = FONT_Sy;
1.210     schwarze  825:        else
1.226     schwarze  826:                mandoc_vmsg(MANDOCERR_BF_BADFONT, mdoc->parse,
                    827:                    np->child->line, np->child->pos,
                    828:                    "Bf %s", np->child->string);
1.1       kristaps  829: }
                    830:
1.259     schwarze  831: static void
1.31      kristaps  832: post_lb(POST_ARGS)
                    833: {
1.212     schwarze  834:        struct mdoc_node        *n;
                    835:        const char              *stdlibname;
                    836:        char                    *libname;
1.127     kristaps  837:
1.212     schwarze  838:        n = mdoc->last->child;
1.284   ! schwarze  839:        assert(n->type == ROFFT_TEXT);
1.127     kristaps  840:
1.212     schwarze  841:        if (NULL == (stdlibname = mdoc_a2lib(n->string)))
                    842:                mandoc_asprintf(&libname,
1.281     schwarze  843:                    "library \\(Lq%s\\(Rq", n->string);
1.212     schwarze  844:        else
                    845:                libname = mandoc_strdup(stdlibname);
1.127     kristaps  846:
1.212     schwarze  847:        free(n->string);
                    848:        n->string = libname;
1.84      kristaps  849: }
                    850:
1.259     schwarze  851: static void
1.84      kristaps  852: post_eoln(POST_ARGS)
                    853: {
1.226     schwarze  854:        const struct mdoc_node *n;
1.84      kristaps  855:
1.226     schwarze  856:        n = mdoc->last;
                    857:        if (n->child)
                    858:                mandoc_vmsg(MANDOCERR_ARG_SKIP,
                    859:                    mdoc->parse, n->line, n->pos,
                    860:                    "%s %s", mdoc_macronames[n->tok],
                    861:                    n->child->string);
1.31      kristaps  862: }
                    863:
1.259     schwarze  864: static void
1.250     schwarze  865: post_fname(POST_ARGS)
                    866: {
1.252     schwarze  867:        const struct mdoc_node  *n;
                    868:        const char              *cp;
                    869:        size_t                   pos;
1.250     schwarze  870:
                    871:        n = mdoc->last->child;
                    872:        pos = strcspn(n->string, "()");
1.252     schwarze  873:        cp = n->string + pos;
                    874:        if ( ! (cp[0] == '\0' || (cp[0] == '(' && cp[1] == '*')))
1.250     schwarze  875:                mandoc_msg(MANDOCERR_FN_PAREN, mdoc->parse,
                    876:                    n->line, n->pos + pos, n->string);
                    877: }
                    878:
1.259     schwarze  879: static void
1.250     schwarze  880: post_fn(POST_ARGS)
                    881: {
                    882:
                    883:        post_fname(mdoc);
                    884:        post_fa(mdoc);
                    885: }
                    886:
1.259     schwarze  887: static void
1.242     schwarze  888: post_fo(POST_ARGS)
                    889: {
1.274     schwarze  890:        const struct mdoc_node  *n;
                    891:
                    892:        n = mdoc->last;
1.242     schwarze  893:
1.284   ! schwarze  894:        if (n->type != ROFFT_HEAD)
1.274     schwarze  895:                return;
                    896:
                    897:        if (n->child == NULL) {
                    898:                mandoc_msg(MANDOCERR_FO_NOHEAD, mdoc->parse,
                    899:                    n->line, n->pos, "Fo");
                    900:                return;
                    901:        }
                    902:        if (n->child != n->last) {
                    903:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                    904:                    n->child->next->line, n->child->next->pos,
                    905:                    "Fo ... %s", n->child->next->string);
                    906:                while (n->child != n->last)
                    907:                        mdoc_node_delete(mdoc, n->last);
                    908:        }
                    909:
                    910:        post_fname(mdoc);
1.249     schwarze  911: }
                    912:
1.259     schwarze  913: static void
1.249     schwarze  914: post_fa(POST_ARGS)
                    915: {
                    916:        const struct mdoc_node *n;
                    917:        const char *cp;
                    918:
                    919:        for (n = mdoc->last->child; n != NULL; n = n->next) {
                    920:                for (cp = n->string; *cp != '\0'; cp++) {
                    921:                        /* Ignore callbacks and alterations. */
                    922:                        if (*cp == '(' || *cp == '{')
                    923:                                break;
                    924:                        if (*cp != ',')
                    925:                                continue;
                    926:                        mandoc_msg(MANDOCERR_FA_COMMA, mdoc->parse,
                    927:                            n->line, n->pos + (cp - n->string),
                    928:                            n->string);
                    929:                        break;
                    930:                }
                    931:        }
1.242     schwarze  932: }
                    933:
1.259     schwarze  934: static void
1.57      kristaps  935: post_vt(POST_ARGS)
                    936: {
                    937:        const struct mdoc_node *n;
                    938:
                    939:        /*
                    940:         * The Vt macro comes in both ELEM and BLOCK form, both of which
                    941:         * have different syntaxes (yet more context-sensitive
1.152     schwarze  942:         * behaviour).  ELEM types must have a child, which is already
                    943:         * guaranteed by the in_line parsing routine; BLOCK types,
1.57      kristaps  944:         * specifically the BODY, should only have TEXT children.
                    945:         */
                    946:
1.284   ! schwarze  947:        if (mdoc->last->type != ROFFT_BODY)
1.259     schwarze  948:                return;
1.210     schwarze  949:
1.57      kristaps  950:        for (n = mdoc->last->child; n; n = n->next)
1.284   ! schwarze  951:                if (n->type != ROFFT_TEXT)
1.221     schwarze  952:                        mandoc_msg(MANDOCERR_VT_CHILD, mdoc->parse,
                    953:                            n->line, n->pos, mdoc_macronames[n->tok]);
1.57      kristaps  954: }
                    955:
1.259     schwarze  956: static void
1.1       kristaps  957: post_nm(POST_ARGS)
                    958: {
1.266     schwarze  959:        struct mdoc_node        *n;
                    960:
                    961:        n = mdoc->last;
                    962:
                    963:        if (n->last != NULL &&
                    964:            (n->last->tok == MDOC_Pp ||
                    965:             n->last->tok == MDOC_Lp))
                    966:                mdoc_node_relink(mdoc, n->last);
1.129     kristaps  967:
1.187     schwarze  968:        if (NULL != mdoc->meta.name)
1.259     schwarze  969:                return;
1.1       kristaps  970:
1.266     schwarze  971:        mdoc_deroff(&mdoc->meta.name, n);
1.129     kristaps  972:
1.232     schwarze  973:        if (NULL == mdoc->meta.name)
1.239     schwarze  974:                mandoc_msg(MANDOCERR_NM_NONAME, mdoc->parse,
1.266     schwarze  975:                    n->line, n->pos, "Nm");
1.1       kristaps  976: }
                    977:
1.259     schwarze  978: static void
1.242     schwarze  979: post_nd(POST_ARGS)
                    980: {
1.267     schwarze  981:        struct mdoc_node        *n;
                    982:
                    983:        n = mdoc->last;
                    984:
1.284   ! schwarze  985:        if (n->type != ROFFT_BODY)
1.267     schwarze  986:                return;
                    987:
                    988:        if (n->child == NULL)
                    989:                mandoc_msg(MANDOCERR_ND_EMPTY, mdoc->parse,
                    990:                    n->line, n->pos, "Nd");
1.242     schwarze  991:
1.259     schwarze  992:        post_hyph(mdoc);
1.242     schwarze  993: }
                    994:
1.259     schwarze  995: static void
1.242     schwarze  996: post_d1(POST_ARGS)
                    997: {
1.273     schwarze  998:        struct mdoc_node        *n;
                    999:
                   1000:        n = mdoc->last;
                   1001:
1.284   ! schwarze 1002:        if (n->type != ROFFT_BODY)
1.273     schwarze 1003:                return;
                   1004:
                   1005:        if (n->child == NULL)
1.275     schwarze 1006:                mandoc_msg(MANDOCERR_BLK_EMPTY, mdoc->parse,
1.273     schwarze 1007:                    n->line, n->pos, "D1");
1.242     schwarze 1008:
1.259     schwarze 1009:        post_hyph(mdoc);
1.242     schwarze 1010: }
                   1011:
1.259     schwarze 1012: static void
1.128     kristaps 1013: post_literal(POST_ARGS)
                   1014: {
1.273     schwarze 1015:        struct mdoc_node        *n;
1.210     schwarze 1016:
1.273     schwarze 1017:        n = mdoc->last;
                   1018:
1.284   ! schwarze 1019:        if (n->type != ROFFT_BODY)
1.273     schwarze 1020:                return;
                   1021:
                   1022:        if (n->child == NULL)
1.275     schwarze 1023:                mandoc_msg(MANDOCERR_BLK_EMPTY, mdoc->parse,
1.273     schwarze 1024:                    n->line, n->pos, mdoc_macronames[n->tok]);
1.242     schwarze 1025:
1.273     schwarze 1026:        if (n->tok == MDOC_Bd &&
                   1027:            n->norm->Bd.type != DISP_literal &&
                   1028:            n->norm->Bd.type != DISP_unfilled)
                   1029:                return;
1.128     kristaps 1030:
1.273     schwarze 1031:        mdoc->flags &= ~MDOC_LITERAL;
1.128     kristaps 1032: }
                   1033:
1.259     schwarze 1034: static void
1.123     kristaps 1035: post_defaults(POST_ARGS)
                   1036: {
                   1037:        struct mdoc_node *nn;
                   1038:
                   1039:        /*
                   1040:         * The `Ar' defaults to "file ..." if no value is provided as an
1.129     kristaps 1041:         * argument; the `Mt' and `Pa' macros use "~"; the `Li' just
                   1042:         * gets an empty string.
1.123     kristaps 1043:         */
                   1044:
                   1045:        if (mdoc->last->child)
1.259     schwarze 1046:                return;
1.210     schwarze 1047:
1.123     kristaps 1048:        nn = mdoc->last;
                   1049:        mdoc->next = MDOC_NEXT_CHILD;
                   1050:
                   1051:        switch (nn->tok) {
1.210     schwarze 1052:        case MDOC_Ar:
1.259     schwarze 1053:                mdoc_word_alloc(mdoc, nn->line, nn->pos, "file");
                   1054:                mdoc_word_alloc(mdoc, nn->line, nn->pos, "...");
1.123     kristaps 1055:                break;
1.210     schwarze 1056:        case MDOC_Pa:
1.129     kristaps 1057:                /* FALLTHROUGH */
1.210     schwarze 1058:        case MDOC_Mt:
1.259     schwarze 1059:                mdoc_word_alloc(mdoc, nn->line, nn->pos, "~");
1.123     kristaps 1060:                break;
                   1061:        default:
                   1062:                abort();
                   1063:                /* NOTREACHED */
1.210     schwarze 1064:        }
1.123     kristaps 1065:        mdoc->last = nn;
                   1066: }
1.1       kristaps 1067:
1.259     schwarze 1068: static void
1.1       kristaps 1069: post_at(POST_ARGS)
                   1070: {
1.213     schwarze 1071:        struct mdoc_node        *n;
                   1072:        const char              *std_att;
                   1073:        char                    *att;
1.1       kristaps 1074:
1.242     schwarze 1075:        n = mdoc->last;
                   1076:        if (n->child == NULL) {
                   1077:                mdoc->next = MDOC_NEXT_CHILD;
1.259     schwarze 1078:                mdoc_word_alloc(mdoc, n->line, n->pos, "AT&T UNIX");
1.242     schwarze 1079:                mdoc->last = n;
1.259     schwarze 1080:                return;
1.242     schwarze 1081:        }
                   1082:
1.126     kristaps 1083:        /*
                   1084:         * If we have a child, look it up in the standard keys.  If a
                   1085:         * key exist, use that instead of the child; if it doesn't,
                   1086:         * prefix "AT&T UNIX " to the existing data.
                   1087:         */
1.210     schwarze 1088:
1.242     schwarze 1089:        n = n->child;
1.284   ! schwarze 1090:        assert(n->type == ROFFT_TEXT);
1.213     schwarze 1091:        if (NULL == (std_att = mdoc_a2att(n->string))) {
1.239     schwarze 1092:                mandoc_vmsg(MANDOCERR_AT_BAD, mdoc->parse,
                   1093:                    n->line, n->pos, "At %s", n->string);
1.213     schwarze 1094:                mandoc_asprintf(&att, "AT&T UNIX %s", n->string);
                   1095:        } else
                   1096:                att = mandoc_strdup(std_att);
1.126     kristaps 1097:
1.213     schwarze 1098:        free(n->string);
                   1099:        n->string = att;
1.1       kristaps 1100: }
                   1101:
1.259     schwarze 1102: static void
1.1       kristaps 1103: post_an(POST_ARGS)
                   1104: {
1.269     schwarze 1105:        struct mdoc_node *np, *nch;
1.1       kristaps 1106:
1.107     kristaps 1107:        np = mdoc->last;
1.271     schwarze 1108:        nch = np->child;
                   1109:        if (np->norm->An.auth == AUTH__NONE) {
                   1110:                if (nch == NULL)
                   1111:                        mandoc_msg(MANDOCERR_MACRO_EMPTY, mdoc->parse,
                   1112:                            np->line, np->pos, "An");
                   1113:        } else if (nch != NULL)
1.269     schwarze 1114:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   1115:                    nch->line, nch->pos, "An ... %s", nch->string);
1.218     schwarze 1116: }
                   1117:
1.259     schwarze 1118: static void
1.218     schwarze 1119: post_en(POST_ARGS)
                   1120: {
                   1121:
1.284   ! schwarze 1122:        if (mdoc->last->type == ROFFT_BLOCK)
1.218     schwarze 1123:                mdoc->last->norm->Es = mdoc->last_es;
                   1124: }
                   1125:
1.259     schwarze 1126: static void
1.218     schwarze 1127: post_es(POST_ARGS)
                   1128: {
                   1129:
                   1130:        mdoc->last_es = mdoc->last;
1.1       kristaps 1131: }
                   1132:
1.259     schwarze 1133: static void
1.1       kristaps 1134: post_it(POST_ARGS)
                   1135: {
1.162     kristaps 1136:        int               i, cols;
1.89      kristaps 1137:        enum mdoc_list    lt;
1.224     schwarze 1138:        struct mdoc_node *nbl, *nit, *nch;
1.1       kristaps 1139:
1.224     schwarze 1140:        nit = mdoc->last;
1.284   ! schwarze 1141:        if (nit->type != ROFFT_BLOCK)
1.259     schwarze 1142:                return;
1.1       kristaps 1143:
1.224     schwarze 1144:        nbl = nit->parent->parent;
                   1145:        lt = nbl->norm->Bl.type;
1.89      kristaps 1146:
                   1147:        switch (lt) {
1.210     schwarze 1148:        case LIST_tag:
1.224     schwarze 1149:                /* FALLTHROUGH */
1.210     schwarze 1150:        case LIST_hang:
1.1       kristaps 1151:                /* FALLTHROUGH */
1.210     schwarze 1152:        case LIST_ohang:
1.1       kristaps 1153:                /* FALLTHROUGH */
1.210     schwarze 1154:        case LIST_inset:
1.1       kristaps 1155:                /* FALLTHROUGH */
1.210     schwarze 1156:        case LIST_diag:
1.264     schwarze 1157:                if (nit->head->child == NULL)
1.239     schwarze 1158:                        mandoc_vmsg(MANDOCERR_IT_NOHEAD,
1.224     schwarze 1159:                            mdoc->parse, nit->line, nit->pos,
1.239     schwarze 1160:                            "Bl -%s It",
1.224     schwarze 1161:                            mdoc_argnames[nbl->args->argv[0].arg]);
1.1       kristaps 1162:                break;
1.210     schwarze 1163:        case LIST_bullet:
1.1       kristaps 1164:                /* FALLTHROUGH */
1.210     schwarze 1165:        case LIST_dash:
1.1       kristaps 1166:                /* FALLTHROUGH */
1.210     schwarze 1167:        case LIST_enum:
1.1       kristaps 1168:                /* FALLTHROUGH */
1.210     schwarze 1169:        case LIST_hyphen:
1.264     schwarze 1170:                if (nit->body == NULL || nit->body->child == NULL)
1.239     schwarze 1171:                        mandoc_vmsg(MANDOCERR_IT_NOBODY,
1.225     schwarze 1172:                            mdoc->parse, nit->line, nit->pos,
1.239     schwarze 1173:                            "Bl -%s It",
1.225     schwarze 1174:                            mdoc_argnames[nbl->args->argv[0].arg]);
1.1       kristaps 1175:                /* FALLTHROUGH */
1.210     schwarze 1176:        case LIST_item:
1.264     schwarze 1177:                if (nit->head->child != NULL)
1.226     schwarze 1178:                        mandoc_vmsg(MANDOCERR_ARG_SKIP,
                   1179:                            mdoc->parse, nit->line, nit->pos,
                   1180:                            "It %s", nit->head->child->string);
1.1       kristaps 1181:                break;
1.210     schwarze 1182:        case LIST_column:
1.224     schwarze 1183:                cols = (int)nbl->norm->Bl.ncols;
1.89      kristaps 1184:
1.264     schwarze 1185:                assert(nit->head->child == NULL);
1.89      kristaps 1186:
1.224     schwarze 1187:                for (i = 0, nch = nit->child; nch; nch = nch->next)
1.284   ! schwarze 1188:                        if (nch->type == ROFFT_BODY)
1.87      kristaps 1189:                                i++;
1.38      kristaps 1190:
1.236     schwarze 1191:                if (i < cols || i > cols + 1)
1.276     schwarze 1192:                        mandoc_vmsg(MANDOCERR_BL_COL,
1.236     schwarze 1193:                            mdoc->parse, nit->line, nit->pos,
1.276     schwarze 1194:                            "%d columns, %d cells", cols, i);
1.236     schwarze 1195:                break;
1.1       kristaps 1196:        default:
1.225     schwarze 1197:                abort();
1.1       kristaps 1198:        }
                   1199: }
                   1200:
1.259     schwarze 1201: static void
1.210     schwarze 1202: post_bl_block(POST_ARGS)
1.131     kristaps 1203: {
1.189     schwarze 1204:        struct mdoc_node *n, *ni, *nc;
1.131     kristaps 1205:
                   1206:        /*
                   1207:         * These are fairly complicated, so we've broken them into two
                   1208:         * functions.  post_bl_block_tag() is called when a -tag is
                   1209:         * specified, but no -width (it must be guessed).  The second
                   1210:         * when a -width is specified (macro indicators must be
                   1211:         * rewritten into real lengths).
                   1212:         */
                   1213:
                   1214:        n = mdoc->last;
                   1215:
1.210     schwarze 1216:        if (LIST_tag == n->norm->Bl.type &&
                   1217:            NULL == n->norm->Bl.width) {
1.259     schwarze 1218:                post_bl_block_tag(mdoc);
1.189     schwarze 1219:                assert(n->norm->Bl.width);
                   1220:        }
1.131     kristaps 1221:
1.189     schwarze 1222:        for (ni = n->body->child; ni; ni = ni->next) {
                   1223:                if (NULL == ni->body)
                   1224:                        continue;
                   1225:                nc = ni->body->last;
                   1226:                while (NULL != nc) {
                   1227:                        switch (nc->tok) {
1.210     schwarze 1228:                        case MDOC_Pp:
1.189     schwarze 1229:                                /* FALLTHROUGH */
1.210     schwarze 1230:                        case MDOC_Lp:
1.189     schwarze 1231:                                /* FALLTHROUGH */
1.210     schwarze 1232:                        case MDOC_br:
1.189     schwarze 1233:                                break;
                   1234:                        default:
                   1235:                                nc = NULL;
                   1236:                                continue;
                   1237:                        }
                   1238:                        if (NULL == ni->next) {
1.219     schwarze 1239:                                mandoc_msg(MANDOCERR_PAR_MOVE,
                   1240:                                    mdoc->parse, nc->line, nc->pos,
                   1241:                                    mdoc_macronames[nc->tok]);
1.259     schwarze 1242:                                mdoc_node_relink(mdoc, nc);
1.189     schwarze 1243:                        } else if (0 == n->norm->Bl.comp &&
                   1244:                            LIST_column != n->norm->Bl.type) {
1.219     schwarze 1245:                                mandoc_vmsg(MANDOCERR_PAR_SKIP,
                   1246:                                    mdoc->parse, nc->line, nc->pos,
                   1247:                                    "%s before It",
                   1248:                                    mdoc_macronames[nc->tok]);
1.189     schwarze 1249:                                mdoc_node_delete(mdoc, nc);
                   1250:                        } else
                   1251:                                break;
                   1252:                        nc = ni->body->last;
                   1253:                }
                   1254:        }
1.131     kristaps 1255: }
                   1256:
1.254     schwarze 1257: /*
                   1258:  * If the argument of -offset or -width is a macro,
                   1259:  * replace it with the associated default width.
                   1260:  */
                   1261: void
                   1262: rewrite_macro2len(char **arg)
1.131     kristaps 1263: {
                   1264:        size_t            width;
                   1265:        enum mdoct        tok;
                   1266:
1.254     schwarze 1267:        if (*arg == NULL)
                   1268:                return;
                   1269:        else if ( ! strcmp(*arg, "Ds"))
1.131     kristaps 1270:                width = 6;
1.254     schwarze 1271:        else if ((tok = mdoc_hash_find(*arg)) == MDOC_MAX)
                   1272:                return;
1.228     schwarze 1273:        else
                   1274:                width = macro2len(tok);
1.131     kristaps 1275:
1.254     schwarze 1276:        free(*arg);
                   1277:        mandoc_asprintf(arg, "%zun", width);
1.131     kristaps 1278: }
                   1279:
1.259     schwarze 1280: static void
1.131     kristaps 1281: post_bl_block_tag(POST_ARGS)
                   1282: {
                   1283:        struct mdoc_node *n, *nn;
                   1284:        size_t            sz, ssz;
                   1285:        int               i;
1.211     schwarze 1286:        char              buf[24];
1.131     kristaps 1287:
                   1288:        /*
                   1289:         * Calculate the -width for a `Bl -tag' list if it hasn't been
                   1290:         * provided.  Uses the first head macro.  NOTE AGAIN: this is
                   1291:         * ONLY if the -width argument has NOT been provided.  See
1.254     schwarze 1292:         * rewrite_macro2len() for converting the -width string.
1.131     kristaps 1293:         */
                   1294:
                   1295:        sz = 10;
                   1296:        n = mdoc->last;
                   1297:
                   1298:        for (nn = n->body->child; nn; nn = nn->next) {
                   1299:                if (MDOC_It != nn->tok)
                   1300:                        continue;
                   1301:
1.284   ! schwarze 1302:                assert(nn->type == ROFFT_BLOCK);
1.131     kristaps 1303:                nn = nn->head->child;
                   1304:
1.138     kristaps 1305:                if (nn == NULL)
1.131     kristaps 1306:                        break;
                   1307:
1.284   ! schwarze 1308:                if (nn->type == ROFFT_TEXT) {
1.131     kristaps 1309:                        sz = strlen(nn->string) + 1;
                   1310:                        break;
                   1311:                }
                   1312:
1.161     kristaps 1313:                if (0 != (ssz = macro2len(nn->tok)))
1.131     kristaps 1314:                        sz = ssz;
                   1315:
                   1316:                break;
1.210     schwarze 1317:        }
1.131     kristaps 1318:
                   1319:        /* Defaults to ten ens. */
                   1320:
1.211     schwarze 1321:        (void)snprintf(buf, sizeof(buf), "%un", (unsigned int)sz);
1.131     kristaps 1322:
                   1323:        /*
                   1324:         * We have to dynamically add this to the macro's argument list.
                   1325:         * We're guaranteed that a MDOC_Width doesn't already exist.
                   1326:         */
                   1327:
                   1328:        assert(n->args);
                   1329:        i = (int)(n->args->argc)++;
                   1330:
1.214     schwarze 1331:        n->args->argv = mandoc_reallocarray(n->args->argv,
                   1332:            n->args->argc, sizeof(struct mdoc_argv));
1.131     kristaps 1333:
                   1334:        n->args->argv[i].arg = MDOC_Width;
                   1335:        n->args->argv[i].line = n->line;
                   1336:        n->args->argv[i].pos = n->pos;
                   1337:        n->args->argv[i].sz = 1;
                   1338:        n->args->argv[i].value = mandoc_malloc(sizeof(char *));
                   1339:        n->args->argv[i].value[0] = mandoc_strdup(buf);
                   1340:
                   1341:        /* Set our width! */
1.147     kristaps 1342:        n->norm->Bl.width = n->args->argv[i].value[0];
1.131     kristaps 1343: }
                   1344:
1.259     schwarze 1345: static void
1.210     schwarze 1346: post_bl_head(POST_ARGS)
1.14      kristaps 1347: {
1.270     schwarze 1348:        struct mdoc_node *nbl, *nh, *nch, *nnext;
1.237     schwarze 1349:        struct mdoc_argv *argv;
1.130     kristaps 1350:        int               i, j;
1.14      kristaps 1351:
1.270     schwarze 1352:        nh = mdoc->last;
                   1353:
                   1354:        if (nh->norm->Bl.type != LIST_column) {
                   1355:                if ((nch = nh->child) == NULL)
                   1356:                        return;
                   1357:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   1358:                    nch->line, nch->pos, "Bl ... %s", nch->string);
                   1359:                while (nch != NULL) {
                   1360:                        mdoc_node_delete(mdoc, nch);
                   1361:                        nch = nh->child;
                   1362:                }
1.259     schwarze 1363:                return;
                   1364:        }
1.14      kristaps 1365:
1.130     kristaps 1366:        /*
1.237     schwarze 1367:         * Append old-style lists, where the column width specifiers
1.130     kristaps 1368:         * trail as macro parameters, to the new-style ("normal-form")
                   1369:         * lists where they're argument values following -column.
                   1370:         */
                   1371:
1.270     schwarze 1372:        if (nh->child == NULL)
1.259     schwarze 1373:                return;
1.130     kristaps 1374:
1.270     schwarze 1375:        nbl = nh->parent;
                   1376:        for (j = 0; j < (int)nbl->args->argc; j++)
                   1377:                if (nbl->args->argv[j].arg == MDOC_Column)
1.130     kristaps 1378:                        break;
                   1379:
1.270     schwarze 1380:        assert(j < (int)nbl->args->argc);
1.130     kristaps 1381:
                   1382:        /*
1.169     kristaps 1383:         * Accommodate for new-style groff column syntax.  Shuffle the
1.130     kristaps 1384:         * child nodes, all of which must be TEXT, as arguments for the
                   1385:         * column field.  Then, delete the head children.
                   1386:         */
                   1387:
1.270     schwarze 1388:        argv = nbl->args->argv + j;
1.237     schwarze 1389:        i = argv->sz;
1.270     schwarze 1390:        argv->sz += nh->nchild;
1.237     schwarze 1391:        argv->value = mandoc_reallocarray(argv->value,
                   1392:            argv->sz, sizeof(char *));
1.130     kristaps 1393:
1.270     schwarze 1394:        nh->norm->Bl.ncols = argv->sz;
                   1395:        nh->norm->Bl.cols = (void *)argv->value;
1.130     kristaps 1396:
1.270     schwarze 1397:        for (nch = nh->child; nch != NULL; nch = nnext) {
                   1398:                argv->value[i++] = nch->string;
                   1399:                nch->string = NULL;
                   1400:                nnext = nch->next;
                   1401:                mdoc_node_delete(NULL, nch);
1.65      kristaps 1402:        }
1.270     schwarze 1403:        nh->nchild = 0;
                   1404:        nh->child = NULL;
1.14      kristaps 1405: }
                   1406:
1.259     schwarze 1407: static void
1.1       kristaps 1408: post_bl(POST_ARGS)
                   1409: {
1.195     schwarze 1410:        struct mdoc_node        *nparent, *nprev; /* of the Bl block */
                   1411:        struct mdoc_node        *nblock, *nbody;  /* of the Bl */
                   1412:        struct mdoc_node        *nchild, *nnext;  /* of the Bl body */
                   1413:
                   1414:        nbody = mdoc->last;
                   1415:        switch (nbody->type) {
1.284   ! schwarze 1416:        case ROFFT_BLOCK:
1.259     schwarze 1417:                post_bl_block(mdoc);
                   1418:                return;
1.284   ! schwarze 1419:        case ROFFT_HEAD:
1.259     schwarze 1420:                post_bl_head(mdoc);
                   1421:                return;
1.284   ! schwarze 1422:        case ROFFT_BODY:
1.195     schwarze 1423:                break;
                   1424:        default:
1.259     schwarze 1425:                return;
1.195     schwarze 1426:        }
1.1       kristaps 1427:
1.195     schwarze 1428:        nchild = nbody->child;
1.273     schwarze 1429:        if (nchild == NULL) {
1.275     schwarze 1430:                mandoc_msg(MANDOCERR_BLK_EMPTY, mdoc->parse,
1.273     schwarze 1431:                    nbody->line, nbody->pos, "Bl");
                   1432:                return;
                   1433:        }
                   1434:        while (nchild != NULL) {
1.265     schwarze 1435:                if (nchild->tok == MDOC_It ||
                   1436:                    (nchild->tok == MDOC_Sm &&
                   1437:                     nchild->next != NULL &&
                   1438:                     nchild->next->tok == MDOC_It)) {
1.195     schwarze 1439:                        nchild = nchild->next;
1.55      kristaps 1440:                        continue;
1.141     kristaps 1441:                }
                   1442:
1.221     schwarze 1443:                mandoc_msg(MANDOCERR_BL_MOVE, mdoc->parse,
                   1444:                    nchild->line, nchild->pos,
                   1445:                    mdoc_macronames[nchild->tok]);
1.195     schwarze 1446:
                   1447:                /*
                   1448:                 * Move the node out of the Bl block.
                   1449:                 * First, collect all required node pointers.
                   1450:                 */
                   1451:
                   1452:                nblock  = nbody->parent;
                   1453:                nprev   = nblock->prev;
                   1454:                nparent = nblock->parent;
                   1455:                nnext   = nchild->next;
                   1456:
                   1457:                /*
                   1458:                 * Unlink this child.
                   1459:                 */
                   1460:
                   1461:                assert(NULL == nchild->prev);
                   1462:                if (0 == --nbody->nchild) {
                   1463:                        nbody->child = NULL;
                   1464:                        nbody->last  = NULL;
                   1465:                        assert(NULL == nnext);
                   1466:                } else {
                   1467:                        nbody->child = nnext;
                   1468:                        nnext->prev = NULL;
                   1469:                }
                   1470:
                   1471:                /*
                   1472:                 * Relink this child.
                   1473:                 */
                   1474:
                   1475:                nchild->parent = nparent;
                   1476:                nchild->prev   = nprev;
                   1477:                nchild->next   = nblock;
                   1478:
                   1479:                nblock->prev = nchild;
                   1480:                nparent->nchild++;
                   1481:                if (NULL == nprev)
                   1482:                        nparent->child = nchild;
                   1483:                else
                   1484:                        nprev->next = nchild;
                   1485:
                   1486:                nchild = nnext;
1.1       kristaps 1487:        }
                   1488: }
                   1489:
1.259     schwarze 1490: static void
1.242     schwarze 1491: post_bk(POST_ARGS)
                   1492: {
1.270     schwarze 1493:        struct mdoc_node        *n;
1.242     schwarze 1494:
1.270     schwarze 1495:        n = mdoc->last;
                   1496:
1.284   ! schwarze 1497:        if (n->type == ROFFT_BLOCK && n->body->child == NULL) {
1.275     schwarze 1498:                mandoc_msg(MANDOCERR_BLK_EMPTY,
1.270     schwarze 1499:                    mdoc->parse, n->line, n->pos, "Bk");
                   1500:                mdoc_node_delete(mdoc, n);
                   1501:        }
1.242     schwarze 1502: }
                   1503:
1.259     schwarze 1504: static void
1.257     schwarze 1505: post_sm(struct mdoc *mdoc)
1.1       kristaps 1506: {
1.228     schwarze 1507:        struct mdoc_node        *nch;
                   1508:
                   1509:        nch = mdoc->last->child;
1.1       kristaps 1510:
1.257     schwarze 1511:        if (nch == NULL) {
                   1512:                mdoc->flags ^= MDOC_SMOFF;
1.259     schwarze 1513:                return;
1.151     schwarze 1514:        }
1.133     kristaps 1515:
1.284   ! schwarze 1516:        assert(nch->type == ROFFT_TEXT);
1.1       kristaps 1517:
1.257     schwarze 1518:        if ( ! strcmp(nch->string, "on")) {
                   1519:                mdoc->flags &= ~MDOC_SMOFF;
1.259     schwarze 1520:                return;
1.197     schwarze 1521:        }
1.257     schwarze 1522:        if ( ! strcmp(nch->string, "off")) {
                   1523:                mdoc->flags |= MDOC_SMOFF;
1.259     schwarze 1524:                return;
1.197     schwarze 1525:        }
1.133     kristaps 1526:
1.228     schwarze 1527:        mandoc_vmsg(MANDOCERR_SM_BAD,
                   1528:            mdoc->parse, nch->line, nch->pos,
1.257     schwarze 1529:            "%s %s", mdoc_macronames[mdoc->last->tok], nch->string);
1.259     schwarze 1530:        mdoc_node_relink(mdoc, nch);
                   1531:        return;
1.1       kristaps 1532: }
                   1533:
1.259     schwarze 1534: static void
1.1       kristaps 1535: post_root(POST_ARGS)
                   1536: {
1.133     kristaps 1537:        struct mdoc_node *n;
1.1       kristaps 1538:
1.234     schwarze 1539:        /* Add missing prologue data. */
1.133     kristaps 1540:
1.243     schwarze 1541:        if (mdoc->meta.date == NULL)
                   1542:                mdoc->meta.date = mdoc->quick ?
                   1543:                    mandoc_strdup("") :
                   1544:                    mandoc_normdate(mdoc->parse, NULL, 0, 0);
                   1545:
                   1546:        if (mdoc->meta.title == NULL) {
                   1547:                mandoc_msg(MANDOCERR_DT_NOTITLE,
                   1548:                    mdoc->parse, 0, 0, "EOF");
                   1549:                mdoc->meta.title = mandoc_strdup("UNTITLED");
                   1550:        }
                   1551:
                   1552:        if (mdoc->meta.vol == NULL)
                   1553:                mdoc->meta.vol = mandoc_strdup("LOCAL");
                   1554:
                   1555:        if (mdoc->meta.os == NULL) {
                   1556:                mandoc_msg(MANDOCERR_OS_MISSING,
                   1557:                    mdoc->parse, 0, 0, NULL);
                   1558:                mdoc->meta.os = mandoc_strdup("");
1.133     kristaps 1559:        }
                   1560:
                   1561:        /* Check that we begin with a proper `Sh'. */
                   1562:
1.246     schwarze 1563:        n = mdoc->first->child;
                   1564:        while (n != NULL && mdoc_macros[n->tok].flags & MDOC_PROLOGUE)
                   1565:                n = n->next;
                   1566:
                   1567:        if (n == NULL)
                   1568:                mandoc_msg(MANDOCERR_DOC_EMPTY, mdoc->parse, 0, 0, NULL);
                   1569:        else if (n->tok != MDOC_Sh)
1.217     schwarze 1570:                mandoc_msg(MANDOCERR_SEC_BEFORE, mdoc->parse,
1.246     schwarze 1571:                    n->line, n->pos, mdoc_macronames[n->tok]);
1.1       kristaps 1572: }
                   1573:
1.259     schwarze 1574: static void
1.1       kristaps 1575: post_st(POST_ARGS)
                   1576: {
1.228     schwarze 1577:        struct mdoc_node         *n, *nch;
1.151     schwarze 1578:        const char               *p;
1.128     kristaps 1579:
1.228     schwarze 1580:        n = mdoc->last;
                   1581:        nch = n->child;
                   1582:
1.284   ! schwarze 1583:        assert(nch->type == ROFFT_TEXT);
1.128     kristaps 1584:
1.228     schwarze 1585:        if (NULL == (p = mdoc_a2st(nch->string))) {
1.239     schwarze 1586:                mandoc_vmsg(MANDOCERR_ST_BAD, mdoc->parse,
                   1587:                    nch->line, nch->pos, "St %s", nch->string);
1.228     schwarze 1588:                mdoc_node_delete(mdoc, n);
1.128     kristaps 1589:        } else {
1.228     schwarze 1590:                free(nch->string);
                   1591:                nch->string = mandoc_strdup(p);
1.128     kristaps 1592:        }
1.1       kristaps 1593: }
                   1594:
1.259     schwarze 1595: static void
1.43      kristaps 1596: post_rs(POST_ARGS)
                   1597: {
1.268     schwarze 1598:        struct mdoc_node *np, *nch, *next, *prev;
1.122     kristaps 1599:        int               i, j;
1.43      kristaps 1600:
1.268     schwarze 1601:        np = mdoc->last;
                   1602:
1.284   ! schwarze 1603:        if (np->type != ROFFT_BODY)
1.259     schwarze 1604:                return;
1.268     schwarze 1605:
                   1606:        if (np->child == NULL) {
                   1607:                mandoc_msg(MANDOCERR_RS_EMPTY, mdoc->parse,
                   1608:                    np->line, np->pos, "Rs");
1.259     schwarze 1609:                return;
1.151     schwarze 1610:        }
1.43      kristaps 1611:
1.122     kristaps 1612:        /*
                   1613:         * The full `Rs' block needs special handling to order the
                   1614:         * sub-elements according to `rsord'.  Pick through each element
1.230     schwarze 1615:         * and correctly order it.  This is an insertion sort.
1.122     kristaps 1616:         */
                   1617:
                   1618:        next = NULL;
1.268     schwarze 1619:        for (nch = np->child->next; nch != NULL; nch = next) {
                   1620:                /* Determine order number of this child. */
1.122     kristaps 1621:                for (i = 0; i < RSORD_MAX; i++)
1.268     schwarze 1622:                        if (rsord[i] == nch->tok)
1.122     kristaps 1623:                                break;
                   1624:
1.230     schwarze 1625:                if (i == RSORD_MAX) {
                   1626:                        mandoc_msg(MANDOCERR_RS_BAD,
1.268     schwarze 1627:                            mdoc->parse, nch->line, nch->pos,
                   1628:                            mdoc_macronames[nch->tok]);
1.230     schwarze 1629:                        i = -1;
1.268     schwarze 1630:                } else if (nch->tok == MDOC__J || nch->tok == MDOC__B)
                   1631:                        np->norm->Rs.quote_T++;
1.230     schwarze 1632:
1.210     schwarze 1633:                /*
1.268     schwarze 1634:                 * Remove this child from the chain.  This somewhat
1.122     kristaps 1635:                 * repeats mdoc_node_unlink(), but since we're
                   1636:                 * just re-ordering, there's no need for the
                   1637:                 * full unlink process.
                   1638:                 */
1.210     schwarze 1639:
1.268     schwarze 1640:                if ((next = nch->next) != NULL)
                   1641:                        next->prev = nch->prev;
1.122     kristaps 1642:
1.268     schwarze 1643:                if ((prev = nch->prev) != NULL)
                   1644:                        prev->next = nch->next;
1.122     kristaps 1645:
1.268     schwarze 1646:                nch->prev = nch->next = NULL;
1.122     kristaps 1647:
1.210     schwarze 1648:                /*
1.122     kristaps 1649:                 * Scan back until we reach a node that's
1.268     schwarze 1650:                 * to be ordered before this child.
1.122     kristaps 1651:                 */
                   1652:
                   1653:                for ( ; prev ; prev = prev->prev) {
                   1654:                        /* Determine order of `prev'. */
                   1655:                        for (j = 0; j < RSORD_MAX; j++)
                   1656:                                if (rsord[j] == prev->tok)
                   1657:                                        break;
1.230     schwarze 1658:                        if (j == RSORD_MAX)
                   1659:                                j = -1;
1.122     kristaps 1660:
                   1661:                        if (j <= i)
                   1662:                                break;
                   1663:                }
                   1664:
                   1665:                /*
1.268     schwarze 1666:                 * Set this child back into its correct place
                   1667:                 * in front of the `prev' node.
1.122     kristaps 1668:                 */
                   1669:
1.268     schwarze 1670:                nch->prev = prev;
1.122     kristaps 1671:
1.268     schwarze 1672:                if (prev == NULL) {
                   1673:                        np->child->prev = nch;
                   1674:                        nch->next = np->child;
                   1675:                        np->child = nch;
                   1676:                } else {
1.122     kristaps 1677:                        if (prev->next)
1.268     schwarze 1678:                                prev->next->prev = nch;
                   1679:                        nch->next = prev->next;
                   1680:                        prev->next = nch;
1.43      kristaps 1681:                }
1.122     kristaps 1682:        }
1.196     schwarze 1683: }
                   1684:
                   1685: /*
                   1686:  * For some arguments of some macros,
                   1687:  * convert all breakable hyphens into ASCII_HYPH.
                   1688:  */
1.259     schwarze 1689: static void
1.196     schwarze 1690: post_hyph(POST_ARGS)
                   1691: {
1.273     schwarze 1692:        struct mdoc_node        *nch;
1.196     schwarze 1693:        char                    *cp;
                   1694:
1.273     schwarze 1695:        for (nch = mdoc->last->child; nch != NULL; nch = nch->next) {
1.284   ! schwarze 1696:                if (nch->type != ROFFT_TEXT)
1.196     schwarze 1697:                        continue;
                   1698:                cp = nch->string;
1.273     schwarze 1699:                if (*cp == '\0')
1.196     schwarze 1700:                        continue;
1.273     schwarze 1701:                while (*(++cp) != '\0')
                   1702:                        if (*cp == '-' &&
1.196     schwarze 1703:                            isalpha((unsigned char)cp[-1]) &&
                   1704:                            isalpha((unsigned char)cp[1]))
                   1705:                                *cp = ASCII_HYPH;
                   1706:        }
1.242     schwarze 1707: }
                   1708:
1.259     schwarze 1709: static void
1.155     kristaps 1710: post_ns(POST_ARGS)
                   1711: {
                   1712:
                   1713:        if (MDOC_LINE & mdoc->last->flags)
1.240     schwarze 1714:                mandoc_msg(MANDOCERR_NS_SKIP, mdoc->parse,
                   1715:                    mdoc->last->line, mdoc->last->pos, NULL);
1.43      kristaps 1716: }
                   1717:
1.259     schwarze 1718: static void
1.1       kristaps 1719: post_sh(POST_ARGS)
                   1720: {
                   1721:
1.242     schwarze 1722:        post_ignpar(mdoc);
                   1723:
1.247     schwarze 1724:        switch (mdoc->last->type) {
1.284   ! schwarze 1725:        case ROFFT_HEAD:
1.259     schwarze 1726:                post_sh_head(mdoc);
                   1727:                break;
1.284   ! schwarze 1728:        case ROFFT_BODY:
1.247     schwarze 1729:                switch (mdoc->lastsec)  {
                   1730:                case SEC_NAME:
1.259     schwarze 1731:                        post_sh_name(mdoc);
                   1732:                        break;
1.248     schwarze 1733:                case SEC_SEE_ALSO:
1.259     schwarze 1734:                        post_sh_see_also(mdoc);
                   1735:                        break;
1.247     schwarze 1736:                case SEC_AUTHORS:
1.259     schwarze 1737:                        post_sh_authors(mdoc);
                   1738:                        break;
1.247     schwarze 1739:                default:
                   1740:                        break;
                   1741:                }
                   1742:                break;
                   1743:        default:
                   1744:                break;
                   1745:        }
1.1       kristaps 1746: }
                   1747:
1.259     schwarze 1748: static void
1.247     schwarze 1749: post_sh_name(POST_ARGS)
1.1       kristaps 1750: {
                   1751:        struct mdoc_node *n;
1.282     schwarze 1752:        int hasnm, hasnd;
1.1       kristaps 1753:
1.282     schwarze 1754:        hasnm = hasnd = 0;
1.1       kristaps 1755:
1.282     schwarze 1756:        for (n = mdoc->last->child; n != NULL; n = n->next) {
                   1757:                switch (n->tok) {
                   1758:                case MDOC_Nm:
                   1759:                        hasnm = 1;
                   1760:                        break;
                   1761:                case MDOC_Nd:
                   1762:                        hasnd = 1;
                   1763:                        if (n->next != NULL)
                   1764:                                mandoc_msg(MANDOCERR_NAMESEC_ND,
                   1765:                                    mdoc->parse, n->line, n->pos, NULL);
                   1766:                        break;
1.283     schwarze 1767:                case MDOC_MAX:
                   1768:                        if (hasnm)
                   1769:                                break;
                   1770:                        /* FALLTHROUGH */
1.282     schwarze 1771:                default:
                   1772:                        mandoc_msg(MANDOCERR_NAMESEC_BAD, mdoc->parse,
                   1773:                            n->line, n->pos, mdoc_macronames[n->tok]);
                   1774:                        break;
                   1775:                }
1.133     kristaps 1776:        }
1.1       kristaps 1777:
1.282     schwarze 1778:        if ( ! hasnm)
                   1779:                mandoc_msg(MANDOCERR_NAMESEC_NONM, mdoc->parse,
                   1780:                    mdoc->last->line, mdoc->last->pos, NULL);
                   1781:        if ( ! hasnd)
                   1782:                mandoc_msg(MANDOCERR_NAMESEC_NOND, mdoc->parse,
                   1783:                    mdoc->last->line, mdoc->last->pos, NULL);
1.248     schwarze 1784: }
                   1785:
1.259     schwarze 1786: static void
1.248     schwarze 1787: post_sh_see_also(POST_ARGS)
                   1788: {
                   1789:        const struct mdoc_node  *n;
1.277     schwarze 1790:        const char              *name, *sec;
1.248     schwarze 1791:        const char              *lastname, *lastsec, *lastpunct;
                   1792:        int                      cmp;
                   1793:
                   1794:        n = mdoc->last->child;
                   1795:        lastname = lastsec = lastpunct = NULL;
                   1796:        while (n != NULL) {
                   1797:                if (n->tok != MDOC_Xr || n->nchild < 2)
                   1798:                        break;
                   1799:
                   1800:                /* Process one .Xr node. */
                   1801:
                   1802:                name = n->child->string;
                   1803:                sec = n->child->next->string;
                   1804:                if (lastsec != NULL) {
                   1805:                        if (lastpunct[0] != ',' || lastpunct[1] != '\0')
                   1806:                                mandoc_vmsg(MANDOCERR_XR_PUNCT,
                   1807:                                    mdoc->parse, n->line, n->pos,
                   1808:                                    "%s before %s(%s)", lastpunct,
                   1809:                                    name, sec);
                   1810:                        cmp = strcmp(lastsec, sec);
                   1811:                        if (cmp > 0)
                   1812:                                mandoc_vmsg(MANDOCERR_XR_ORDER,
                   1813:                                    mdoc->parse, n->line, n->pos,
                   1814:                                    "%s(%s) after %s(%s)", name,
                   1815:                                    sec, lastname, lastsec);
1.253     schwarze 1816:                        else if (cmp == 0 &&
                   1817:                            strcasecmp(lastname, name) > 0)
1.248     schwarze 1818:                                mandoc_vmsg(MANDOCERR_XR_ORDER,
                   1819:                                    mdoc->parse, n->line, n->pos,
                   1820:                                    "%s after %s", name, lastname);
                   1821:                }
                   1822:                lastname = name;
                   1823:                lastsec = sec;
                   1824:
                   1825:                /* Process the following node. */
                   1826:
                   1827:                n = n->next;
                   1828:                if (n == NULL)
                   1829:                        break;
                   1830:                if (n->tok == MDOC_Xr) {
                   1831:                        lastpunct = "none";
                   1832:                        continue;
                   1833:                }
1.284   ! schwarze 1834:                if (n->type != ROFFT_TEXT)
1.248     schwarze 1835:                        break;
                   1836:                for (name = n->string; *name != '\0'; name++)
                   1837:                        if (isalpha((const unsigned char)*name))
1.259     schwarze 1838:                                return;
1.248     schwarze 1839:                lastpunct = n->string;
                   1840:                if (n->next == NULL)
                   1841:                        mandoc_vmsg(MANDOCERR_XR_PUNCT, mdoc->parse,
                   1842:                            n->line, n->pos, "%s after %s(%s)",
                   1843:                            lastpunct, lastname, lastsec);
                   1844:                n = n->next;
                   1845:        }
1.247     schwarze 1846: }
                   1847:
                   1848: static int
                   1849: child_an(const struct mdoc_node *n)
                   1850: {
                   1851:
                   1852:        for (n = n->child; n != NULL; n = n->next)
                   1853:                if ((n->tok == MDOC_An && n->nchild) || child_an(n))
                   1854:                        return(1);
                   1855:        return(0);
                   1856: }
                   1857:
1.259     schwarze 1858: static void
1.247     schwarze 1859: post_sh_authors(POST_ARGS)
                   1860: {
                   1861:
                   1862:        if ( ! child_an(mdoc->last))
                   1863:                mandoc_msg(MANDOCERR_AN_MISSING, mdoc->parse,
                   1864:                    mdoc->last->line, mdoc->last->pos, NULL);
1.1       kristaps 1865: }
                   1866:
1.259     schwarze 1867: static void
1.1       kristaps 1868: post_sh_head(POST_ARGS)
                   1869: {
1.181     schwarze 1870:        struct mdoc_node *n;
1.217     schwarze 1871:        const char      *goodsec;
1.209     schwarze 1872:        char            *secname;
1.132     kristaps 1873:        enum mdoc_sec    sec;
1.1       kristaps 1874:
                   1875:        /*
                   1876:         * Process a new section.  Sections are either "named" or
1.125     kristaps 1877:         * "custom".  Custom sections are user-defined, while named ones
                   1878:         * follow a conventional order and may only appear in certain
                   1879:         * manual sections.
1.1       kristaps 1880:         */
                   1881:
1.205     schwarze 1882:        secname = NULL;
1.173     kristaps 1883:        sec = SEC_CUSTOM;
1.209     schwarze 1884:        mdoc_deroff(&secname, mdoc->last);
                   1885:        sec = NULL == secname ? SEC_CUSTOM : a2sec(secname);
1.1       kristaps 1886:
1.125     kristaps 1887:        /* The NAME should be first. */
1.1       kristaps 1888:
1.72      kristaps 1889:        if (SEC_NAME != sec && SEC_NONE == mdoc->lastnamed)
1.239     schwarze 1890:                mandoc_vmsg(MANDOCERR_NAMESEC_FIRST, mdoc->parse,
                   1891:                    mdoc->last->line, mdoc->last->pos,
                   1892:                    "Sh %s", secname);
1.125     kristaps 1893:
                   1894:        /* The SYNOPSIS gets special attention in other areas. */
                   1895:
1.194     schwarze 1896:        if (SEC_SYNOPSIS == sec) {
1.198     schwarze 1897:                roff_setreg(mdoc->roff, "nS", 1, '=');
1.125     kristaps 1898:                mdoc->flags |= MDOC_SYNOPSIS;
1.194     schwarze 1899:        } else {
1.198     schwarze 1900:                roff_setreg(mdoc->roff, "nS", 0, '=');
1.125     kristaps 1901:                mdoc->flags &= ~MDOC_SYNOPSIS;
1.194     schwarze 1902:        }
1.125     kristaps 1903:
                   1904:        /* Mark our last section. */
                   1905:
                   1906:        mdoc->lastsec = sec;
1.181     schwarze 1907:
                   1908:        /*
                   1909:         * Set the section attribute for the current HEAD, for its
                   1910:         * parent BLOCK, and for the HEAD children; the latter can
                   1911:         * only be TEXT nodes, so no recursion is needed.
                   1912:         * For other blocks and elements, including .Sh BODY, this is
                   1913:         * done when allocating the node data structures, but for .Sh
                   1914:         * BLOCK and HEAD, the section is still unknown at that time.
                   1915:         */
                   1916:
                   1917:        mdoc->last->parent->sec = sec;
                   1918:        mdoc->last->sec = sec;
                   1919:        for (n = mdoc->last->child; n; n = n->next)
                   1920:                n->sec = sec;
1.125     kristaps 1921:
                   1922:        /* We don't care about custom sections after this. */
1.72      kristaps 1923:
1.209     schwarze 1924:        if (SEC_CUSTOM == sec) {
                   1925:                free(secname);
1.259     schwarze 1926:                return;
1.209     schwarze 1927:        }
1.72      kristaps 1928:
1.125     kristaps 1929:        /*
                   1930:         * Check whether our non-custom section is being repeated or is
                   1931:         * out of order.
                   1932:         */
                   1933:
1.1       kristaps 1934:        if (sec == mdoc->lastnamed)
1.239     schwarze 1935:                mandoc_vmsg(MANDOCERR_SEC_REP, mdoc->parse,
                   1936:                    mdoc->last->line, mdoc->last->pos,
                   1937:                    "Sh %s", secname);
1.72      kristaps 1938:
1.1       kristaps 1939:        if (sec < mdoc->lastnamed)
1.239     schwarze 1940:                mandoc_vmsg(MANDOCERR_SEC_ORDER, mdoc->parse,
                   1941:                    mdoc->last->line, mdoc->last->pos,
                   1942:                    "Sh %s", secname);
1.125     kristaps 1943:
                   1944:        /* Mark the last named section. */
                   1945:
                   1946:        mdoc->lastnamed = sec;
                   1947:
                   1948:        /* Check particular section/manual conventions. */
1.1       kristaps 1949:
1.243     schwarze 1950:        if (mdoc->meta.msec == NULL) {
                   1951:                free(secname);
1.259     schwarze 1952:                return;
1.243     schwarze 1953:        }
1.1       kristaps 1954:
1.217     schwarze 1955:        goodsec = NULL;
1.1       kristaps 1956:        switch (sec) {
1.210     schwarze 1957:        case SEC_ERRORS:
1.207     schwarze 1958:                if (*mdoc->meta.msec == '4')
                   1959:                        break;
1.217     schwarze 1960:                goodsec = "2, 3, 4, 9";
1.207     schwarze 1961:                /* FALLTHROUGH */
1.210     schwarze 1962:        case SEC_RETURN_VALUES:
1.125     kristaps 1963:                /* FALLTHROUGH */
1.210     schwarze 1964:        case SEC_LIBRARY:
1.78      kristaps 1965:                if (*mdoc->meta.msec == '2')
                   1966:                        break;
                   1967:                if (*mdoc->meta.msec == '3')
                   1968:                        break;
1.217     schwarze 1969:                if (NULL == goodsec)
                   1970:                        goodsec = "2, 3, 9";
1.208     schwarze 1971:                /* FALLTHROUGH */
1.210     schwarze 1972:        case SEC_CONTEXT:
1.78      kristaps 1973:                if (*mdoc->meta.msec == '9')
1.1       kristaps 1974:                        break;
1.217     schwarze 1975:                if (NULL == goodsec)
                   1976:                        goodsec = "9";
                   1977:                mandoc_vmsg(MANDOCERR_SEC_MSEC, mdoc->parse,
                   1978:                    mdoc->last->line, mdoc->last->pos,
1.239     schwarze 1979:                    "Sh %s for %s only", secname, goodsec);
1.125     kristaps 1980:                break;
1.1       kristaps 1981:        default:
                   1982:                break;
                   1983:        }
1.209     schwarze 1984:        free(secname);
1.140     kristaps 1985: }
                   1986:
1.259     schwarze 1987: static void
1.140     kristaps 1988: post_ignpar(POST_ARGS)
                   1989: {
                   1990:        struct mdoc_node *np;
                   1991:
1.273     schwarze 1992:        switch (mdoc->last->type) {
1.284   ! schwarze 1993:        case ROFFT_HEAD:
1.273     schwarze 1994:                post_hyph(mdoc);
                   1995:                return;
1.284   ! schwarze 1996:        case ROFFT_BODY:
1.273     schwarze 1997:                break;
                   1998:        default:
1.259     schwarze 1999:                return;
1.273     schwarze 2000:        }
1.140     kristaps 2001:
1.143     kristaps 2002:        if (NULL != (np = mdoc->last->child))
1.140     kristaps 2003:                if (MDOC_Pp == np->tok || MDOC_Lp == np->tok) {
1.219     schwarze 2004:                        mandoc_vmsg(MANDOCERR_PAR_SKIP,
                   2005:                            mdoc->parse, np->line, np->pos,
                   2006:                            "%s after %s", mdoc_macronames[np->tok],
                   2007:                            mdoc_macronames[mdoc->last->tok]);
1.140     kristaps 2008:                        mdoc_node_delete(mdoc, np);
                   2009:                }
                   2010:
                   2011:        if (NULL != (np = mdoc->last->last))
                   2012:                if (MDOC_Pp == np->tok || MDOC_Lp == np->tok) {
1.219     schwarze 2013:                        mandoc_vmsg(MANDOCERR_PAR_SKIP, mdoc->parse,
                   2014:                            np->line, np->pos, "%s at the end of %s",
                   2015:                            mdoc_macronames[np->tok],
                   2016:                            mdoc_macronames[mdoc->last->tok]);
1.140     kristaps 2017:                        mdoc_node_delete(mdoc, np);
                   2018:                }
1.117     kristaps 2019: }
                   2020:
1.259     schwarze 2021: static void
1.124     kristaps 2022: pre_par(PRE_ARGS)
1.117     kristaps 2023: {
                   2024:
1.118     kristaps 2025:        if (NULL == mdoc->last)
1.259     schwarze 2026:                return;
1.284   ! schwarze 2027:        if (n->type != ROFFT_ELEM && n->type != ROFFT_BLOCK)
1.259     schwarze 2028:                return;
1.118     kristaps 2029:
1.210     schwarze 2030:        /*
1.124     kristaps 2031:         * Don't allow prior `Lp' or `Pp' prior to a paragraph-type
                   2032:         * block:  `Lp', `Pp', or non-compact `Bd' or `Bl'.
                   2033:         */
1.118     kristaps 2034:
1.188     schwarze 2035:        if (MDOC_Pp != mdoc->last->tok &&
                   2036:            MDOC_Lp != mdoc->last->tok &&
                   2037:            MDOC_br != mdoc->last->tok)
1.259     schwarze 2038:                return;
1.147     kristaps 2039:        if (MDOC_Bl == n->tok && n->norm->Bl.comp)
1.259     schwarze 2040:                return;
1.147     kristaps 2041:        if (MDOC_Bd == n->tok && n->norm->Bd.comp)
1.259     schwarze 2042:                return;
1.147     kristaps 2043:        if (MDOC_It == n->tok && n->parent->norm->Bl.comp)
1.259     schwarze 2044:                return;
1.188     schwarze 2045:
1.219     schwarze 2046:        mandoc_vmsg(MANDOCERR_PAR_SKIP, mdoc->parse,
                   2047:            mdoc->last->line, mdoc->last->pos,
                   2048:            "%s before %s", mdoc_macronames[mdoc->last->tok],
                   2049:            mdoc_macronames[n->tok]);
1.188     schwarze 2050:        mdoc_node_delete(mdoc, mdoc->last);
                   2051: }
                   2052:
1.259     schwarze 2053: static void
1.188     schwarze 2054: post_par(POST_ARGS)
                   2055: {
1.219     schwarze 2056:        struct mdoc_node *np;
1.188     schwarze 2057:
1.269     schwarze 2058:        np = mdoc->last;
1.242     schwarze 2059:
1.269     schwarze 2060:        if (np->tok == MDOC_sp) {
                   2061:                if (np->nchild > 1)
                   2062:                        mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   2063:                            np->child->next->line, np->child->next->pos,
                   2064:                            "sp ... %s", np->child->next->string);
                   2065:        } else if (np->child != NULL)
                   2066:                mandoc_vmsg(MANDOCERR_ARG_SKIP,
                   2067:                    mdoc->parse, np->line, np->pos, "%s %s",
                   2068:                    mdoc_macronames[np->tok], np->child->string);
1.188     schwarze 2069:
1.219     schwarze 2070:        if (NULL == (np = mdoc->last->prev)) {
                   2071:                np = mdoc->last->parent;
                   2072:                if (MDOC_Sh != np->tok && MDOC_Ss != np->tok)
1.259     schwarze 2073:                        return;
                   2074:        } else if (MDOC_Pp != np->tok && MDOC_Lp != np->tok &&
                   2075:            (MDOC_br != mdoc->last->tok ||
                   2076:             (MDOC_sp != np->tok && MDOC_br != np->tok)))
                   2077:                return;
1.117     kristaps 2078:
1.219     schwarze 2079:        mandoc_vmsg(MANDOCERR_PAR_SKIP, mdoc->parse,
                   2080:            mdoc->last->line, mdoc->last->pos,
                   2081:            "%s after %s", mdoc_macronames[mdoc->last->tok],
                   2082:            mdoc_macronames[np->tok]);
1.117     kristaps 2083:        mdoc_node_delete(mdoc, mdoc->last);
1.128     kristaps 2084: }
                   2085:
1.259     schwarze 2086: static void
1.128     kristaps 2087: pre_literal(PRE_ARGS)
                   2088: {
1.241     schwarze 2089:
                   2090:        pre_display(mdoc, n);
1.128     kristaps 2091:
1.284   ! schwarze 2092:        if (n->type != ROFFT_BODY)
1.259     schwarze 2093:                return;
1.128     kristaps 2094:
                   2095:        /*
                   2096:         * The `Dl' (note "el" not "one") and `Bd -literal' and `Bd
                   2097:         * -unfilled' macros set MDOC_LITERAL on entrance to the body.
                   2098:         */
                   2099:
                   2100:        switch (n->tok) {
1.210     schwarze 2101:        case MDOC_Dl:
1.128     kristaps 2102:                mdoc->flags |= MDOC_LITERAL;
                   2103:                break;
1.210     schwarze 2104:        case MDOC_Bd:
1.147     kristaps 2105:                if (DISP_literal == n->norm->Bd.type)
1.128     kristaps 2106:                        mdoc->flags |= MDOC_LITERAL;
1.147     kristaps 2107:                if (DISP_unfilled == n->norm->Bd.type)
1.128     kristaps 2108:                        mdoc->flags |= MDOC_LITERAL;
                   2109:                break;
                   2110:        default:
                   2111:                abort();
                   2112:                /* NOTREACHED */
                   2113:        }
1.1       kristaps 2114: }
1.132     kristaps 2115:
1.259     schwarze 2116: static void
1.132     kristaps 2117: post_dd(POST_ARGS)
                   2118: {
                   2119:        struct mdoc_node *n;
1.205     schwarze 2120:        char             *datestr;
1.132     kristaps 2121:
1.158     schwarze 2122:        if (mdoc->meta.date)
                   2123:                free(mdoc->meta.date);
                   2124:
1.132     kristaps 2125:        n = mdoc->last;
1.158     schwarze 2126:        if (NULL == n->child || '\0' == n->child->string[0]) {
1.200     schwarze 2127:                mdoc->meta.date = mdoc->quick ? mandoc_strdup("") :
                   2128:                    mandoc_normdate(mdoc->parse, NULL, n->line, n->pos);
1.243     schwarze 2129:                goto out;
1.132     kristaps 2130:        }
                   2131:
1.205     schwarze 2132:        datestr = NULL;
                   2133:        mdoc_deroff(&datestr, n);
                   2134:        if (mdoc->quick)
                   2135:                mdoc->meta.date = datestr;
                   2136:        else {
                   2137:                mdoc->meta.date = mandoc_normdate(mdoc->parse,
                   2138:                    datestr, n->line, n->pos);
                   2139:                free(datestr);
1.173     kristaps 2140:        }
1.243     schwarze 2141: out:
                   2142:        mdoc_node_delete(mdoc, n);
1.132     kristaps 2143: }
                   2144:
1.259     schwarze 2145: static void
1.132     kristaps 2146: post_dt(POST_ARGS)
                   2147: {
                   2148:        struct mdoc_node *nn, *n;
                   2149:        const char       *cp;
                   2150:        char             *p;
                   2151:
                   2152:        n = mdoc->last;
                   2153:
1.243     schwarze 2154:        free(mdoc->meta.title);
                   2155:        free(mdoc->meta.msec);
                   2156:        free(mdoc->meta.vol);
                   2157:        free(mdoc->meta.arch);
                   2158:
                   2159:        mdoc->meta.title = NULL;
                   2160:        mdoc->meta.msec = NULL;
                   2161:        mdoc->meta.vol = NULL;
                   2162:        mdoc->meta.arch = NULL;
1.132     kristaps 2163:
1.280     schwarze 2164:        /* Mandatory first argument: title. */
1.132     kristaps 2165:
1.280     schwarze 2166:        nn = n->child;
                   2167:        if (nn == NULL || *nn->string == '\0') {
1.243     schwarze 2168:                mandoc_msg(MANDOCERR_DT_NOTITLE,
                   2169:                    mdoc->parse, n->line, n->pos, "Dt");
                   2170:                mdoc->meta.title = mandoc_strdup("UNTITLED");
1.280     schwarze 2171:        } else {
                   2172:                mdoc->meta.title = mandoc_strdup(nn->string);
                   2173:
                   2174:                /* Check that all characters are uppercase. */
                   2175:
                   2176:                for (p = nn->string; *p != '\0'; p++)
                   2177:                        if (islower((unsigned char)*p)) {
                   2178:                                mandoc_vmsg(MANDOCERR_TITLE_CASE,
                   2179:                                    mdoc->parse, nn->line,
                   2180:                                    nn->pos + (p - nn->string),
                   2181:                                    "Dt %s", nn->string);
                   2182:                                break;
                   2183:                        }
1.132     kristaps 2184:        }
                   2185:
1.280     schwarze 2186:        /* Mandatory second argument: section. */
1.132     kristaps 2187:
1.280     schwarze 2188:        if (nn != NULL)
                   2189:                nn = nn->next;
1.132     kristaps 2190:
1.280     schwarze 2191:        if (nn == NULL) {
1.243     schwarze 2192:                mandoc_vmsg(MANDOCERR_MSEC_MISSING,
                   2193:                    mdoc->parse, n->line, n->pos,
                   2194:                    "Dt %s", mdoc->meta.title);
1.132     kristaps 2195:                mdoc->meta.vol = mandoc_strdup("LOCAL");
1.280     schwarze 2196:                goto out;  /* msec and arch remain NULL. */
1.132     kristaps 2197:        }
                   2198:
1.280     schwarze 2199:        mdoc->meta.msec = mandoc_strdup(nn->string);
                   2200:
                   2201:        /* Infer volume title from section number. */
1.132     kristaps 2202:
1.180     schwarze 2203:        cp = mandoc_a2msec(nn->string);
1.280     schwarze 2204:        if (cp == NULL) {
1.239     schwarze 2205:                mandoc_vmsg(MANDOCERR_MSEC_BAD, mdoc->parse,
                   2206:                    nn->line, nn->pos, "Dt ... %s", nn->string);
1.132     kristaps 2207:                mdoc->meta.vol = mandoc_strdup(nn->string);
1.280     schwarze 2208:        } else
                   2209:                mdoc->meta.vol = mandoc_strdup(cp);
                   2210:
                   2211:        /* Optional third argument: architecture. */
                   2212:
                   2213:        if ((nn = nn->next) == NULL)
                   2214:                goto out;
                   2215:
                   2216:        for (p = nn->string; *p != '\0'; p++)
                   2217:                *p = tolower((unsigned char)*p);
                   2218:        mdoc->meta.arch = mandoc_strdup(nn->string);
1.132     kristaps 2219:
1.280     schwarze 2220:        /* Ignore fourth and later arguments. */
1.132     kristaps 2221:
1.280     schwarze 2222:        if ((nn = nn->next) != NULL)
                   2223:                mandoc_vmsg(MANDOCERR_ARG_EXCESS, mdoc->parse,
                   2224:                    nn->line, nn->pos, "Dt ... %s", nn->string);
1.132     kristaps 2225:
1.243     schwarze 2226: out:
                   2227:        mdoc_node_delete(mdoc, n);
1.154     kristaps 2228: }
                   2229:
1.259     schwarze 2230: static void
1.154     kristaps 2231: post_bx(POST_ARGS)
                   2232: {
                   2233:        struct mdoc_node        *n;
                   2234:
1.210     schwarze 2235:        /*
1.154     kristaps 2236:         * Make `Bx's second argument always start with an uppercase
                   2237:         * letter.  Groff checks if it's an "accepted" term, but we just
                   2238:         * uppercase blindly.
                   2239:         */
                   2240:
                   2241:        n = mdoc->last->child;
                   2242:        if (n && NULL != (n = n->next))
1.210     schwarze 2243:                *n->string = (char)toupper((unsigned char)*n->string);
1.132     kristaps 2244: }
                   2245:
1.259     schwarze 2246: static void
1.132     kristaps 2247: post_os(POST_ARGS)
                   2248: {
                   2249: #ifndef OSNAME
                   2250:        struct utsname    utsname;
1.201     schwarze 2251:        static char      *defbuf;
1.132     kristaps 2252: #endif
1.201     schwarze 2253:        struct mdoc_node *n;
1.132     kristaps 2254:
                   2255:        n = mdoc->last;
                   2256:
                   2257:        /*
1.184     schwarze 2258:         * Set the operating system by way of the `Os' macro.
                   2259:         * The order of precedence is:
                   2260:         * 1. the argument of the `Os' macro, unless empty
                   2261:         * 2. the -Ios=foo command line argument, if provided
                   2262:         * 3. -DOSNAME="\"foo\"", if provided during compilation
                   2263:         * 4. "sysname release" from uname(3)
1.210     schwarze 2264:         */
1.132     kristaps 2265:
1.184     schwarze 2266:        free(mdoc->meta.os);
1.205     schwarze 2267:        mdoc->meta.os = NULL;
                   2268:        mdoc_deroff(&mdoc->meta.os, n);
                   2269:        if (mdoc->meta.os)
1.243     schwarze 2270:                goto out;
1.201     schwarze 2271:
                   2272:        if (mdoc->defos) {
                   2273:                mdoc->meta.os = mandoc_strdup(mdoc->defos);
1.243     schwarze 2274:                goto out;
1.201     schwarze 2275:        }
                   2276:
1.132     kristaps 2277: #ifdef OSNAME
1.201     schwarze 2278:        mdoc->meta.os = mandoc_strdup(OSNAME);
1.132     kristaps 2279: #else /*!OSNAME */
1.201     schwarze 2280:        if (NULL == defbuf) {
1.166     kristaps 2281:                if (-1 == uname(&utsname)) {
1.233     schwarze 2282:                        mandoc_msg(MANDOCERR_OS_UNAME, mdoc->parse,
                   2283:                            n->line, n->pos, "Os");
1.210     schwarze 2284:                        defbuf = mandoc_strdup("UNKNOWN");
                   2285:                } else
1.204     schwarze 2286:                        mandoc_asprintf(&defbuf, "%s %s",
                   2287:                            utsname.sysname, utsname.release);
1.201     schwarze 2288:        }
                   2289:        mdoc->meta.os = mandoc_strdup(defbuf);
1.132     kristaps 2290: #endif /*!OSNAME*/
1.243     schwarze 2291:
                   2292: out:
                   2293:        mdoc_node_delete(mdoc, n);
1.132     kristaps 2294: }
                   2295:
1.232     schwarze 2296: /*
                   2297:  * If no argument is provided,
                   2298:  * fill in the name of the current manual page.
                   2299:  */
1.259     schwarze 2300: static void
1.232     schwarze 2301: post_ex(POST_ARGS)
1.132     kristaps 2302: {
1.232     schwarze 2303:        struct mdoc_node *n;
1.132     kristaps 2304:
                   2305:        n = mdoc->last;
                   2306:
                   2307:        if (n->child)
1.259     schwarze 2308:                return;
1.133     kristaps 2309:
1.232     schwarze 2310:        if (mdoc->meta.name == NULL) {
1.239     schwarze 2311:                mandoc_msg(MANDOCERR_EX_NONAME, mdoc->parse,
                   2312:                    n->line, n->pos, "Ex");
1.259     schwarze 2313:                return;
1.232     schwarze 2314:        }
1.210     schwarze 2315:
1.132     kristaps 2316:        mdoc->next = MDOC_NEXT_CHILD;
1.259     schwarze 2317:        mdoc_word_alloc(mdoc, n->line, n->pos, mdoc->meta.name);
1.232     schwarze 2318:        mdoc->last = n;
1.160     kristaps 2319: }
                   2320:
1.210     schwarze 2321: static enum mdoc_sec
1.160     kristaps 2322: a2sec(const char *p)
                   2323: {
                   2324:        int              i;
                   2325:
1.210     schwarze 2326:        for (i = 0; i < (int)SEC__MAX; i++)
1.160     kristaps 2327:                if (secnames[i] && 0 == strcmp(p, secnames[i]))
                   2328:                        return((enum mdoc_sec)i);
                   2329:
                   2330:        return(SEC_CUSTOM);
1.132     kristaps 2331: }
                   2332:
1.161     kristaps 2333: static size_t
                   2334: macro2len(enum mdoct macro)
                   2335: {
                   2336:
                   2337:        switch (macro) {
1.210     schwarze 2338:        case MDOC_Ad:
1.161     kristaps 2339:                return(12);
1.210     schwarze 2340:        case MDOC_Ao:
1.161     kristaps 2341:                return(12);
1.210     schwarze 2342:        case MDOC_An:
1.161     kristaps 2343:                return(12);
1.210     schwarze 2344:        case MDOC_Aq:
1.161     kristaps 2345:                return(12);
1.210     schwarze 2346:        case MDOC_Ar:
1.161     kristaps 2347:                return(12);
1.210     schwarze 2348:        case MDOC_Bo:
1.161     kristaps 2349:                return(12);
1.210     schwarze 2350:        case MDOC_Bq:
1.161     kristaps 2351:                return(12);
1.210     schwarze 2352:        case MDOC_Cd:
1.161     kristaps 2353:                return(12);
1.210     schwarze 2354:        case MDOC_Cm:
1.161     kristaps 2355:                return(10);
1.210     schwarze 2356:        case MDOC_Do:
1.161     kristaps 2357:                return(10);
1.210     schwarze 2358:        case MDOC_Dq:
1.161     kristaps 2359:                return(12);
1.210     schwarze 2360:        case MDOC_Dv:
1.161     kristaps 2361:                return(12);
1.210     schwarze 2362:        case MDOC_Eo:
1.161     kristaps 2363:                return(12);
1.210     schwarze 2364:        case MDOC_Em:
1.161     kristaps 2365:                return(10);
1.210     schwarze 2366:        case MDOC_Er:
1.161     kristaps 2367:                return(17);
1.210     schwarze 2368:        case MDOC_Ev:
1.161     kristaps 2369:                return(15);
1.210     schwarze 2370:        case MDOC_Fa:
1.161     kristaps 2371:                return(12);
1.210     schwarze 2372:        case MDOC_Fl:
1.161     kristaps 2373:                return(10);
1.210     schwarze 2374:        case MDOC_Fo:
1.161     kristaps 2375:                return(16);
1.210     schwarze 2376:        case MDOC_Fn:
1.161     kristaps 2377:                return(16);
1.210     schwarze 2378:        case MDOC_Ic:
1.161     kristaps 2379:                return(10);
1.210     schwarze 2380:        case MDOC_Li:
1.161     kristaps 2381:                return(16);
1.210     schwarze 2382:        case MDOC_Ms:
1.161     kristaps 2383:                return(6);
1.210     schwarze 2384:        case MDOC_Nm:
1.161     kristaps 2385:                return(10);
1.210     schwarze 2386:        case MDOC_No:
1.161     kristaps 2387:                return(12);
1.210     schwarze 2388:        case MDOC_Oo:
1.161     kristaps 2389:                return(10);
1.210     schwarze 2390:        case MDOC_Op:
1.161     kristaps 2391:                return(14);
1.210     schwarze 2392:        case MDOC_Pa:
1.161     kristaps 2393:                return(32);
1.210     schwarze 2394:        case MDOC_Pf:
1.161     kristaps 2395:                return(12);
1.210     schwarze 2396:        case MDOC_Po:
1.161     kristaps 2397:                return(12);
1.210     schwarze 2398:        case MDOC_Pq:
1.161     kristaps 2399:                return(12);
1.210     schwarze 2400:        case MDOC_Ql:
1.161     kristaps 2401:                return(16);
1.210     schwarze 2402:        case MDOC_Qo:
1.161     kristaps 2403:                return(12);
1.210     schwarze 2404:        case MDOC_So:
1.161     kristaps 2405:                return(12);
1.210     schwarze 2406:        case MDOC_Sq:
1.161     kristaps 2407:                return(12);
1.210     schwarze 2408:        case MDOC_Sy:
1.161     kristaps 2409:                return(6);
1.210     schwarze 2410:        case MDOC_Sx:
1.161     kristaps 2411:                return(16);
1.210     schwarze 2412:        case MDOC_Tn:
1.161     kristaps 2413:                return(10);
1.210     schwarze 2414:        case MDOC_Va:
1.161     kristaps 2415:                return(12);
1.210     schwarze 2416:        case MDOC_Vt:
1.161     kristaps 2417:                return(12);
1.210     schwarze 2418:        case MDOC_Xr:
1.161     kristaps 2419:                return(10);
                   2420:        default:
                   2421:                break;
                   2422:        };
                   2423:        return(0);
                   2424: }

CVSweb