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

Annotation of mandoc/mdoc_man.c, Revision 1.23

1.23    ! schwarze    1: /*     $Id: mdoc_man.c,v 1.22 2012/07/08 16:52:20 schwarze Exp $ */
1.1       schwarze    2: /*
1.11      schwarze    3:  * Copyright (c) 2011, 2012 Ingo Schwarze <schwarze@openbsd.org>
1.1       schwarze    4:  *
                      5:  * Permission to use, copy, modify, and distribute this software for any
                      6:  * purpose with or without fee is hereby granted, provided that the above
                      7:  * copyright notice and this permission notice appear in all copies.
                      8:  *
                      9:  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
                     10:  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
                     11:  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
                     12:  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
                     13:  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
                     14:  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
                     15:  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
                     16:  */
1.7       kristaps   17: #ifdef HAVE_CONFIG_H
                     18: #include "config.h"
                     19: #endif
                     20:
1.12      schwarze   21: #include <assert.h>
1.1       schwarze   22: #include <stdio.h>
                     23: #include <string.h>
                     24:
                     25: #include "mandoc.h"
1.11      schwarze   26: #include "out.h"
1.4       kristaps   27: #include "man.h"
1.1       schwarze   28: #include "mdoc.h"
                     29: #include "main.h"
                     30:
1.5       kristaps   31: #define        DECL_ARGS const struct mdoc_meta *m, \
1.20      schwarze   32:                  const struct mdoc_node *n
1.1       schwarze   33:
                     34: struct manact {
1.5       kristaps   35:        int             (*cond)(DECL_ARGS); /* DON'T run actions */
                     36:        int             (*pre)(DECL_ARGS); /* pre-node action */
                     37:        void            (*post)(DECL_ARGS); /* post-node action */
                     38:        const char       *prefix; /* pre-node string constant */
                     39:        const char       *suffix; /* post-node string constant */
1.1       schwarze   40: };
                     41:
1.5       kristaps   42: static int       cond_body(DECL_ARGS);
1.1       schwarze   43: static int       cond_head(DECL_ARGS);
1.5       kristaps   44: static void      post_bd(DECL_ARGS);
1.13      schwarze   45: static void      post_bk(DECL_ARGS);
1.5       kristaps   46: static void      post_dl(DECL_ARGS);
1.1       schwarze   47: static void      post_enc(DECL_ARGS);
1.17      schwarze   48: static void      post_fa(DECL_ARGS);
1.16      schwarze   49: static void      post_fn(DECL_ARGS);
1.17      schwarze   50: static void      post_fo(DECL_ARGS);
1.15      schwarze   51: static void      post_in(DECL_ARGS);
1.14      schwarze   52: static void      post_lb(DECL_ARGS);
1.5       kristaps   53: static void      post_nm(DECL_ARGS);
1.1       schwarze   54: static void      post_percent(DECL_ARGS);
1.5       kristaps   55: static void      post_pf(DECL_ARGS);
1.3       schwarze   56: static void      post_sect(DECL_ARGS);
1.5       kristaps   57: static void      post_sp(DECL_ARGS);
1.18      schwarze   58: static void      post_vt(DECL_ARGS);
1.22      schwarze   59: static int       pre_an(DECL_ARGS);
1.3       schwarze   60: static int       pre_ap(DECL_ARGS);
                     61: static int       pre_bd(DECL_ARGS);
1.13      schwarze   62: static int       pre_bk(DECL_ARGS);
1.3       schwarze   63: static int       pre_br(DECL_ARGS);
1.8       schwarze   64: static int       pre_bx(DECL_ARGS);
1.1       schwarze   65: static int       pre_dl(DECL_ARGS);
1.5       kristaps   66: static int       pre_enc(DECL_ARGS);
1.17      schwarze   67: static int       pre_fa(DECL_ARGS);
1.16      schwarze   68: static int       pre_fn(DECL_ARGS);
1.17      schwarze   69: static int       pre_fo(DECL_ARGS);
1.23    ! schwarze   70: static int       pre_ft(DECL_ARGS);
1.15      schwarze   71: static int       pre_in(DECL_ARGS);
1.1       schwarze   72: static int       pre_it(DECL_ARGS);
                     73: static int       pre_nm(DECL_ARGS);
                     74: static int       pre_ns(DECL_ARGS);
                     75: static int       pre_pp(DECL_ARGS);
1.12      schwarze   76: static int       pre_sm(DECL_ARGS);
1.3       schwarze   77: static int       pre_sp(DECL_ARGS);
1.5       kristaps   78: static int       pre_sect(DECL_ARGS);
1.23    ! schwarze   79: static void      pre_syn(const struct mdoc_node *);
1.18      schwarze   80: static int       pre_vt(DECL_ARGS);
1.8       schwarze   81: static int       pre_ux(DECL_ARGS);
1.1       schwarze   82: static int       pre_xr(DECL_ARGS);
1.20      schwarze   83: static void      print_word(const char *);
                     84: static void      print_offs(const char *);
1.5       kristaps   85: static void      print_node(DECL_ARGS);
1.1       schwarze   86:
1.3       schwarze   87: static const struct manact manacts[MDOC_MAX + 1] = {
                     88:        { NULL, pre_ap, NULL, NULL, NULL }, /* Ap */
                     89:        { NULL, NULL, NULL, NULL, NULL }, /* Dd */
                     90:        { NULL, NULL, NULL, NULL, NULL }, /* Dt */
1.8       schwarze   91:        { NULL, NULL, NULL, NULL, NULL }, /* Os */
1.3       schwarze   92:        { NULL, pre_sect, post_sect, ".SH", NULL }, /* Sh */
                     93:        { NULL, pre_sect, post_sect, ".SS", NULL }, /* Ss */
1.1       schwarze   94:        { NULL, pre_pp, NULL, NULL, NULL }, /* Pp */
1.3       schwarze   95:        { cond_body, pre_dl, post_dl, NULL, NULL }, /* D1 */
1.1       schwarze   96:        { cond_body, pre_dl, post_dl, NULL, NULL }, /* Dl */
1.3       schwarze   97:        { cond_body, pre_bd, post_bd, NULL, NULL }, /* Bd */
                     98:        { NULL, NULL, NULL, NULL, NULL }, /* Ed */
                     99:        { NULL, NULL, NULL, NULL, NULL }, /* Bl */
                    100:        { NULL, NULL, NULL, NULL, NULL }, /* El */
1.1       schwarze  101:        { NULL, pre_it, NULL, NULL, NULL }, /* _It */
1.9       schwarze  102:        { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Ad */
1.22      schwarze  103:        { NULL, pre_an, NULL, NULL, NULL }, /* An */
1.1       schwarze  104:        { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Ar */
1.9       schwarze  105:        { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Cd */
1.1       schwarze  106:        { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Cm */
1.9       schwarze  107:        { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Dv */
                    108:        { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Er */
                    109:        { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Ev */
1.1       schwarze  110:        { NULL, pre_enc, post_enc, "The \\fB",
                    111:            "\\fP\nutility exits 0 on success, and >0 if an error occurs."
                    112:            }, /* Ex */
1.17      schwarze  113:        { NULL, pre_fa, post_fa, NULL, NULL }, /* Fa */
1.1       schwarze  114:        { NULL, NULL, NULL, NULL, NULL }, /* _Fd */
                    115:        { NULL, pre_enc, post_enc, "\\fB-", "\\fP" }, /* Fl */
1.16      schwarze  116:        { NULL, pre_fn, post_fn, NULL, NULL }, /* Fn */
1.23    ! schwarze  117:        { NULL, pre_ft, post_enc, NULL, "\\fP" }, /* Ft */
1.3       schwarze  118:        { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Ic */
1.15      schwarze  119:        { NULL, pre_in, post_in, NULL, NULL }, /* In */
1.9       schwarze  120:        { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Li */
1.1       schwarze  121:        { cond_head, pre_enc, NULL, "\\- ", NULL }, /* Nd */
                    122:        { NULL, pre_nm, post_nm, NULL, NULL }, /* Nm */
                    123:        { cond_body, pre_enc, post_enc, "[", "]" }, /* Op */
1.8       schwarze  124:        { NULL, NULL, NULL, NULL, NULL }, /* Ot */
                    125:        { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Pa */
1.6       kristaps  126:        { NULL, pre_enc, post_enc, "The \\fB",
                    127:                "\\fP\nfunction returns the value 0 if successful;\n"
                    128:                "otherwise the value -1 is returned and the global\n"
                    129:                "variable \\fIerrno\\fP is set to indicate the error."
                    130:                }, /* Rv */
1.8       schwarze  131:        { NULL, NULL, NULL, NULL, NULL }, /* St */
1.19      schwarze  132:        { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Va */
1.18      schwarze  133:        { NULL, pre_vt, post_vt, NULL, NULL }, /* Vt */
1.8       schwarze  134:        { NULL, pre_xr, NULL, NULL, NULL }, /* Xr */
1.1       schwarze  135:        { NULL, NULL, post_percent, NULL, NULL }, /* _%A */
                    136:        { NULL, NULL, NULL, NULL, NULL }, /* _%B */
                    137:        { NULL, NULL, post_percent, NULL, NULL }, /* _%D */
                    138:        { NULL, NULL, NULL, NULL, NULL }, /* _%I */
                    139:        { NULL, pre_enc, post_percent, "\\fI", "\\fP" }, /* %J */
                    140:        { NULL, NULL, NULL, NULL, NULL }, /* _%N */
                    141:        { NULL, NULL, NULL, NULL, NULL }, /* _%O */
                    142:        { NULL, NULL, NULL, NULL, NULL }, /* _%P */
                    143:        { NULL, NULL, NULL, NULL, NULL }, /* _%R */
                    144:        { NULL, pre_enc, post_percent, "\"", "\"" }, /* %T */
                    145:        { NULL, NULL, NULL, NULL, NULL }, /* _%V */
1.9       schwarze  146:        { NULL, NULL, NULL, NULL, NULL }, /* Ac */
                    147:        { cond_body, pre_enc, post_enc, "<", ">" }, /* Ao */
1.1       schwarze  148:        { cond_body, pre_enc, post_enc, "<", ">" }, /* Aq */
1.8       schwarze  149:        { NULL, NULL, NULL, NULL, NULL }, /* At */
1.3       schwarze  150:        { NULL, NULL, NULL, NULL, NULL }, /* Bc */
1.1       schwarze  151:        { NULL, NULL, NULL, NULL, NULL }, /* _Bf */
1.3       schwarze  152:        { cond_body, pre_enc, post_enc, "[", "]" }, /* Bo */
                    153:        { cond_body, pre_enc, post_enc, "[", "]" }, /* Bq */
1.8       schwarze  154:        { NULL, pre_ux, NULL, "BSD/OS", NULL }, /* Bsx */
                    155:        { NULL, pre_bx, NULL, NULL, NULL }, /* Bx */
                    156:        { NULL, NULL, NULL, NULL, NULL }, /* Db */
1.9       schwarze  157:        { NULL, NULL, NULL, NULL, NULL }, /* Dc */
                    158:        { cond_body, pre_enc, post_enc, "``", "''" }, /* Do */
1.1       schwarze  159:        { cond_body, pre_enc, post_enc, "``", "''" }, /* Dq */
                    160:        { NULL, NULL, NULL, NULL, NULL }, /* _Ec */
                    161:        { NULL, NULL, NULL, NULL, NULL }, /* _Ef */
1.3       schwarze  162:        { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Em */
1.1       schwarze  163:        { NULL, NULL, NULL, NULL, NULL }, /* _Eo */
1.8       schwarze  164:        { NULL, pre_ux, NULL, "FreeBSD", NULL }, /* Fx */
1.9       schwarze  165:        { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Ms */
                    166:        { NULL, NULL, NULL, NULL, NULL }, /* No */
1.1       schwarze  167:        { NULL, pre_ns, NULL, NULL, NULL }, /* Ns */
1.8       schwarze  168:        { NULL, pre_ux, NULL, "NetBSD", NULL }, /* Nx */
                    169:        { NULL, pre_ux, NULL, "OpenBSD", NULL }, /* Ox */
1.3       schwarze  170:        { NULL, NULL, NULL, NULL, NULL }, /* Pc */
                    171:        { NULL, NULL, post_pf, NULL, NULL }, /* Pf */
                    172:        { cond_body, pre_enc, post_enc, "(", ")" }, /* Po */
                    173:        { cond_body, pre_enc, post_enc, "(", ")" }, /* Pq */
1.9       schwarze  174:        { NULL, NULL, NULL, NULL, NULL }, /* Qc */
1.1       schwarze  175:        { cond_body, pre_enc, post_enc, "`", "'" }, /* Ql */
1.9       schwarze  176:        { cond_body, pre_enc, post_enc, "\"", "\"" }, /* Qo */
                    177:        { cond_body, pre_enc, post_enc, "\"", "\"" }, /* Qq */
                    178:        { NULL, NULL, NULL, NULL, NULL }, /* Re */
1.1       schwarze  179:        { cond_body, pre_pp, NULL, NULL, NULL }, /* Rs */
1.9       schwarze  180:        { NULL, NULL, NULL, NULL, NULL }, /* Sc */
                    181:        { cond_body, pre_enc, post_enc, "`", "'" }, /* So */
1.1       schwarze  182:        { cond_body, pre_enc, post_enc, "`", "'" }, /* Sq */
1.12      schwarze  183:        { NULL, pre_sm, NULL, NULL, NULL }, /* Sm */
1.3       schwarze  184:        { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Sx */
                    185:        { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Sy */
1.9       schwarze  186:        { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Tn */
1.8       schwarze  187:        { NULL, pre_ux, NULL, "UNIX", NULL }, /* Ux */
1.1       schwarze  188:        { NULL, NULL, NULL, NULL, NULL }, /* _Xc */
                    189:        { NULL, NULL, NULL, NULL, NULL }, /* _Xo */
1.17      schwarze  190:        { NULL, pre_fo, post_fo, NULL, NULL }, /* Fo */
                    191:        { NULL, NULL, NULL, NULL, NULL }, /* Fc */
1.3       schwarze  192:        { cond_body, pre_enc, post_enc, "[", "]" }, /* Oo */
1.9       schwarze  193:        { NULL, NULL, NULL, NULL, NULL }, /* Oc */
1.13      schwarze  194:        { NULL, pre_bk, post_bk, NULL, NULL }, /* Bk */
                    195:        { NULL, NULL, NULL, NULL, NULL }, /* Ek */
1.8       schwarze  196:        { NULL, pre_ux, NULL, "is currently in beta test.", NULL }, /* Bt */
                    197:        { NULL, NULL, NULL, NULL, NULL }, /* Hf */
                    198:        { NULL, NULL, NULL, NULL, NULL }, /* Fr */
                    199:        { NULL, pre_ux, NULL, "currently under development.", NULL }, /* Ud */
1.14      schwarze  200:        { NULL, NULL, post_lb, NULL, NULL }, /* Lb */
1.3       schwarze  201:        { NULL, pre_pp, NULL, NULL, NULL }, /* Lp */
1.1       schwarze  202:        { NULL, NULL, NULL, NULL, NULL }, /* _Lk */
                    203:        { NULL, NULL, NULL, NULL, NULL }, /* _Mt */
1.9       schwarze  204:        { cond_body, pre_enc, post_enc, "{", "}" }, /* Brq */
                    205:        { cond_body, pre_enc, post_enc, "{", "}" }, /* Bro */
                    206:        { NULL, NULL, NULL, NULL, NULL }, /* Brc */
1.1       schwarze  207:        { NULL, NULL, NULL, NULL, NULL }, /* _%C */
                    208:        { NULL, NULL, NULL, NULL, NULL }, /* _Es */
                    209:        { NULL, NULL, NULL, NULL, NULL }, /* _En */
1.8       schwarze  210:        { NULL, pre_ux, NULL, "DragonFly", NULL }, /* Dx */
1.1       schwarze  211:        { NULL, NULL, NULL, NULL, NULL }, /* _%Q */
1.3       schwarze  212:        { NULL, pre_br, NULL, NULL, NULL }, /* br */
                    213:        { NULL, pre_sp, post_sp, NULL, NULL }, /* sp */
1.1       schwarze  214:        { NULL, NULL, NULL, NULL, NULL }, /* _%U */
                    215:        { NULL, NULL, NULL, NULL, NULL }, /* _Ta */
1.3       schwarze  216:        { NULL, NULL, NULL, NULL, NULL }, /* ROOT */
1.1       schwarze  217: };
                    218:
1.20      schwarze  219: static int             outflags;
                    220: #define        MMAN_spc        (1 << 0)
                    221: #define        MMAN_nl         (1 << 1)
1.21      schwarze  222: #define        MMAN_br         (1 << 2)
                    223: #define        MMAN_sp         (1 << 3)
                    224: #define        MMAN_Sm         (1 << 4)
                    225: #define        MMAN_Bk         (1 << 5)
1.22      schwarze  226: #define        MMAN_An_split   (1 << 6)
                    227: #define        MMAN_An_nosplit (1 << 7)
1.20      schwarze  228:
1.1       schwarze  229: static void
1.20      schwarze  230: print_word(const char *s)
1.1       schwarze  231: {
1.5       kristaps  232:
1.21      schwarze  233:        if ((MMAN_sp | MMAN_br | MMAN_nl) & outflags) {
1.5       kristaps  234:                /*
                    235:                 * If we need a newline, print it now and start afresh.
                    236:                 */
1.21      schwarze  237:                if (MMAN_sp & outflags)
                    238:                        printf("\n.sp\n");
                    239:                else if (MMAN_br & outflags)
                    240:                        printf("\n.br\n");
                    241:                else if (MMAN_nl & outflags)
                    242:                        putchar('\n');
                    243:                outflags &= ~(MMAN_sp|MMAN_br|MMAN_nl|MMAN_spc);
1.20      schwarze  244:        } else if (MMAN_spc & outflags && '\0' != s[0])
1.5       kristaps  245:                /*
                    246:                 * If we need a space, only print it before
                    247:                 * (1) a nonzero length word;
                    248:                 * (2) a word that is non-punctuation; and
                    249:                 * (3) if punctuation, non-terminating puncutation.
                    250:                 */
1.13      schwarze  251:                if (NULL == strchr(".,:;)]?!", s[0]) || '\0' != s[1]) {
1.20      schwarze  252:                        if (MMAN_Bk & outflags) {
1.13      schwarze  253:                                putchar('\\');
                    254:                                putchar('~');
                    255:                        } else
                    256:                                putchar(' ');
                    257:                }
1.5       kristaps  258:
                    259:        /*
                    260:         * Reassign needing space if we're not following opening
                    261:         * punctuation.
                    262:         */
1.20      schwarze  263:        if (MMAN_Sm & outflags &&
                    264:            (('(' != s[0] && '[' != s[0]) || '\0' != s[1]))
                    265:                outflags |= MMAN_spc;
                    266:        else
                    267:                outflags &= ~MMAN_spc;
1.5       kristaps  268:
1.1       schwarze  269:        for ( ; *s; s++) {
                    270:                switch (*s) {
                    271:                case (ASCII_NBRSP):
                    272:                        printf("\\~");
                    273:                        break;
                    274:                case (ASCII_HYPH):
                    275:                        putchar('-');
                    276:                        break;
                    277:                default:
1.5       kristaps  278:                        putchar((unsigned char)*s);
1.1       schwarze  279:                        break;
                    280:                }
                    281:        }
1.4       kristaps  282: }
                    283:
1.11      schwarze  284: static void
1.20      schwarze  285: print_offs(const char *v)
1.11      schwarze  286: {
                    287:        char              buf[24];
                    288:        struct roffsu     su;
                    289:        size_t            sz;
                    290:
                    291:        if (NULL == v || '\0' == *v || 0 == strcmp(v, "left"))
                    292:                sz = 0;
                    293:        else if (0 == strcmp(v, "indent"))
                    294:                sz = 6;
                    295:        else if (0 == strcmp(v, "indent-two"))
                    296:                sz = 12;
                    297:        else if (a2roffsu(v, &su, SCALE_MAX)) {
1.20      schwarze  298:                print_word(v);
1.11      schwarze  299:                return;
                    300:        } else
                    301:                sz = strlen(v);
                    302:
                    303:        snprintf(buf, sizeof(buf), "%ldn", sz);
1.20      schwarze  304:        print_word(buf);
1.11      schwarze  305: }
                    306:
1.4       kristaps  307: void
                    308: man_man(void *arg, const struct man *man)
                    309: {
                    310:
1.5       kristaps  311:        /*
                    312:         * Dump the keep buffer.
                    313:         * We're guaranteed by now that this exists (is non-NULL).
                    314:         * Flush stdout afterward, just in case.
                    315:         */
1.4       kristaps  316:        fputs(mparse_getkeep(man_mparse(man)), stdout);
1.5       kristaps  317:        fflush(stdout);
1.1       schwarze  318: }
                    319:
                    320: void
                    321: man_mdoc(void *arg, const struct mdoc *mdoc)
                    322: {
                    323:        const struct mdoc_meta *m;
                    324:        const struct mdoc_node *n;
                    325:
                    326:        m = mdoc_meta(mdoc);
                    327:        n = mdoc_node(mdoc);
                    328:
1.3       schwarze  329:        printf(".TH \"%s\" \"%s\" \"%s\" \"%s\" \"%s\"",
1.5       kristaps  330:                        m->title, m->msec, m->date, m->os, m->vol);
1.1       schwarze  331:
1.20      schwarze  332:        outflags = MMAN_nl | MMAN_Sm;
                    333:        print_node(m, n);
1.3       schwarze  334:        putchar('\n');
1.1       schwarze  335: }
                    336:
                    337: static void
                    338: print_node(DECL_ARGS)
                    339: {
                    340:        const struct mdoc_node  *prev, *sub;
1.5       kristaps  341:        const struct manact     *act;
1.1       schwarze  342:        int                      cond, do_sub;
1.5       kristaps  343:
                    344:        /*
                    345:         * Break the line if we were parsed subsequent the current node.
                    346:         * This makes the page structure be more consistent.
                    347:         */
1.1       schwarze  348:        prev = n->prev ? n->prev : n->parent;
1.17      schwarze  349:        if (prev && prev->line < n->line &&
                    350:            MDOC_Fo != prev->tok && MDOC_Ns != prev->tok)
1.20      schwarze  351:                outflags |= MMAN_nl;
1.1       schwarze  352:
1.5       kristaps  353:        act = NULL;
1.1       schwarze  354:        cond = 0;
                    355:        do_sub = 1;
1.5       kristaps  356:
1.1       schwarze  357:        if (MDOC_TEXT == n->type) {
1.5       kristaps  358:                /*
                    359:                 * Make sure that we don't happen to start with a
                    360:                 * control character at the start of a line.
                    361:                 */
1.20      schwarze  362:                if (MMAN_nl & outflags && ('.' == *n->string ||
1.5       kristaps  363:                                        '\'' == *n->string)) {
1.20      schwarze  364:                        print_word("\\&");
                    365:                        outflags &= ~MMAN_spc;
1.3       schwarze  366:                }
1.20      schwarze  367:                print_word(n->string);
1.1       schwarze  368:        } else {
1.5       kristaps  369:                /*
                    370:                 * Conditionally run the pre-node action handler for a
                    371:                 * node.
                    372:                 */
1.1       schwarze  373:                act = manacts + n->tok;
1.20      schwarze  374:                cond = NULL == act->cond || (*act->cond)(m, n);
1.1       schwarze  375:                if (cond && act->pre)
1.20      schwarze  376:                        do_sub = (*act->pre)(m, n);
1.1       schwarze  377:        }
                    378:
1.5       kristaps  379:        /*
                    380:         * Conditionally run all child nodes.
                    381:         * Note that this iterates over children instead of using
                    382:         * recursion.  This prevents unnecessary depth in the stack.
                    383:         */
1.1       schwarze  384:        if (do_sub)
                    385:                for (sub = n->child; sub; sub = sub->next)
1.20      schwarze  386:                        print_node(m, sub);
1.1       schwarze  387:
1.5       kristaps  388:        /*
                    389:         * Lastly, conditionally run the post-node handler.
                    390:         */
1.1       schwarze  391:        if (cond && act->post)
1.20      schwarze  392:                (*act->post)(m, n);
1.1       schwarze  393: }
                    394:
                    395: static int
                    396: cond_head(DECL_ARGS)
                    397: {
1.5       kristaps  398:
1.1       schwarze  399:        return(MDOC_HEAD == n->type);
                    400: }
                    401:
                    402: static int
                    403: cond_body(DECL_ARGS)
                    404: {
1.5       kristaps  405:
1.1       schwarze  406:        return(MDOC_BODY == n->type);
                    407: }
                    408:
1.5       kristaps  409: /*
                    410:  * Output a font encoding before a node, e.g., \fR.
                    411:  * This obviously has no trailing space.
                    412:  */
1.1       schwarze  413: static int
                    414: pre_enc(DECL_ARGS)
                    415: {
1.5       kristaps  416:        const char      *prefix;
1.1       schwarze  417:
                    418:        prefix = manacts[n->tok].prefix;
                    419:        if (NULL == prefix)
                    420:                return(1);
1.20      schwarze  421:        print_word(prefix);
                    422:        outflags &= ~MMAN_spc;
1.1       schwarze  423:        return(1);
                    424: }
                    425:
1.5       kristaps  426: /*
                    427:  * Output a font encoding subsequent a node, e.g., \fP.
                    428:  */
1.1       schwarze  429: static void
                    430: post_enc(DECL_ARGS)
                    431: {
                    432:        const char *suffix;
                    433:
                    434:        suffix = manacts[n->tok].suffix;
                    435:        if (NULL == suffix)
                    436:                return;
1.20      schwarze  437:        outflags &= ~MMAN_spc;
                    438:        print_word(suffix);
1.10      schwarze  439:        if (MDOC_Fl == n->tok && 0 == n->nchild)
1.20      schwarze  440:                outflags &= ~MMAN_spc;
1.1       schwarze  441: }
                    442:
1.5       kristaps  443: /*
                    444:  * Used in listings (percent = %A, e.g.).
                    445:  * FIXME: this is incomplete.
                    446:  * It doesn't print a nice ", and" for lists.
                    447:  */
1.1       schwarze  448: static void
                    449: post_percent(DECL_ARGS)
                    450: {
                    451:
1.20      schwarze  452:        post_enc(m, n);
1.1       schwarze  453:        if (n->next)
1.20      schwarze  454:                print_word(",");
1.1       schwarze  455:        else {
1.20      schwarze  456:                print_word(".");
                    457:                outflags |= MMAN_nl;
1.1       schwarze  458:        }
                    459: }
                    460:
1.5       kristaps  461: /*
                    462:  * Print before a section header.
                    463:  */
1.1       schwarze  464: static int
1.3       schwarze  465: pre_sect(DECL_ARGS)
                    466: {
                    467:
                    468:        if (MDOC_HEAD != n->type)
                    469:                return(1);
1.20      schwarze  470:        outflags |= MMAN_nl;
                    471:        print_word(manacts[n->tok].prefix);
                    472:        print_word("\"");
                    473:        outflags &= ~MMAN_spc;
1.3       schwarze  474:        return(1);
                    475: }
                    476:
1.5       kristaps  477: /*
                    478:  * Print subsequent a section header.
                    479:  */
1.3       schwarze  480: static void
                    481: post_sect(DECL_ARGS)
                    482: {
                    483:
                    484:        if (MDOC_HEAD != n->type)
                    485:                return;
1.20      schwarze  486:        outflags &= ~MMAN_spc;
                    487:        print_word("\"");
                    488:        outflags |= MMAN_nl;
1.22      schwarze  489:        if (MDOC_Sh == n->tok && SEC_AUTHORS == n->sec)
                    490:                outflags &= ~(MMAN_An_split | MMAN_An_nosplit);
                    491: }
                    492:
1.23    ! schwarze  493: /* See mdoc_term.c, synopsis_pre() for comments. */
        !           494: static void
        !           495: pre_syn(const struct mdoc_node *n)
        !           496: {
        !           497:
        !           498:        if (NULL == n->prev || ! (MDOC_SYNPRETTY & n->flags))
        !           499:                return;
        !           500:
        !           501:        if (n->prev->tok == n->tok &&
        !           502:                        MDOC_Ft != n->tok &&
        !           503:                        MDOC_Fo != n->tok &&
        !           504:                        MDOC_Fn != n->tok) {
        !           505:                outflags |= MMAN_br;
        !           506:                return;
        !           507:        }
        !           508:
        !           509:        switch (n->prev->tok) {
        !           510:        case (MDOC_Fd):
        !           511:                /* FALLTHROUGH */
        !           512:        case (MDOC_Fn):
        !           513:                /* FALLTHROUGH */
        !           514:        case (MDOC_Fo):
        !           515:                /* FALLTHROUGH */
        !           516:        case (MDOC_In):
        !           517:                /* FALLTHROUGH */
        !           518:        case (MDOC_Vt):
        !           519:                outflags |= MMAN_sp;
        !           520:                break;
        !           521:        case (MDOC_Ft):
        !           522:                if (MDOC_Fn != n->tok && MDOC_Fo != n->tok) {
        !           523:                        outflags |= MMAN_sp;
        !           524:                        break;
        !           525:                }
        !           526:                /* FALLTHROUGH */
        !           527:        default:
        !           528:                outflags |= MMAN_br;
        !           529:                break;
        !           530:        }
        !           531: }
        !           532:
1.22      schwarze  533: static int
                    534: pre_an(DECL_ARGS)
                    535: {
                    536:
                    537:        switch (n->norm->An.auth) {
                    538:        case (AUTH_split):
                    539:                outflags &= ~MMAN_An_nosplit;
                    540:                outflags |= MMAN_An_split;
                    541:                return(0);
                    542:        case (AUTH_nosplit):
                    543:                outflags &= ~MMAN_An_split;
                    544:                outflags |= MMAN_An_nosplit;
                    545:                return(0);
                    546:        default:
                    547:                if (MMAN_An_split & outflags)
                    548:                        outflags |= MMAN_br;
                    549:                else if (SEC_AUTHORS == n->sec &&
                    550:                    ! (MMAN_An_nosplit & outflags))
                    551:                        outflags |= MMAN_An_split;
                    552:                return(1);
                    553:        }
1.3       schwarze  554: }
                    555:
                    556: static int
                    557: pre_ap(DECL_ARGS)
                    558: {
                    559:
1.20      schwarze  560:        outflags &= ~MMAN_spc;
                    561:        print_word("'");
                    562:        outflags &= ~MMAN_spc;
1.3       schwarze  563:        return(0);
                    564: }
                    565:
                    566: static int
                    567: pre_bd(DECL_ARGS)
                    568: {
                    569:
1.21      schwarze  570:        if (0 == n->norm->Bd.comp)
                    571:                outflags |= MMAN_sp;
1.3       schwarze  572:        if (DISP_unfilled == n->norm->Bd.type ||
                    573:            DISP_literal  == n->norm->Bd.type) {
1.20      schwarze  574:                outflags |= MMAN_nl;
                    575:                print_word(".nf");
1.3       schwarze  576:        }
1.20      schwarze  577:        outflags |= MMAN_nl;
                    578:        print_word(".RS");
                    579:        print_offs(n->norm->Bd.offs);
                    580:        outflags |= MMAN_nl;
1.3       schwarze  581:        return(1);
                    582: }
                    583:
                    584: static void
                    585: post_bd(DECL_ARGS)
                    586: {
                    587:
1.20      schwarze  588:        outflags |= MMAN_nl;
                    589:        print_word(".RE");
1.3       schwarze  590:        if (DISP_unfilled == n->norm->Bd.type ||
                    591:            DISP_literal  == n->norm->Bd.type) {
1.20      schwarze  592:                outflags |= MMAN_nl;
                    593:                print_word(".fi");
1.3       schwarze  594:        }
1.20      schwarze  595:        outflags |= MMAN_nl;
1.13      schwarze  596: }
                    597:
                    598: static int
                    599: pre_bk(DECL_ARGS)
                    600: {
                    601:
                    602:        switch (n->type) {
                    603:        case (MDOC_BLOCK):
                    604:                return(1);
                    605:        case (MDOC_BODY):
1.20      schwarze  606:                outflags |= MMAN_Bk;
1.13      schwarze  607:                return(1);
                    608:        default:
                    609:                return(0);
                    610:        }
                    611: }
                    612:
                    613: static void
                    614: post_bk(DECL_ARGS)
                    615: {
                    616:
                    617:        if (MDOC_BODY == n->type)
1.20      schwarze  618:                outflags &= ~MMAN_Bk;
1.3       schwarze  619: }
                    620:
                    621: static int
                    622: pre_br(DECL_ARGS)
                    623: {
                    624:
1.21      schwarze  625:        outflags |= MMAN_br;
1.3       schwarze  626:        return(0);
                    627: }
                    628:
                    629: static int
1.8       schwarze  630: pre_bx(DECL_ARGS)
                    631: {
                    632:
                    633:        n = n->child;
                    634:        if (n) {
1.20      schwarze  635:                print_word(n->string);
                    636:                outflags &= ~MMAN_spc;
1.8       schwarze  637:                n = n->next;
                    638:        }
1.20      schwarze  639:        print_word("BSD");
1.8       schwarze  640:        if (NULL == n)
                    641:                return(0);
1.20      schwarze  642:        outflags &= ~MMAN_spc;
                    643:        print_word("-");
                    644:        outflags &= ~MMAN_spc;
                    645:        print_word(n->string);
1.8       schwarze  646:        return(0);
                    647: }
                    648:
                    649: static int
1.1       schwarze  650: pre_dl(DECL_ARGS)
                    651: {
                    652:
1.20      schwarze  653:        outflags |= MMAN_nl;
                    654:        print_word(".RS 6n");
                    655:        outflags |= MMAN_nl;
1.1       schwarze  656:        return(1);
                    657: }
                    658:
                    659: static void
                    660: post_dl(DECL_ARGS)
                    661: {
                    662:
1.20      schwarze  663:        outflags |= MMAN_nl;
                    664:        print_word(".RE");
                    665:        outflags |= MMAN_nl;
1.16      schwarze  666: }
                    667:
                    668: static int
1.17      schwarze  669: pre_fa(DECL_ARGS)
                    670: {
                    671:
                    672:        if (MDOC_Fa == n->tok)
                    673:                n = n->child;
                    674:
                    675:        while (NULL != n) {
1.20      schwarze  676:                print_word("\\fI");
                    677:                outflags &= ~MMAN_spc;
                    678:                print_node(m, n);
                    679:                outflags &= ~MMAN_spc;
                    680:                print_word("\\fP");
1.17      schwarze  681:                if (NULL != (n = n->next))
1.20      schwarze  682:                        print_word(",");
1.17      schwarze  683:        }
                    684:        return(0);
                    685: }
                    686:
                    687: static void
                    688: post_fa(DECL_ARGS)
                    689: {
                    690:
                    691:        if (NULL != n->next && MDOC_Fa == n->next->tok)
1.20      schwarze  692:                print_word(",");
1.17      schwarze  693: }
                    694:
                    695: static int
1.16      schwarze  696: pre_fn(DECL_ARGS)
                    697: {
                    698:
1.23    ! schwarze  699:        pre_syn(n);
        !           700:
1.16      schwarze  701:        n = n->child;
                    702:        if (NULL == n)
                    703:                return(0);
                    704:
1.20      schwarze  705:        print_word("\\fB");
                    706:        outflags &= ~MMAN_spc;
                    707:        print_node(m, n);
                    708:        outflags &= ~MMAN_spc;
                    709:        print_word("\\fP(");
                    710:        outflags &= ~MMAN_spc;
                    711:        return(pre_fa(m, n->next));
1.16      schwarze  712: }
                    713:
                    714: static void
                    715: post_fn(DECL_ARGS)
                    716: {
                    717:
1.20      schwarze  718:        print_word(")");
1.16      schwarze  719:        if (MDOC_SYNPRETTY & n->flags) {
1.20      schwarze  720:                print_word(";");
1.21      schwarze  721:                outflags |= MMAN_br;
1.17      schwarze  722:        }
                    723: }
                    724:
                    725: static int
                    726: pre_fo(DECL_ARGS)
                    727: {
                    728:
                    729:        switch (n->type) {
1.23    ! schwarze  730:        case (MDOC_BLOCK):
        !           731:                pre_syn(n);
        !           732:                break;
1.17      schwarze  733:        case (MDOC_HEAD):
1.20      schwarze  734:                print_word("\\fB");
                    735:                outflags &= ~MMAN_spc;
1.17      schwarze  736:                break;
                    737:        case (MDOC_BODY):
1.20      schwarze  738:                outflags &= ~MMAN_spc;
                    739:                print_word("(");
                    740:                outflags &= ~MMAN_spc;
1.17      schwarze  741:                break;
                    742:        default:
                    743:                break;
                    744:        }
                    745:        return(1);
                    746: }
                    747:
                    748: static void
                    749: post_fo(DECL_ARGS)
                    750: {
                    751:
                    752:        switch (n->type) {
                    753:        case (MDOC_HEAD):
1.20      schwarze  754:                outflags &= ~MMAN_spc;
                    755:                print_word("\\fP");
1.17      schwarze  756:                break;
                    757:        case (MDOC_BODY):
1.20      schwarze  758:                post_fn(m, n);
1.17      schwarze  759:                break;
                    760:        default:
                    761:                break;
1.16      schwarze  762:        }
1.15      schwarze  763: }
                    764:
                    765: static int
1.23    ! schwarze  766: pre_ft(DECL_ARGS)
        !           767: {
        !           768:
        !           769:        pre_syn(n);
        !           770:        print_word("\\fI");
        !           771:        outflags &= ~MMAN_spc;
        !           772:        return(1);
        !           773: }
        !           774:
        !           775: static int
1.15      schwarze  776: pre_in(DECL_ARGS)
                    777: {
                    778:
                    779:        if (MDOC_SYNPRETTY & n->flags) {
1.23    ! schwarze  780:                pre_syn(n);
1.20      schwarze  781:                print_word("\\fB#include <");
1.15      schwarze  782:        } else
1.20      schwarze  783:                print_word("<\\fI");
                    784:        outflags &= ~MMAN_spc;
1.15      schwarze  785:        return(1);
                    786: }
                    787:
                    788: static void
                    789: post_in(DECL_ARGS)
                    790: {
                    791:
1.20      schwarze  792:        outflags &= ~MMAN_spc;
1.15      schwarze  793:        if (MDOC_SYNPRETTY & n->flags) {
1.20      schwarze  794:                print_word(">\\fP");
1.21      schwarze  795:                outflags |= MMAN_br;
1.15      schwarze  796:        } else
1.20      schwarze  797:                print_word("\\fP>");
1.1       schwarze  798: }
                    799:
                    800: static int
                    801: pre_it(DECL_ARGS)
                    802: {
                    803:        const struct mdoc_node *bln;
                    804:
                    805:        if (MDOC_HEAD == n->type) {
1.20      schwarze  806:                outflags |= MMAN_nl;
                    807:                print_word(".TP");
1.1       schwarze  808:                bln = n->parent->parent->prev;
1.3       schwarze  809:                switch (bln->norm->Bl.type) {
                    810:                case (LIST_bullet):
1.20      schwarze  811:                        print_word("4n");
                    812:                        outflags |= MMAN_nl;
                    813:                        print_word("\\fBo\\fP");
1.3       schwarze  814:                        break;
                    815:                default:
                    816:                        if (bln->norm->Bl.width)
1.20      schwarze  817:                                print_word(bln->norm->Bl.width);
1.3       schwarze  818:                        break;
                    819:                }
1.20      schwarze  820:                outflags |= MMAN_nl;
1.1       schwarze  821:        }
                    822:        return(1);
1.14      schwarze  823: }
                    824:
                    825: static void
                    826: post_lb(DECL_ARGS)
                    827: {
                    828:
1.21      schwarze  829:        if (SEC_LIBRARY == n->sec)
                    830:                outflags |= MMAN_br;
1.1       schwarze  831: }
                    832:
                    833: static int
                    834: pre_nm(DECL_ARGS)
                    835: {
                    836:
1.23    ! schwarze  837:        if (MDOC_BLOCK == n->type)
        !           838:                pre_syn(n);
1.1       schwarze  839:        if (MDOC_ELEM != n->type && MDOC_HEAD != n->type)
                    840:                return(1);
1.23    ! schwarze  841:        if (NULL == n->child && NULL == m->name)
        !           842:                return(0);
1.20      schwarze  843:        print_word("\\fB");
                    844:        outflags &= ~MMAN_spc;
1.1       schwarze  845:        if (NULL == n->child)
1.20      schwarze  846:                print_word(m->name);
1.1       schwarze  847:        return(1);
                    848: }
                    849:
                    850: static void
                    851: post_nm(DECL_ARGS)
                    852: {
                    853:
                    854:        if (MDOC_ELEM != n->type && MDOC_HEAD != n->type)
                    855:                return;
1.20      schwarze  856:        outflags &= ~MMAN_spc;
                    857:        print_word("\\fP");
1.1       schwarze  858: }
                    859:
                    860: static int
                    861: pre_ns(DECL_ARGS)
                    862: {
                    863:
1.20      schwarze  864:        outflags &= ~MMAN_spc;
1.1       schwarze  865:        return(0);
                    866: }
                    867:
1.3       schwarze  868: static void
                    869: post_pf(DECL_ARGS)
                    870: {
                    871:
1.20      schwarze  872:        outflags &= ~MMAN_spc;
1.3       schwarze  873: }
                    874:
1.1       schwarze  875: static int
                    876: pre_pp(DECL_ARGS)
                    877: {
                    878:
1.20      schwarze  879:        outflags |= MMAN_nl;
1.1       schwarze  880:        if (MDOC_It == n->parent->tok)
1.20      schwarze  881:                print_word(".sp");
1.1       schwarze  882:        else
1.20      schwarze  883:                print_word(".PP");
                    884:        outflags |= MMAN_nl;
1.10      schwarze  885:        return(MDOC_Rs == n->tok);
1.12      schwarze  886: }
                    887:
                    888: static int
                    889: pre_sm(DECL_ARGS)
                    890: {
                    891:
                    892:        assert(n->child && MDOC_TEXT == n->child->type);
                    893:        if (0 == strcmp("on", n->child->string))
1.20      schwarze  894:                outflags |= MMAN_Sm;
1.12      schwarze  895:        else
1.20      schwarze  896:                outflags &= ~MMAN_Sm;
1.12      schwarze  897:        return(0);
1.1       schwarze  898: }
                    899:
                    900: static int
1.3       schwarze  901: pre_sp(DECL_ARGS)
1.1       schwarze  902: {
                    903:
1.20      schwarze  904:        outflags |= MMAN_nl;
                    905:        print_word(".sp");
1.1       schwarze  906:        return(1);
                    907: }
                    908:
                    909: static void
1.3       schwarze  910: post_sp(DECL_ARGS)
1.1       schwarze  911: {
                    912:
1.20      schwarze  913:        outflags |= MMAN_nl;
1.18      schwarze  914: }
                    915:
                    916: static int
                    917: pre_vt(DECL_ARGS)
                    918: {
                    919:
                    920:        if (MDOC_SYNPRETTY & n->flags) {
                    921:                switch (n->type) {
                    922:                case (MDOC_BLOCK):
1.23    ! schwarze  923:                        pre_syn(n);
1.18      schwarze  924:                        return(1);
                    925:                case (MDOC_BODY):
                    926:                        break;
                    927:                default:
                    928:                        return(0);
                    929:                }
                    930:        }
1.20      schwarze  931:        print_word("\\fI");
                    932:        outflags &= ~MMAN_spc;
1.18      schwarze  933:        return(1);
                    934: }
                    935:
                    936: static void
                    937: post_vt(DECL_ARGS)
                    938: {
                    939:
1.19      schwarze  940:        if (MDOC_SYNPRETTY & n->flags && MDOC_BODY != n->type)
1.18      schwarze  941:                return;
                    942:
1.20      schwarze  943:        outflags &= ~MMAN_spc;
                    944:        print_word("\\fP");
1.1       schwarze  945: }
                    946:
                    947: static int
                    948: pre_xr(DECL_ARGS)
                    949: {
                    950:
                    951:        n = n->child;
                    952:        if (NULL == n)
                    953:                return(0);
1.20      schwarze  954:        print_node(m, n);
1.1       schwarze  955:        n = n->next;
                    956:        if (NULL == n)
                    957:                return(0);
1.20      schwarze  958:        outflags &= ~MMAN_spc;
                    959:        print_word("(");
                    960:        print_node(m, n);
                    961:        print_word(")");
1.1       schwarze  962:        return(0);
1.8       schwarze  963: }
                    964:
                    965: static int
                    966: pre_ux(DECL_ARGS)
                    967: {
                    968:
1.20      schwarze  969:        print_word(manacts[n->tok].prefix);
1.8       schwarze  970:        if (NULL == n->child)
                    971:                return(0);
1.20      schwarze  972:        outflags &= ~MMAN_spc;
                    973:        print_word("\\~");
                    974:        outflags &= ~MMAN_spc;
1.8       schwarze  975:        return(1);
1.1       schwarze  976: }

CVSweb