Annotation of mandoc/mdoc_man.c, Revision 1.75
1.75 ! schwarze 1: /* $Id: mdoc_man.c,v 1.74 2014/11/19 22:00:37 schwarze Exp $ */
1.1 schwarze 2: /*
1.58 schwarze 3: * Copyright (c) 2011, 2012, 2013, 2014 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: #include "config.h"
1.69 schwarze 18:
19: #include <sys/types.h>
1.7 kristaps 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.59 schwarze 26: #include "mandoc_aux.h"
1.11 schwarze 27: #include "out.h"
1.4 kristaps 28: #include "man.h"
1.1 schwarze 29: #include "mdoc.h"
30: #include "main.h"
31:
1.42 schwarze 32: #define DECL_ARGS const struct mdoc_meta *meta, \
1.20 schwarze 33: const struct mdoc_node *n
1.1 schwarze 34:
35: struct manact {
1.5 kristaps 36: int (*cond)(DECL_ARGS); /* DON'T run actions */
37: int (*pre)(DECL_ARGS); /* pre-node action */
38: void (*post)(DECL_ARGS); /* post-node action */
39: const char *prefix; /* pre-node string constant */
40: const char *suffix; /* post-node string constant */
1.1 schwarze 41: };
42:
1.5 kristaps 43: static int cond_body(DECL_ARGS);
1.1 schwarze 44: static int cond_head(DECL_ARGS);
1.26 schwarze 45: static void font_push(char);
46: static void font_pop(void);
1.47 schwarze 47: static void mid_it(void);
1.34 schwarze 48: static void post__t(DECL_ARGS);
1.74 schwarze 49: static void post_aq(DECL_ARGS);
1.5 kristaps 50: static void post_bd(DECL_ARGS);
1.27 schwarze 51: static void post_bf(DECL_ARGS);
1.13 schwarze 52: static void post_bk(DECL_ARGS);
1.30 schwarze 53: static void post_bl(DECL_ARGS);
1.5 kristaps 54: static void post_dl(DECL_ARGS);
1.64 schwarze 55: static void post_en(DECL_ARGS);
1.1 schwarze 56: static void post_enc(DECL_ARGS);
1.28 schwarze 57: static void post_eo(DECL_ARGS);
1.17 schwarze 58: static void post_fa(DECL_ARGS);
1.29 schwarze 59: static void post_fd(DECL_ARGS);
1.26 schwarze 60: static void post_fl(DECL_ARGS);
1.16 schwarze 61: static void post_fn(DECL_ARGS);
1.17 schwarze 62: static void post_fo(DECL_ARGS);
1.26 schwarze 63: static void post_font(DECL_ARGS);
1.15 schwarze 64: static void post_in(DECL_ARGS);
1.30 schwarze 65: static void post_it(DECL_ARGS);
1.14 schwarze 66: static void post_lb(DECL_ARGS);
1.5 kristaps 67: static void post_nm(DECL_ARGS);
1.1 schwarze 68: static void post_percent(DECL_ARGS);
1.5 kristaps 69: static void post_pf(DECL_ARGS);
1.3 schwarze 70: static void post_sect(DECL_ARGS);
1.5 kristaps 71: static void post_sp(DECL_ARGS);
1.18 schwarze 72: static void post_vt(DECL_ARGS);
1.34 schwarze 73: static int pre__t(DECL_ARGS);
1.22 schwarze 74: static int pre_an(DECL_ARGS);
1.3 schwarze 75: static int pre_ap(DECL_ARGS);
1.74 schwarze 76: static int pre_aq(DECL_ARGS);
1.3 schwarze 77: static int pre_bd(DECL_ARGS);
1.27 schwarze 78: static int pre_bf(DECL_ARGS);
1.13 schwarze 79: static int pre_bk(DECL_ARGS);
1.30 schwarze 80: static int pre_bl(DECL_ARGS);
1.3 schwarze 81: static int pre_br(DECL_ARGS);
1.8 schwarze 82: static int pre_bx(DECL_ARGS);
1.1 schwarze 83: static int pre_dl(DECL_ARGS);
1.64 schwarze 84: static int pre_en(DECL_ARGS);
1.5 kristaps 85: static int pre_enc(DECL_ARGS);
1.26 schwarze 86: static int pre_em(DECL_ARGS);
1.75 ! schwarze 87: static int pre_skip(DECL_ARGS);
1.67 schwarze 88: static int pre_ex(DECL_ARGS);
1.17 schwarze 89: static int pre_fa(DECL_ARGS);
1.29 schwarze 90: static int pre_fd(DECL_ARGS);
1.26 schwarze 91: static int pre_fl(DECL_ARGS);
1.16 schwarze 92: static int pre_fn(DECL_ARGS);
1.17 schwarze 93: static int pre_fo(DECL_ARGS);
1.23 schwarze 94: static int pre_ft(DECL_ARGS);
1.15 schwarze 95: static int pre_in(DECL_ARGS);
1.1 schwarze 96: static int pre_it(DECL_ARGS);
1.24 schwarze 97: static int pre_lk(DECL_ARGS);
1.26 schwarze 98: static int pre_li(DECL_ARGS);
1.60 schwarze 99: static int pre_ll(DECL_ARGS);
1.1 schwarze 100: static int pre_nm(DECL_ARGS);
1.25 schwarze 101: static int pre_no(DECL_ARGS);
1.1 schwarze 102: static int pre_ns(DECL_ARGS);
103: static int pre_pp(DECL_ARGS);
1.34 schwarze 104: static int pre_rs(DECL_ARGS);
1.67 schwarze 105: static int pre_rv(DECL_ARGS);
1.12 schwarze 106: static int pre_sm(DECL_ARGS);
1.3 schwarze 107: static int pre_sp(DECL_ARGS);
1.5 kristaps 108: static int pre_sect(DECL_ARGS);
1.26 schwarze 109: static int pre_sy(DECL_ARGS);
1.23 schwarze 110: static void pre_syn(const struct mdoc_node *);
1.18 schwarze 111: static int pre_vt(DECL_ARGS);
1.8 schwarze 112: static int pre_ux(DECL_ARGS);
1.1 schwarze 113: static int pre_xr(DECL_ARGS);
1.20 schwarze 114: static void print_word(const char *);
1.36 schwarze 115: static void print_line(const char *, int);
116: static void print_block(const char *, int);
1.71 schwarze 117: static void print_offs(const char *, int);
1.35 schwarze 118: static void print_width(const char *,
119: const struct mdoc_node *, size_t);
1.30 schwarze 120: static void print_count(int *);
1.5 kristaps 121: static void print_node(DECL_ARGS);
1.1 schwarze 122:
1.3 schwarze 123: static const struct manact manacts[MDOC_MAX + 1] = {
124: { NULL, pre_ap, NULL, NULL, NULL }, /* Ap */
125: { NULL, NULL, NULL, NULL, NULL }, /* Dd */
126: { NULL, NULL, NULL, NULL, NULL }, /* Dt */
1.8 schwarze 127: { NULL, NULL, NULL, NULL, NULL }, /* Os */
1.3 schwarze 128: { NULL, pre_sect, post_sect, ".SH", NULL }, /* Sh */
129: { NULL, pre_sect, post_sect, ".SS", NULL }, /* Ss */
1.1 schwarze 130: { NULL, pre_pp, NULL, NULL, NULL }, /* Pp */
1.3 schwarze 131: { cond_body, pre_dl, post_dl, NULL, NULL }, /* D1 */
1.1 schwarze 132: { cond_body, pre_dl, post_dl, NULL, NULL }, /* Dl */
1.3 schwarze 133: { cond_body, pre_bd, post_bd, NULL, NULL }, /* Bd */
134: { NULL, NULL, NULL, NULL, NULL }, /* Ed */
1.30 schwarze 135: { cond_body, pre_bl, post_bl, NULL, NULL }, /* Bl */
1.3 schwarze 136: { NULL, NULL, NULL, NULL, NULL }, /* El */
1.30 schwarze 137: { NULL, pre_it, post_it, NULL, NULL }, /* It */
1.26 schwarze 138: { NULL, pre_em, post_font, NULL, NULL }, /* Ad */
1.22 schwarze 139: { NULL, pre_an, NULL, NULL, NULL }, /* An */
1.26 schwarze 140: { NULL, pre_em, post_font, NULL, NULL }, /* Ar */
141: { NULL, pre_sy, post_font, NULL, NULL }, /* Cd */
142: { NULL, pre_sy, post_font, NULL, NULL }, /* Cm */
143: { NULL, pre_li, post_font, NULL, NULL }, /* Dv */
144: { NULL, pre_li, post_font, NULL, NULL }, /* Er */
145: { NULL, pre_li, post_font, NULL, NULL }, /* Ev */
1.67 schwarze 146: { NULL, pre_ex, NULL, NULL, NULL }, /* Ex */
1.17 schwarze 147: { NULL, pre_fa, post_fa, NULL, NULL }, /* Fa */
1.29 schwarze 148: { NULL, pre_fd, post_fd, NULL, NULL }, /* Fd */
1.26 schwarze 149: { NULL, pre_fl, post_fl, NULL, NULL }, /* Fl */
1.16 schwarze 150: { NULL, pre_fn, post_fn, NULL, NULL }, /* Fn */
1.26 schwarze 151: { NULL, pre_ft, post_font, NULL, NULL }, /* Ft */
152: { NULL, pre_sy, post_font, NULL, NULL }, /* Ic */
1.15 schwarze 153: { NULL, pre_in, post_in, NULL, NULL }, /* In */
1.26 schwarze 154: { NULL, pre_li, post_font, NULL, NULL }, /* Li */
1.1 schwarze 155: { cond_head, pre_enc, NULL, "\\- ", NULL }, /* Nd */
156: { NULL, pre_nm, post_nm, NULL, NULL }, /* Nm */
157: { cond_body, pre_enc, post_enc, "[", "]" }, /* Op */
1.64 schwarze 158: { NULL, pre_ft, post_font, NULL, NULL }, /* Ot */
1.26 schwarze 159: { NULL, pre_em, post_font, NULL, NULL }, /* Pa */
1.67 schwarze 160: { NULL, pre_rv, NULL, NULL, NULL }, /* Rv */
1.8 schwarze 161: { NULL, NULL, NULL, NULL, NULL }, /* St */
1.26 schwarze 162: { NULL, pre_em, post_font, NULL, NULL }, /* Va */
1.18 schwarze 163: { NULL, pre_vt, post_vt, NULL, NULL }, /* Vt */
1.8 schwarze 164: { NULL, pre_xr, NULL, NULL, NULL }, /* Xr */
1.34 schwarze 165: { NULL, NULL, post_percent, NULL, NULL }, /* %A */
166: { NULL, pre_em, post_percent, NULL, NULL }, /* %B */
167: { NULL, NULL, post_percent, NULL, NULL }, /* %D */
168: { NULL, pre_em, post_percent, NULL, NULL }, /* %I */
169: { NULL, pre_em, post_percent, NULL, NULL }, /* %J */
170: { NULL, NULL, post_percent, NULL, NULL }, /* %N */
171: { NULL, NULL, post_percent, NULL, NULL }, /* %O */
172: { NULL, NULL, post_percent, NULL, NULL }, /* %P */
173: { NULL, NULL, post_percent, NULL, NULL }, /* %R */
174: { NULL, pre__t, post__t, NULL, NULL }, /* %T */
175: { NULL, NULL, post_percent, NULL, NULL }, /* %V */
1.9 schwarze 176: { NULL, NULL, NULL, NULL, NULL }, /* Ac */
1.74 schwarze 177: { cond_body, pre_aq, post_aq, NULL, NULL }, /* Ao */
178: { cond_body, pre_aq, post_aq, NULL, NULL }, /* Aq */
1.8 schwarze 179: { NULL, NULL, NULL, NULL, NULL }, /* At */
1.3 schwarze 180: { NULL, NULL, NULL, NULL, NULL }, /* Bc */
1.27 schwarze 181: { NULL, pre_bf, post_bf, NULL, NULL }, /* Bf */
1.3 schwarze 182: { cond_body, pre_enc, post_enc, "[", "]" }, /* Bo */
183: { cond_body, pre_enc, post_enc, "[", "]" }, /* Bq */
1.8 schwarze 184: { NULL, pre_ux, NULL, "BSD/OS", NULL }, /* Bsx */
185: { NULL, pre_bx, NULL, NULL, NULL }, /* Bx */
1.75 ! schwarze 186: { NULL, pre_skip, NULL, NULL, NULL }, /* Db */
1.9 schwarze 187: { NULL, NULL, NULL, NULL, NULL }, /* Dc */
1.51 schwarze 188: { cond_body, pre_enc, post_enc, "\\(lq", "\\(rq" }, /* Do */
189: { cond_body, pre_enc, post_enc, "\\(lq", "\\(rq" }, /* Dq */
1.28 schwarze 190: { NULL, NULL, NULL, NULL, NULL }, /* Ec */
191: { NULL, NULL, NULL, NULL, NULL }, /* Ef */
1.26 schwarze 192: { NULL, pre_em, post_font, NULL, NULL }, /* Em */
1.28 schwarze 193: { NULL, NULL, post_eo, NULL, NULL }, /* Eo */
1.8 schwarze 194: { NULL, pre_ux, NULL, "FreeBSD", NULL }, /* Fx */
1.26 schwarze 195: { NULL, pre_sy, post_font, NULL, NULL }, /* Ms */
1.25 schwarze 196: { NULL, pre_no, NULL, NULL, NULL }, /* No */
1.1 schwarze 197: { NULL, pre_ns, NULL, NULL, NULL }, /* Ns */
1.8 schwarze 198: { NULL, pre_ux, NULL, "NetBSD", NULL }, /* Nx */
199: { NULL, pre_ux, NULL, "OpenBSD", NULL }, /* Ox */
1.3 schwarze 200: { NULL, NULL, NULL, NULL, NULL }, /* Pc */
201: { NULL, NULL, post_pf, NULL, NULL }, /* Pf */
202: { cond_body, pre_enc, post_enc, "(", ")" }, /* Po */
203: { cond_body, pre_enc, post_enc, "(", ")" }, /* Pq */
1.9 schwarze 204: { NULL, NULL, NULL, NULL, NULL }, /* Qc */
1.51 schwarze 205: { cond_body, pre_enc, post_enc, "\\(oq", "\\(cq" }, /* Ql */
1.9 schwarze 206: { cond_body, pre_enc, post_enc, "\"", "\"" }, /* Qo */
207: { cond_body, pre_enc, post_enc, "\"", "\"" }, /* Qq */
208: { NULL, NULL, NULL, NULL, NULL }, /* Re */
1.34 schwarze 209: { cond_body, pre_rs, NULL, NULL, NULL }, /* Rs */
1.9 schwarze 210: { NULL, NULL, NULL, NULL, NULL }, /* Sc */
1.51 schwarze 211: { cond_body, pre_enc, post_enc, "\\(oq", "\\(cq" }, /* So */
212: { cond_body, pre_enc, post_enc, "\\(oq", "\\(cq" }, /* Sq */
1.12 schwarze 213: { NULL, pre_sm, NULL, NULL, NULL }, /* Sm */
1.26 schwarze 214: { NULL, pre_em, post_font, NULL, NULL }, /* Sx */
215: { NULL, pre_sy, post_font, NULL, NULL }, /* Sy */
216: { NULL, pre_li, post_font, NULL, NULL }, /* Tn */
1.8 schwarze 217: { NULL, pre_ux, NULL, "UNIX", NULL }, /* Ux */
1.34 schwarze 218: { NULL, NULL, NULL, NULL, NULL }, /* Xc */
219: { NULL, NULL, NULL, NULL, NULL }, /* Xo */
1.17 schwarze 220: { NULL, pre_fo, post_fo, NULL, NULL }, /* Fo */
221: { NULL, NULL, NULL, NULL, NULL }, /* Fc */
1.3 schwarze 222: { cond_body, pre_enc, post_enc, "[", "]" }, /* Oo */
1.9 schwarze 223: { NULL, NULL, NULL, NULL, NULL }, /* Oc */
1.13 schwarze 224: { NULL, pre_bk, post_bk, NULL, NULL }, /* Bk */
225: { NULL, NULL, NULL, NULL, NULL }, /* Ek */
1.8 schwarze 226: { NULL, pre_ux, NULL, "is currently in beta test.", NULL }, /* Bt */
227: { NULL, NULL, NULL, NULL, NULL }, /* Hf */
1.64 schwarze 228: { NULL, pre_em, post_font, NULL, NULL }, /* Fr */
1.8 schwarze 229: { NULL, pre_ux, NULL, "currently under development.", NULL }, /* Ud */
1.14 schwarze 230: { NULL, NULL, post_lb, NULL, NULL }, /* Lb */
1.3 schwarze 231: { NULL, pre_pp, NULL, NULL, NULL }, /* Lp */
1.24 schwarze 232: { NULL, pre_lk, NULL, NULL, NULL }, /* Lk */
1.26 schwarze 233: { NULL, pre_em, post_font, NULL, NULL }, /* Mt */
1.9 schwarze 234: { cond_body, pre_enc, post_enc, "{", "}" }, /* Brq */
235: { cond_body, pre_enc, post_enc, "{", "}" }, /* Bro */
236: { NULL, NULL, NULL, NULL, NULL }, /* Brc */
1.34 schwarze 237: { NULL, NULL, post_percent, NULL, NULL }, /* %C */
1.75 ! schwarze 238: { NULL, pre_skip, NULL, NULL, NULL }, /* Es */
1.64 schwarze 239: { cond_body, pre_en, post_en, NULL, NULL }, /* En */
1.8 schwarze 240: { NULL, pre_ux, NULL, "DragonFly", NULL }, /* Dx */
1.34 schwarze 241: { NULL, NULL, post_percent, NULL, NULL }, /* %Q */
1.3 schwarze 242: { NULL, pre_br, NULL, NULL, NULL }, /* br */
243: { NULL, pre_sp, post_sp, NULL, NULL }, /* sp */
1.34 schwarze 244: { NULL, NULL, post_percent, NULL, NULL }, /* %U */
245: { NULL, NULL, NULL, NULL, NULL }, /* Ta */
1.60 schwarze 246: { NULL, pre_ll, post_sp, NULL, NULL }, /* ll */
1.3 schwarze 247: { NULL, NULL, NULL, NULL, NULL }, /* ROOT */
1.1 schwarze 248: };
249:
1.20 schwarze 250: static int outflags;
1.36 schwarze 251: #define MMAN_spc (1 << 0) /* blank character before next word */
252: #define MMAN_spc_force (1 << 1) /* even before trailing punctuation */
253: #define MMAN_nl (1 << 2) /* break man(7) code line */
254: #define MMAN_br (1 << 3) /* break output line */
255: #define MMAN_sp (1 << 4) /* insert a blank output line */
256: #define MMAN_PP (1 << 5) /* reset indentation etc. */
257: #define MMAN_Sm (1 << 6) /* horizontal spacing mode */
258: #define MMAN_Bk (1 << 7) /* word keep mode */
1.46 schwarze 259: #define MMAN_Bk_susp (1 << 8) /* suspend this (after a macro) */
260: #define MMAN_An_split (1 << 9) /* author mode is "split" */
261: #define MMAN_An_nosplit (1 << 10) /* author mode is "nosplit" */
262: #define MMAN_PD (1 << 11) /* inter-paragraph spacing disabled */
1.56 schwarze 263: #define MMAN_nbrword (1 << 12) /* do not break the next word */
1.20 schwarze 264:
1.43 schwarze 265: #define BL_STACK_MAX 32
266:
267: static size_t Bl_stack[BL_STACK_MAX]; /* offsets [chars] */
268: static int Bl_stack_post[BL_STACK_MAX]; /* add final .RE */
269: static int Bl_stack_len; /* number of nested Bl blocks */
1.37 schwarze 270: static int TPremain; /* characters before tag is full */
271:
1.26 schwarze 272: static struct {
273: char *head;
274: char *tail;
275: size_t size;
276: } fontqueue;
277:
1.62 schwarze 278:
1.26 schwarze 279: static void
280: font_push(char newfont)
281: {
282:
283: if (fontqueue.head + fontqueue.size <= ++fontqueue.tail) {
284: fontqueue.size += 8;
285: fontqueue.head = mandoc_realloc(fontqueue.head,
1.62 schwarze 286: fontqueue.size);
1.26 schwarze 287: }
288: *fontqueue.tail = newfont;
1.37 schwarze 289: print_word("");
290: printf("\\f");
1.26 schwarze 291: putchar(newfont);
292: outflags &= ~MMAN_spc;
293: }
294:
295: static void
296: font_pop(void)
297: {
298:
299: if (fontqueue.tail > fontqueue.head)
300: fontqueue.tail--;
301: outflags &= ~MMAN_spc;
1.37 schwarze 302: print_word("");
303: printf("\\f");
1.26 schwarze 304: putchar(*fontqueue.tail);
305: }
306:
1.1 schwarze 307: static void
1.20 schwarze 308: print_word(const char *s)
1.1 schwarze 309: {
1.5 kristaps 310:
1.36 schwarze 311: if ((MMAN_PP | MMAN_sp | MMAN_br | MMAN_nl) & outflags) {
1.62 schwarze 312: /*
1.5 kristaps 313: * If we need a newline, print it now and start afresh.
314: */
1.36 schwarze 315: if (MMAN_PP & outflags) {
1.44 schwarze 316: if (MMAN_sp & outflags) {
317: if (MMAN_PD & outflags) {
318: printf("\n.PD");
319: outflags &= ~MMAN_PD;
320: }
321: } else if ( ! (MMAN_PD & outflags)) {
322: printf("\n.PD 0");
323: outflags |= MMAN_PD;
324: }
1.36 schwarze 325: printf("\n.PP\n");
326: } else if (MMAN_sp & outflags)
1.21 schwarze 327: printf("\n.sp\n");
328: else if (MMAN_br & outflags)
329: printf("\n.br\n");
330: else if (MMAN_nl & outflags)
331: putchar('\n');
1.36 schwarze 332: outflags &= ~(MMAN_PP|MMAN_sp|MMAN_br|MMAN_nl|MMAN_spc);
1.37 schwarze 333: if (1 == TPremain)
334: printf(".br\n");
335: TPremain = 0;
336: } else if (MMAN_spc & outflags) {
1.5 kristaps 337: /*
1.25 schwarze 338: * If we need a space, only print it if
339: * (1) it is forced by `No' or
340: * (2) what follows is not terminating punctuation or
341: * (3) what follows is longer than one character.
1.5 kristaps 342: */
1.37 schwarze 343: if (MMAN_spc_force & outflags || '\0' == s[0] ||
1.25 schwarze 344: NULL == strchr(".,:;)]?!", s[0]) || '\0' != s[1]) {
1.46 schwarze 345: if (MMAN_Bk & outflags &&
346: ! (MMAN_Bk_susp & outflags))
1.13 schwarze 347: putchar('\\');
1.45 schwarze 348: putchar(' ');
1.37 schwarze 349: if (TPremain)
350: TPremain--;
1.13 schwarze 351: }
1.37 schwarze 352: }
1.5 kristaps 353:
354: /*
355: * Reassign needing space if we're not following opening
356: * punctuation.
357: */
1.37 schwarze 358: if (MMAN_Sm & outflags && ('\0' == s[0] ||
359: (('(' != s[0] && '[' != s[0]) || '\0' != s[1])))
1.20 schwarze 360: outflags |= MMAN_spc;
361: else
362: outflags &= ~MMAN_spc;
1.46 schwarze 363: outflags &= ~(MMAN_spc_force | MMAN_Bk_susp);
1.5 kristaps 364:
1.1 schwarze 365: for ( ; *s; s++) {
366: switch (*s) {
1.62 schwarze 367: case ASCII_NBRSP:
1.45 schwarze 368: printf("\\ ");
1.1 schwarze 369: break;
1.62 schwarze 370: case ASCII_HYPH:
1.1 schwarze 371: putchar('-');
1.58 schwarze 372: break;
1.62 schwarze 373: case ASCII_BREAK:
1.58 schwarze 374: printf("\\:");
1.1 schwarze 375: break;
1.62 schwarze 376: case ' ':
1.56 schwarze 377: if (MMAN_nbrword & outflags) {
378: printf("\\ ");
379: break;
380: }
381: /* FALLTHROUGH */
1.1 schwarze 382: default:
1.5 kristaps 383: putchar((unsigned char)*s);
1.1 schwarze 384: break;
385: }
1.37 schwarze 386: if (TPremain)
387: TPremain--;
1.1 schwarze 388: }
1.56 schwarze 389: outflags &= ~MMAN_nbrword;
1.4 kristaps 390: }
391:
1.11 schwarze 392: static void
1.36 schwarze 393: print_line(const char *s, int newflags)
394: {
395:
396: outflags &= ~MMAN_br;
397: outflags |= MMAN_nl;
398: print_word(s);
399: outflags |= newflags;
400: }
401:
402: static void
403: print_block(const char *s, int newflags)
404: {
405:
406: outflags &= ~MMAN_PP;
1.44 schwarze 407: if (MMAN_sp & outflags) {
1.36 schwarze 408: outflags &= ~(MMAN_sp | MMAN_br);
1.44 schwarze 409: if (MMAN_PD & outflags) {
410: print_line(".PD", 0);
411: outflags &= ~MMAN_PD;
412: }
1.46 schwarze 413: } else if (! (MMAN_PD & outflags))
414: print_line(".PD 0", MMAN_PD);
1.36 schwarze 415: outflags |= MMAN_nl;
416: print_word(s);
1.46 schwarze 417: outflags |= MMAN_Bk_susp | newflags;
1.36 schwarze 418: }
419:
420: static void
1.71 schwarze 421: print_offs(const char *v, int keywords)
1.11 schwarze 422: {
423: char buf[24];
424: struct roffsu su;
425: size_t sz;
426:
1.48 schwarze 427: print_line(".RS", MMAN_Bk_susp);
428:
1.43 schwarze 429: /* Convert v into a number (of characters). */
1.71 schwarze 430: if (NULL == v || '\0' == *v || (keywords && !strcmp(v, "left")))
1.11 schwarze 431: sz = 0;
1.71 schwarze 432: else if (keywords && !strcmp(v, "indent"))
1.11 schwarze 433: sz = 6;
1.71 schwarze 434: else if (keywords && !strcmp(v, "indent-two"))
1.11 schwarze 435: sz = 12;
436: else if (a2roffsu(v, &su, SCALE_MAX)) {
1.43 schwarze 437: if (SCALE_EN == su.unit)
438: sz = su.scale;
439: else {
440: /*
441: * XXX
442: * If we are inside an enclosing list,
443: * there is no easy way to add the two
444: * indentations because they are provided
445: * in terms of different units.
446: */
447: print_word(v);
1.48 schwarze 448: outflags |= MMAN_nl;
1.43 schwarze 449: return;
450: }
1.11 schwarze 451: } else
452: sz = strlen(v);
453:
1.43 schwarze 454: /*
455: * We are inside an enclosing list.
456: * Add the two indentations.
457: */
458: if (Bl_stack_len)
459: sz += Bl_stack[Bl_stack_len - 1];
460:
1.63 schwarze 461: (void)snprintf(buf, sizeof(buf), "%zun", sz);
1.20 schwarze 462: print_word(buf);
1.48 schwarze 463: outflags |= MMAN_nl;
1.11 schwarze 464: }
465:
1.47 schwarze 466: /*
467: * Set up the indentation for a list item; used from pre_it().
468: */
1.59 schwarze 469: static void
1.35 schwarze 470: print_width(const char *v, const struct mdoc_node *child, size_t defsz)
1.30 schwarze 471: {
472: char buf[24];
473: struct roffsu su;
1.31 schwarze 474: size_t sz, chsz;
1.37 schwarze 475: int numeric, remain;
1.31 schwarze 476:
1.37 schwarze 477: numeric = 1;
478: remain = 0;
1.43 schwarze 479:
480: /* Convert v into a number (of characters). */
1.35 schwarze 481: if (NULL == v)
482: sz = defsz;
483: else if (a2roffsu(v, &su, SCALE_MAX)) {
1.30 schwarze 484: if (SCALE_EN == su.unit)
485: sz = su.scale;
486: else {
1.37 schwarze 487: sz = 0;
488: numeric = 0;
1.30 schwarze 489: }
490: } else
491: sz = strlen(v);
492:
1.37 schwarze 493: /* XXX Rough estimation, might have multiple parts. */
494: chsz = (NULL != child && MDOC_TEXT == child->type) ?
1.62 schwarze 495: strlen(child->string) : 0;
1.37 schwarze 496:
1.47 schwarze 497: /* Maybe we are inside an enclosing list? */
498: mid_it();
1.43 schwarze 499:
500: /*
501: * Save our own indentation,
502: * such that child lists can use it.
503: */
504: Bl_stack[Bl_stack_len++] = sz + 2;
505:
506: /* Set up the current list. */
1.37 schwarze 507: if (defsz && chsz > sz)
1.36 schwarze 508: print_block(".HP", 0);
1.37 schwarze 509: else {
1.36 schwarze 510: print_block(".TP", 0);
1.37 schwarze 511: remain = sz + 2;
512: }
513: if (numeric) {
1.63 schwarze 514: (void)snprintf(buf, sizeof(buf), "%zun", sz + 2);
1.37 schwarze 515: print_word(buf);
516: } else
517: print_word(v);
518: TPremain = remain;
1.30 schwarze 519: }
520:
1.59 schwarze 521: static void
1.30 schwarze 522: print_count(int *count)
523: {
1.63 schwarze 524: char buf[24];
1.30 schwarze 525:
1.63 schwarze 526: (void)snprintf(buf, sizeof(buf), "%d.", ++*count);
1.30 schwarze 527: print_word(buf);
528: }
529:
530: void
1.4 kristaps 531: man_man(void *arg, const struct man *man)
532: {
533:
1.5 kristaps 534: /*
535: * Dump the keep buffer.
536: * We're guaranteed by now that this exists (is non-NULL).
537: * Flush stdout afterward, just in case.
538: */
1.4 kristaps 539: fputs(mparse_getkeep(man_mparse(man)), stdout);
1.5 kristaps 540: fflush(stdout);
1.1 schwarze 541: }
542:
543: void
544: man_mdoc(void *arg, const struct mdoc *mdoc)
545: {
1.42 schwarze 546: const struct mdoc_meta *meta;
1.1 schwarze 547: const struct mdoc_node *n;
548:
1.42 schwarze 549: meta = mdoc_meta(mdoc);
1.1 schwarze 550: n = mdoc_node(mdoc);
551:
1.45 schwarze 552: printf(".TH \"%s\" \"%s\" \"%s\" \"%s\" \"%s\"\n",
1.68 schwarze 553: meta->title,
554: (meta->msec == NULL ? "" : meta->msec),
555: meta->date, meta->os, meta->vol);
1.1 schwarze 556:
1.45 schwarze 557: /* Disable hyphenation and if nroff, disable justification. */
558: printf(".nh\n.if n .ad l");
559:
1.20 schwarze 560: outflags = MMAN_nl | MMAN_Sm;
1.26 schwarze 561: if (0 == fontqueue.size) {
562: fontqueue.size = 8;
563: fontqueue.head = fontqueue.tail = mandoc_malloc(8);
564: *fontqueue.tail = 'R';
565: }
1.42 schwarze 566: print_node(meta, n);
1.3 schwarze 567: putchar('\n');
1.1 schwarze 568: }
569:
570: static void
571: print_node(DECL_ARGS)
572: {
1.52 schwarze 573: const struct mdoc_node *sub;
1.5 kristaps 574: const struct manact *act;
1.1 schwarze 575: int cond, do_sub;
1.46 schwarze 576:
1.5 kristaps 577: /*
578: * Break the line if we were parsed subsequent the current node.
579: * This makes the page structure be more consistent.
580: */
1.52 schwarze 581: if (MMAN_spc & outflags && MDOC_LINE & n->flags)
1.20 schwarze 582: outflags |= MMAN_nl;
1.1 schwarze 583:
1.5 kristaps 584: act = NULL;
1.1 schwarze 585: cond = 0;
586: do_sub = 1;
1.5 kristaps 587:
1.1 schwarze 588: if (MDOC_TEXT == n->type) {
1.5 kristaps 589: /*
590: * Make sure that we don't happen to start with a
591: * control character at the start of a line.
592: */
1.62 schwarze 593: if (MMAN_nl & outflags &&
594: ('.' == *n->string || '\'' == *n->string)) {
1.37 schwarze 595: print_word("");
596: printf("\\&");
1.20 schwarze 597: outflags &= ~MMAN_spc;
1.3 schwarze 598: }
1.73 schwarze 599: if (outflags & MMAN_Sm && ! (n->flags & MDOC_DELIMC))
600: outflags |= MMAN_spc_force;
1.20 schwarze 601: print_word(n->string);
1.73 schwarze 602: if (outflags & MMAN_Sm && ! (n->flags & MDOC_DELIMO))
603: outflags |= MMAN_spc;
1.1 schwarze 604: } else {
1.5 kristaps 605: /*
606: * Conditionally run the pre-node action handler for a
607: * node.
608: */
1.1 schwarze 609: act = manacts + n->tok;
1.42 schwarze 610: cond = NULL == act->cond || (*act->cond)(meta, n);
1.61 schwarze 611: if (cond && act->pre && ENDBODY_NOT == n->end)
1.42 schwarze 612: do_sub = (*act->pre)(meta, n);
1.1 schwarze 613: }
614:
1.62 schwarze 615: /*
1.5 kristaps 616: * Conditionally run all child nodes.
617: * Note that this iterates over children instead of using
618: * recursion. This prevents unnecessary depth in the stack.
619: */
1.1 schwarze 620: if (do_sub)
621: for (sub = n->child; sub; sub = sub->next)
1.42 schwarze 622: print_node(meta, sub);
1.1 schwarze 623:
1.5 kristaps 624: /*
625: * Lastly, conditionally run the post-node handler.
626: */
1.61 schwarze 627: if (MDOC_ENDED & n->flags)
628: return;
629:
1.1 schwarze 630: if (cond && act->post)
1.42 schwarze 631: (*act->post)(meta, n);
1.61 schwarze 632:
633: if (ENDBODY_NOT != n->end)
634: n->pending->flags |= MDOC_ENDED;
635:
636: if (ENDBODY_NOSPACE == n->end)
637: outflags &= ~(MMAN_spc | MMAN_nl);
1.1 schwarze 638: }
639:
640: static int
641: cond_head(DECL_ARGS)
642: {
1.5 kristaps 643:
1.1 schwarze 644: return(MDOC_HEAD == n->type);
645: }
646:
647: static int
648: cond_body(DECL_ARGS)
649: {
1.5 kristaps 650:
1.1 schwarze 651: return(MDOC_BODY == n->type);
652: }
653:
654: static int
655: pre_enc(DECL_ARGS)
656: {
1.5 kristaps 657: const char *prefix;
1.1 schwarze 658:
659: prefix = manacts[n->tok].prefix;
660: if (NULL == prefix)
661: return(1);
1.20 schwarze 662: print_word(prefix);
663: outflags &= ~MMAN_spc;
1.1 schwarze 664: return(1);
665: }
666:
667: static void
668: post_enc(DECL_ARGS)
669: {
670: const char *suffix;
671:
672: suffix = manacts[n->tok].suffix;
673: if (NULL == suffix)
674: return;
1.61 schwarze 675: outflags &= ~(MMAN_spc | MMAN_nl);
1.20 schwarze 676: print_word(suffix);
1.26 schwarze 677: }
678:
1.67 schwarze 679: static int
680: pre_ex(DECL_ARGS)
681: {
682: int nchild;
683:
684: outflags |= MMAN_br | MMAN_nl;
685:
686: print_word("The");
687:
688: nchild = n->nchild;
689: for (n = n->child; n; n = n->next) {
690: font_push('B');
691: print_word(n->string);
692: font_pop();
693:
694: if (n->next == NULL)
695: continue;
696:
697: if (nchild > 2) {
698: outflags &= ~MMAN_spc;
699: print_word(",");
700: }
701: if (n->next->next == NULL)
702: print_word("and");
703: }
704:
705: if (nchild > 1)
706: print_word("utilities exit\\~0");
707: else
708: print_word("utility exits\\~0");
709:
710: print_word("on success, and\\~>0 if an error occurs.");
711: outflags |= MMAN_nl;
712: return(0);
713: }
714:
1.26 schwarze 715: static void
716: post_font(DECL_ARGS)
717: {
718:
719: font_pop();
1.1 schwarze 720: }
721:
722: static void
723: post_percent(DECL_ARGS)
724: {
725:
1.34 schwarze 726: if (pre_em == manacts[n->tok].pre)
727: font_pop();
728: if (n->next) {
1.20 schwarze 729: print_word(",");
1.34 schwarze 730: if (n->prev && n->prev->tok == n->tok &&
731: n->next->tok == n->tok)
732: print_word("and");
733: } else {
1.20 schwarze 734: print_word(".");
735: outflags |= MMAN_nl;
1.1 schwarze 736: }
737: }
738:
1.34 schwarze 739: static int
740: pre__t(DECL_ARGS)
741: {
742:
1.62 schwarze 743: if (n->parent && MDOC_Rs == n->parent->tok &&
744: n->parent->norm->Rs.quote_T) {
1.37 schwarze 745: print_word("");
746: putchar('\"');
1.34 schwarze 747: outflags &= ~MMAN_spc;
748: } else
749: font_push('I');
750: return(1);
751: }
752:
753: static void
754: post__t(DECL_ARGS)
755: {
756:
1.62 schwarze 757: if (n->parent && MDOC_Rs == n->parent->tok &&
758: n->parent->norm->Rs.quote_T) {
1.34 schwarze 759: outflags &= ~MMAN_spc;
1.37 schwarze 760: print_word("");
761: putchar('\"');
1.34 schwarze 762: } else
763: font_pop();
1.42 schwarze 764: post_percent(meta, n);
1.34 schwarze 765: }
766:
1.5 kristaps 767: /*
768: * Print before a section header.
769: */
1.1 schwarze 770: static int
1.3 schwarze 771: pre_sect(DECL_ARGS)
772: {
773:
1.54 schwarze 774: if (MDOC_HEAD == n->type) {
1.46 schwarze 775: outflags |= MMAN_sp;
776: print_block(manacts[n->tok].prefix, 0);
777: print_word("");
778: putchar('\"');
779: outflags &= ~MMAN_spc;
780: }
1.3 schwarze 781: return(1);
782: }
783:
1.5 kristaps 784: /*
785: * Print subsequent a section header.
786: */
1.3 schwarze 787: static void
788: post_sect(DECL_ARGS)
789: {
790:
791: if (MDOC_HEAD != n->type)
792: return;
1.20 schwarze 793: outflags &= ~MMAN_spc;
1.37 schwarze 794: print_word("");
795: putchar('\"');
1.20 schwarze 796: outflags |= MMAN_nl;
1.22 schwarze 797: if (MDOC_Sh == n->tok && SEC_AUTHORS == n->sec)
798: outflags &= ~(MMAN_An_split | MMAN_An_nosplit);
799: }
800:
1.23 schwarze 801: /* See mdoc_term.c, synopsis_pre() for comments. */
802: static void
803: pre_syn(const struct mdoc_node *n)
804: {
805:
806: if (NULL == n->prev || ! (MDOC_SYNPRETTY & n->flags))
807: return;
808:
809: if (n->prev->tok == n->tok &&
1.62 schwarze 810: MDOC_Ft != n->tok &&
811: MDOC_Fo != n->tok &&
812: MDOC_Fn != n->tok) {
1.23 schwarze 813: outflags |= MMAN_br;
814: return;
815: }
816:
817: switch (n->prev->tok) {
1.62 schwarze 818: case MDOC_Fd:
1.23 schwarze 819: /* FALLTHROUGH */
1.62 schwarze 820: case MDOC_Fn:
1.23 schwarze 821: /* FALLTHROUGH */
1.62 schwarze 822: case MDOC_Fo:
1.23 schwarze 823: /* FALLTHROUGH */
1.62 schwarze 824: case MDOC_In:
1.23 schwarze 825: /* FALLTHROUGH */
1.62 schwarze 826: case MDOC_Vt:
1.23 schwarze 827: outflags |= MMAN_sp;
828: break;
1.62 schwarze 829: case MDOC_Ft:
1.23 schwarze 830: if (MDOC_Fn != n->tok && MDOC_Fo != n->tok) {
831: outflags |= MMAN_sp;
832: break;
833: }
834: /* FALLTHROUGH */
835: default:
836: outflags |= MMAN_br;
837: break;
838: }
839: }
840:
1.22 schwarze 841: static int
842: pre_an(DECL_ARGS)
843: {
844:
845: switch (n->norm->An.auth) {
1.62 schwarze 846: case AUTH_split:
1.22 schwarze 847: outflags &= ~MMAN_An_nosplit;
848: outflags |= MMAN_An_split;
849: return(0);
1.62 schwarze 850: case AUTH_nosplit:
1.22 schwarze 851: outflags &= ~MMAN_An_split;
852: outflags |= MMAN_An_nosplit;
853: return(0);
854: default:
855: if (MMAN_An_split & outflags)
856: outflags |= MMAN_br;
857: else if (SEC_AUTHORS == n->sec &&
858: ! (MMAN_An_nosplit & outflags))
859: outflags |= MMAN_An_split;
860: return(1);
861: }
1.3 schwarze 862: }
863:
864: static int
865: pre_ap(DECL_ARGS)
866: {
867:
1.20 schwarze 868: outflags &= ~MMAN_spc;
869: print_word("'");
870: outflags &= ~MMAN_spc;
1.3 schwarze 871: return(0);
1.74 schwarze 872: }
873:
874: static int
875: pre_aq(DECL_ARGS)
876: {
877:
878: print_word(n->parent->prev != NULL &&
879: n->parent->prev->tok == MDOC_An ? "<" : "\\(la");
880: outflags &= ~MMAN_spc;
881: return(1);
882: }
883:
884: static void
885: post_aq(DECL_ARGS)
886: {
887:
888: outflags &= ~(MMAN_spc | MMAN_nl);
889: print_word(n->parent->prev != NULL &&
890: n->parent->prev->tok == MDOC_An ? ">" : "\\(ra");
1.3 schwarze 891: }
892:
893: static int
894: pre_bd(DECL_ARGS)
895: {
896:
1.36 schwarze 897: outflags &= ~(MMAN_PP | MMAN_sp | MMAN_br);
898:
899: if (DISP_unfilled == n->norm->Bd.type ||
900: DISP_literal == n->norm->Bd.type)
901: print_line(".nf", 0);
902: if (0 == n->norm->Bd.comp && NULL != n->parent->prev)
1.21 schwarze 903: outflags |= MMAN_sp;
1.71 schwarze 904: print_offs(n->norm->Bd.offs, 1);
1.3 schwarze 905: return(1);
906: }
907:
908: static void
909: post_bd(DECL_ARGS)
910: {
911:
1.43 schwarze 912: /* Close out this display. */
1.36 schwarze 913: print_line(".RE", MMAN_nl);
1.3 schwarze 914: if (DISP_unfilled == n->norm->Bd.type ||
1.36 schwarze 915: DISP_literal == n->norm->Bd.type)
916: print_line(".fi", MMAN_nl);
1.43 schwarze 917:
1.47 schwarze 918: /* Maybe we are inside an enclosing list? */
919: if (NULL != n->parent->next)
920: mid_it();
1.13 schwarze 921: }
922:
923: static int
1.27 schwarze 924: pre_bf(DECL_ARGS)
925: {
926:
927: switch (n->type) {
1.62 schwarze 928: case MDOC_BLOCK:
1.27 schwarze 929: return(1);
1.62 schwarze 930: case MDOC_BODY:
1.27 schwarze 931: break;
932: default:
933: return(0);
934: }
935: switch (n->norm->Bf.font) {
1.62 schwarze 936: case FONT_Em:
1.27 schwarze 937: font_push('I');
938: break;
1.62 schwarze 939: case FONT_Sy:
1.27 schwarze 940: font_push('B');
941: break;
942: default:
943: font_push('R');
944: break;
945: }
946: return(1);
947: }
948:
949: static void
950: post_bf(DECL_ARGS)
951: {
952:
953: if (MDOC_BODY == n->type)
954: font_pop();
955: }
956:
957: static int
1.13 schwarze 958: pre_bk(DECL_ARGS)
959: {
960:
961: switch (n->type) {
1.62 schwarze 962: case MDOC_BLOCK:
1.13 schwarze 963: return(1);
1.62 schwarze 964: case MDOC_BODY:
1.20 schwarze 965: outflags |= MMAN_Bk;
1.13 schwarze 966: return(1);
967: default:
968: return(0);
969: }
970: }
971:
972: static void
973: post_bk(DECL_ARGS)
974: {
975:
1.54 schwarze 976: if (MDOC_BODY == n->type)
1.20 schwarze 977: outflags &= ~MMAN_Bk;
1.3 schwarze 978: }
979:
980: static int
1.30 schwarze 981: pre_bl(DECL_ARGS)
982: {
1.33 schwarze 983: size_t icol;
1.30 schwarze 984:
1.49 schwarze 985: /*
986: * print_offs() will increase the -offset to account for
987: * a possible enclosing .It, but any enclosed .It blocks
988: * just nest and do not add up their indentation.
989: */
990: if (n->norm->Bl.offs) {
1.71 schwarze 991: print_offs(n->norm->Bl.offs, 0);
1.49 schwarze 992: Bl_stack[Bl_stack_len++] = 0;
993: }
994:
1.33 schwarze 995: switch (n->norm->Bl.type) {
1.62 schwarze 996: case LIST_enum:
1.30 schwarze 997: n->norm->Bl.count = 0;
1.33 schwarze 998: return(1);
1.62 schwarze 999: case LIST_column:
1.33 schwarze 1000: break;
1001: default:
1002: return(1);
1003: }
1004:
1.36 schwarze 1005: print_line(".TS", MMAN_nl);
1.33 schwarze 1006: for (icol = 0; icol < n->norm->Bl.ncols; icol++)
1007: print_word("l");
1008: print_word(".");
1.36 schwarze 1009: outflags |= MMAN_nl;
1.30 schwarze 1010: return(1);
1011: }
1012:
1013: static void
1014: post_bl(DECL_ARGS)
1015: {
1016:
1.33 schwarze 1017: switch (n->norm->Bl.type) {
1.62 schwarze 1018: case LIST_column:
1.36 schwarze 1019: print_line(".TE", 0);
1020: break;
1.62 schwarze 1021: case LIST_enum:
1.33 schwarze 1022: n->norm->Bl.count = 0;
1023: break;
1024: default:
1025: break;
1026: }
1.49 schwarze 1027:
1028: if (n->norm->Bl.offs) {
1029: print_line(".RE", MMAN_nl);
1030: assert(Bl_stack_len);
1031: Bl_stack_len--;
1032: assert(0 == Bl_stack[Bl_stack_len]);
1033: } else {
1034: outflags |= MMAN_PP | MMAN_nl;
1035: outflags &= ~(MMAN_sp | MMAN_br);
1036: }
1.47 schwarze 1037:
1038: /* Maybe we are inside an enclosing list? */
1039: if (NULL != n->parent->next)
1040: mid_it();
1041:
1.30 schwarze 1042: }
1043:
1044: static int
1.3 schwarze 1045: pre_br(DECL_ARGS)
1046: {
1047:
1.21 schwarze 1048: outflags |= MMAN_br;
1.3 schwarze 1049: return(0);
1050: }
1051:
1052: static int
1.8 schwarze 1053: pre_bx(DECL_ARGS)
1054: {
1055:
1056: n = n->child;
1057: if (n) {
1.20 schwarze 1058: print_word(n->string);
1059: outflags &= ~MMAN_spc;
1.8 schwarze 1060: n = n->next;
1061: }
1.20 schwarze 1062: print_word("BSD");
1.8 schwarze 1063: if (NULL == n)
1064: return(0);
1.20 schwarze 1065: outflags &= ~MMAN_spc;
1066: print_word("-");
1067: outflags &= ~MMAN_spc;
1068: print_word(n->string);
1.8 schwarze 1069: return(0);
1070: }
1071:
1072: static int
1.1 schwarze 1073: pre_dl(DECL_ARGS)
1074: {
1075:
1.71 schwarze 1076: print_offs("6n", 0);
1.1 schwarze 1077: return(1);
1078: }
1079:
1080: static void
1081: post_dl(DECL_ARGS)
1082: {
1083:
1.36 schwarze 1084: print_line(".RE", MMAN_nl);
1.47 schwarze 1085:
1086: /* Maybe we are inside an enclosing list? */
1087: if (NULL != n->parent->next)
1088: mid_it();
1.16 schwarze 1089: }
1090:
1091: static int
1.26 schwarze 1092: pre_em(DECL_ARGS)
1093: {
1094:
1095: font_push('I');
1096: return(1);
1.28 schwarze 1097: }
1098:
1.64 schwarze 1099: static int
1100: pre_en(DECL_ARGS)
1101: {
1102:
1103: if (NULL == n->norm->Es ||
1104: NULL == n->norm->Es->child)
1105: return(1);
1106:
1107: print_word(n->norm->Es->child->string);
1108: outflags &= ~MMAN_spc;
1109: return(1);
1110: }
1111:
1112: static void
1113: post_en(DECL_ARGS)
1114: {
1115:
1116: if (NULL == n->norm->Es ||
1117: NULL == n->norm->Es->child ||
1118: NULL == n->norm->Es->child->next)
1119: return;
1120:
1121: outflags &= ~MMAN_spc;
1122: print_word(n->norm->Es->child->next->string);
1123: return;
1124: }
1125:
1.28 schwarze 1126: static void
1127: post_eo(DECL_ARGS)
1128: {
1129:
1130: if (MDOC_HEAD == n->type || MDOC_BODY == n->type)
1131: outflags &= ~MMAN_spc;
1.64 schwarze 1132: }
1133:
1134: static int
1.17 schwarze 1135: pre_fa(DECL_ARGS)
1136: {
1.57 schwarze 1137: int am_Fa;
1.17 schwarze 1138:
1.57 schwarze 1139: am_Fa = MDOC_Fa == n->tok;
1140:
1141: if (am_Fa)
1.17 schwarze 1142: n = n->child;
1143:
1144: while (NULL != n) {
1.26 schwarze 1145: font_push('I');
1.57 schwarze 1146: if (am_Fa || MDOC_SYNPRETTY & n->flags)
1.56 schwarze 1147: outflags |= MMAN_nbrword;
1.42 schwarze 1148: print_node(meta, n);
1.26 schwarze 1149: font_pop();
1.17 schwarze 1150: if (NULL != (n = n->next))
1.20 schwarze 1151: print_word(",");
1.17 schwarze 1152: }
1153: return(0);
1154: }
1155:
1156: static void
1157: post_fa(DECL_ARGS)
1158: {
1159:
1160: if (NULL != n->next && MDOC_Fa == n->next->tok)
1.20 schwarze 1161: print_word(",");
1.29 schwarze 1162: }
1163:
1164: static int
1165: pre_fd(DECL_ARGS)
1166: {
1167:
1168: pre_syn(n);
1169: font_push('B');
1170: return(1);
1171: }
1172:
1173: static void
1174: post_fd(DECL_ARGS)
1175: {
1176:
1177: font_pop();
1178: outflags |= MMAN_br;
1.17 schwarze 1179: }
1180:
1181: static int
1.26 schwarze 1182: pre_fl(DECL_ARGS)
1183: {
1184:
1185: font_push('B');
1.45 schwarze 1186: print_word("\\-");
1.70 schwarze 1187: if (n->nchild)
1188: outflags &= ~MMAN_spc;
1.26 schwarze 1189: return(1);
1190: }
1191:
1192: static void
1193: post_fl(DECL_ARGS)
1194: {
1195:
1196: font_pop();
1.70 schwarze 1197: if ( ! (n->nchild ||
1198: n->next == NULL ||
1199: n->next->type == MDOC_TEXT ||
1200: n->next->flags & MDOC_LINE))
1.26 schwarze 1201: outflags &= ~MMAN_spc;
1202: }
1203:
1204: static int
1.16 schwarze 1205: pre_fn(DECL_ARGS)
1206: {
1207:
1.23 schwarze 1208: pre_syn(n);
1209:
1.16 schwarze 1210: n = n->child;
1211: if (NULL == n)
1212: return(0);
1213:
1.55 schwarze 1214: if (MDOC_SYNPRETTY & n->flags)
1215: print_block(".HP 4n", MMAN_nl);
1216:
1.26 schwarze 1217: font_push('B');
1.42 schwarze 1218: print_node(meta, n);
1.26 schwarze 1219: font_pop();
1.20 schwarze 1220: outflags &= ~MMAN_spc;
1.26 schwarze 1221: print_word("(");
1.20 schwarze 1222: outflags &= ~MMAN_spc;
1.35 schwarze 1223:
1224: n = n->next;
1225: if (NULL != n)
1.42 schwarze 1226: pre_fa(meta, n);
1.35 schwarze 1227: return(0);
1.16 schwarze 1228: }
1229:
1230: static void
1231: post_fn(DECL_ARGS)
1232: {
1233:
1.20 schwarze 1234: print_word(")");
1.16 schwarze 1235: if (MDOC_SYNPRETTY & n->flags) {
1.20 schwarze 1236: print_word(";");
1.55 schwarze 1237: outflags |= MMAN_PP;
1.17 schwarze 1238: }
1239: }
1240:
1241: static int
1242: pre_fo(DECL_ARGS)
1243: {
1244:
1245: switch (n->type) {
1.62 schwarze 1246: case MDOC_BLOCK:
1.23 schwarze 1247: pre_syn(n);
1248: break;
1.62 schwarze 1249: case MDOC_HEAD:
1.57 schwarze 1250: if (MDOC_SYNPRETTY & n->flags)
1251: print_block(".HP 4n", MMAN_nl);
1.26 schwarze 1252: font_push('B');
1.17 schwarze 1253: break;
1.62 schwarze 1254: case MDOC_BODY:
1.20 schwarze 1255: outflags &= ~MMAN_spc;
1256: print_word("(");
1257: outflags &= ~MMAN_spc;
1.17 schwarze 1258: break;
1259: default:
1260: break;
1261: }
1262: return(1);
1263: }
1.57 schwarze 1264:
1.17 schwarze 1265: static void
1266: post_fo(DECL_ARGS)
1267: {
1268:
1269: switch (n->type) {
1.62 schwarze 1270: case MDOC_HEAD:
1.26 schwarze 1271: font_pop();
1.17 schwarze 1272: break;
1.62 schwarze 1273: case MDOC_BODY:
1.42 schwarze 1274: post_fn(meta, n);
1.17 schwarze 1275: break;
1276: default:
1277: break;
1.16 schwarze 1278: }
1.15 schwarze 1279: }
1280:
1281: static int
1.23 schwarze 1282: pre_ft(DECL_ARGS)
1283: {
1284:
1285: pre_syn(n);
1.26 schwarze 1286: font_push('I');
1.23 schwarze 1287: return(1);
1288: }
1289:
1290: static int
1.15 schwarze 1291: pre_in(DECL_ARGS)
1292: {
1293:
1294: if (MDOC_SYNPRETTY & n->flags) {
1.23 schwarze 1295: pre_syn(n);
1.26 schwarze 1296: font_push('B');
1297: print_word("#include <");
1298: outflags &= ~MMAN_spc;
1299: } else {
1300: print_word("<");
1301: outflags &= ~MMAN_spc;
1302: font_push('I');
1303: }
1.15 schwarze 1304: return(1);
1305: }
1306:
1307: static void
1308: post_in(DECL_ARGS)
1309: {
1310:
1311: if (MDOC_SYNPRETTY & n->flags) {
1.26 schwarze 1312: outflags &= ~MMAN_spc;
1313: print_word(">");
1314: font_pop();
1.21 schwarze 1315: outflags |= MMAN_br;
1.26 schwarze 1316: } else {
1317: font_pop();
1318: outflags &= ~MMAN_spc;
1319: print_word(">");
1320: }
1.1 schwarze 1321: }
1322:
1323: static int
1324: pre_it(DECL_ARGS)
1325: {
1326: const struct mdoc_node *bln;
1327:
1.30 schwarze 1328: switch (n->type) {
1.62 schwarze 1329: case MDOC_HEAD:
1.36 schwarze 1330: outflags |= MMAN_PP | MMAN_nl;
1.30 schwarze 1331: bln = n->parent->parent;
1.36 schwarze 1332: if (0 == bln->norm->Bl.comp ||
1.39 schwarze 1333: (NULL == n->parent->prev &&
1334: NULL == bln->parent->prev))
1.36 schwarze 1335: outflags |= MMAN_sp;
1336: outflags &= ~MMAN_br;
1.3 schwarze 1337: switch (bln->norm->Bl.type) {
1.62 schwarze 1338: case LIST_item:
1.30 schwarze 1339: return(0);
1.62 schwarze 1340: case LIST_inset:
1.30 schwarze 1341: /* FALLTHROUGH */
1.62 schwarze 1342: case LIST_diag:
1.30 schwarze 1343: /* FALLTHROUGH */
1.62 schwarze 1344: case LIST_ohang:
1.30 schwarze 1345: if (bln->norm->Bl.type == LIST_diag)
1.36 schwarze 1346: print_line(".B \"", 0);
1.30 schwarze 1347: else
1.36 schwarze 1348: print_line(".R \"", 0);
1.30 schwarze 1349: outflags &= ~MMAN_spc;
1350: return(1);
1.62 schwarze 1351: case LIST_bullet:
1.30 schwarze 1352: /* FALLTHROUGH */
1.62 schwarze 1353: case LIST_dash:
1.30 schwarze 1354: /* FALLTHROUGH */
1.62 schwarze 1355: case LIST_hyphen:
1.35 schwarze 1356: print_width(bln->norm->Bl.width, NULL, 0);
1.37 schwarze 1357: TPremain = 0;
1.30 schwarze 1358: outflags |= MMAN_nl;
1359: font_push('B');
1360: if (LIST_bullet == bln->norm->Bl.type)
1.72 schwarze 1361: print_word("\\(bu");
1.30 schwarze 1362: else
1363: print_word("-");
1364: font_pop();
1.66 schwarze 1365: outflags |= MMAN_nl;
1366: return(0);
1.62 schwarze 1367: case LIST_enum:
1.35 schwarze 1368: print_width(bln->norm->Bl.width, NULL, 0);
1.37 schwarze 1369: TPremain = 0;
1.30 schwarze 1370: outflags |= MMAN_nl;
1371: print_count(&bln->norm->Bl.count);
1.66 schwarze 1372: outflags |= MMAN_nl;
1373: return(0);
1.62 schwarze 1374: case LIST_hang:
1.35 schwarze 1375: print_width(bln->norm->Bl.width, n->child, 6);
1.37 schwarze 1376: TPremain = 0;
1.66 schwarze 1377: outflags |= MMAN_nl;
1378: return(1);
1.62 schwarze 1379: case LIST_tag:
1.37 schwarze 1380: print_width(bln->norm->Bl.width, n->child, 0);
1381: putchar('\n');
1382: outflags &= ~MMAN_spc;
1383: return(1);
1.3 schwarze 1384: default:
1.32 schwarze 1385: return(1);
1.3 schwarze 1386: }
1.30 schwarze 1387: default:
1388: break;
1.1 schwarze 1389: }
1390: return(1);
1.30 schwarze 1391: }
1392:
1.47 schwarze 1393: /*
1394: * This function is called after closing out an indented block.
1395: * If we are inside an enclosing list, restore its indentation.
1396: */
1397: static void
1398: mid_it(void)
1399: {
1400: char buf[24];
1401:
1402: /* Nothing to do outside a list. */
1403: if (0 == Bl_stack_len || 0 == Bl_stack[Bl_stack_len - 1])
1404: return;
1405:
1406: /* The indentation has already been set up. */
1407: if (Bl_stack_post[Bl_stack_len - 1])
1408: return;
1409:
1410: /* Restore the indentation of the enclosing list. */
1411: print_line(".RS", MMAN_Bk_susp);
1.63 schwarze 1412: (void)snprintf(buf, sizeof(buf), "%zun",
1413: Bl_stack[Bl_stack_len - 1]);
1.47 schwarze 1414: print_word(buf);
1415:
1416: /* Remeber to close out this .RS block later. */
1417: Bl_stack_post[Bl_stack_len - 1] = 1;
1418: }
1419:
1.30 schwarze 1420: static void
1421: post_it(DECL_ARGS)
1422: {
1423: const struct mdoc_node *bln;
1424:
1.33 schwarze 1425: bln = n->parent->parent;
1426:
1427: switch (n->type) {
1.62 schwarze 1428: case MDOC_HEAD:
1.30 schwarze 1429: switch (bln->norm->Bl.type) {
1.62 schwarze 1430: case LIST_diag:
1.30 schwarze 1431: outflags &= ~MMAN_spc;
1432: print_word("\\ ");
1433: break;
1.62 schwarze 1434: case LIST_ohang:
1.30 schwarze 1435: outflags |= MMAN_br;
1436: break;
1437: default:
1438: break;
1439: }
1.33 schwarze 1440: break;
1.62 schwarze 1441: case MDOC_BODY:
1.43 schwarze 1442: switch (bln->norm->Bl.type) {
1.62 schwarze 1443: case LIST_bullet:
1.43 schwarze 1444: /* FALLTHROUGH */
1.62 schwarze 1445: case LIST_dash:
1.43 schwarze 1446: /* FALLTHROUGH */
1.62 schwarze 1447: case LIST_hyphen:
1.43 schwarze 1448: /* FALLTHROUGH */
1.62 schwarze 1449: case LIST_enum:
1.43 schwarze 1450: /* FALLTHROUGH */
1.62 schwarze 1451: case LIST_hang:
1.43 schwarze 1452: /* FALLTHROUGH */
1.62 schwarze 1453: case LIST_tag:
1.43 schwarze 1454: assert(Bl_stack_len);
1455: Bl_stack[--Bl_stack_len] = 0;
1456:
1457: /*
1458: * Our indentation had to be restored
1.47 schwarze 1459: * after a child display or child list.
1.43 schwarze 1460: * Close out that indentation block now.
1461: */
1462: if (Bl_stack_post[Bl_stack_len]) {
1463: print_line(".RE", MMAN_nl);
1464: Bl_stack_post[Bl_stack_len] = 0;
1465: }
1466: break;
1.62 schwarze 1467: case LIST_column:
1.43 schwarze 1468: if (NULL != n->next) {
1469: putchar('\t');
1470: outflags &= ~MMAN_spc;
1471: }
1472: break;
1473: default:
1474: break;
1.33 schwarze 1475: }
1476: break;
1477: default:
1478: break;
1.30 schwarze 1479: }
1.14 schwarze 1480: }
1481:
1482: static void
1483: post_lb(DECL_ARGS)
1484: {
1485:
1.21 schwarze 1486: if (SEC_LIBRARY == n->sec)
1487: outflags |= MMAN_br;
1.24 schwarze 1488: }
1489:
1490: static int
1491: pre_lk(DECL_ARGS)
1492: {
1493: const struct mdoc_node *link, *descr;
1494:
1495: if (NULL == (link = n->child))
1496: return(0);
1497:
1498: if (NULL != (descr = link->next)) {
1.26 schwarze 1499: font_push('I');
1.24 schwarze 1500: while (NULL != descr) {
1501: print_word(descr->string);
1502: descr = descr->next;
1503: }
1504: print_word(":");
1.26 schwarze 1505: font_pop();
1.24 schwarze 1506: }
1507:
1.26 schwarze 1508: font_push('B');
1.24 schwarze 1509: print_word(link->string);
1.26 schwarze 1510: font_pop();
1.24 schwarze 1511: return(0);
1.60 schwarze 1512: }
1513:
1514: static int
1515: pre_ll(DECL_ARGS)
1516: {
1517:
1518: print_line(".ll", 0);
1519: return(1);
1.1 schwarze 1520: }
1521:
1522: static int
1.26 schwarze 1523: pre_li(DECL_ARGS)
1524: {
1525:
1526: font_push('R');
1527: return(1);
1528: }
1529:
1530: static int
1.1 schwarze 1531: pre_nm(DECL_ARGS)
1532: {
1.38 schwarze 1533: char *name;
1.1 schwarze 1534:
1.54 schwarze 1535: if (MDOC_BLOCK == n->type) {
1536: outflags |= MMAN_Bk;
1.23 schwarze 1537: pre_syn(n);
1.54 schwarze 1538: }
1.1 schwarze 1539: if (MDOC_ELEM != n->type && MDOC_HEAD != n->type)
1540: return(1);
1.42 schwarze 1541: name = n->child ? n->child->string : meta->name;
1.38 schwarze 1542: if (NULL == name)
1.23 schwarze 1543: return(0);
1.38 schwarze 1544: if (MDOC_HEAD == n->type) {
1545: if (NULL == n->parent->prev)
1546: outflags |= MMAN_sp;
1547: print_block(".HP", 0);
1.53 schwarze 1548: printf(" %zun", strlen(name) + 1);
1.38 schwarze 1549: outflags |= MMAN_nl;
1550: }
1.26 schwarze 1551: font_push('B');
1.1 schwarze 1552: if (NULL == n->child)
1.42 schwarze 1553: print_word(meta->name);
1.1 schwarze 1554: return(1);
1555: }
1556:
1557: static void
1558: post_nm(DECL_ARGS)
1559: {
1560:
1.54 schwarze 1561: switch (n->type) {
1.62 schwarze 1562: case MDOC_BLOCK:
1.54 schwarze 1563: outflags &= ~MMAN_Bk;
1564: break;
1.62 schwarze 1565: case MDOC_HEAD:
1.54 schwarze 1566: /* FALLTHROUGH */
1.62 schwarze 1567: case MDOC_ELEM:
1.67 schwarze 1568: if (n->child != NULL || meta->name != NULL)
1569: font_pop();
1.54 schwarze 1570: break;
1571: default:
1572: break;
1573: }
1.25 schwarze 1574: }
1575:
1576: static int
1577: pre_no(DECL_ARGS)
1578: {
1579:
1580: outflags |= MMAN_spc_force;
1581: return(1);
1.1 schwarze 1582: }
1583:
1584: static int
1585: pre_ns(DECL_ARGS)
1586: {
1587:
1.20 schwarze 1588: outflags &= ~MMAN_spc;
1.1 schwarze 1589: return(0);
1590: }
1591:
1.3 schwarze 1592: static void
1593: post_pf(DECL_ARGS)
1594: {
1595:
1.20 schwarze 1596: outflags &= ~MMAN_spc;
1.3 schwarze 1597: }
1598:
1.1 schwarze 1599: static int
1600: pre_pp(DECL_ARGS)
1601: {
1602:
1.36 schwarze 1603: if (MDOC_It != n->parent->tok)
1604: outflags |= MMAN_PP;
1605: outflags |= MMAN_sp | MMAN_nl;
1606: outflags &= ~MMAN_br;
1.34 schwarze 1607: return(0);
1608: }
1609:
1610: static int
1611: pre_rs(DECL_ARGS)
1612: {
1613:
1614: if (SEC_SEE_ALSO == n->sec) {
1.36 schwarze 1615: outflags |= MMAN_PP | MMAN_sp | MMAN_nl;
1616: outflags &= ~MMAN_br;
1.34 schwarze 1617: }
1618: return(1);
1.67 schwarze 1619: }
1620:
1621: static int
1622: pre_rv(DECL_ARGS)
1623: {
1624: int nchild;
1625:
1626: outflags |= MMAN_br | MMAN_nl;
1627:
1628: nchild = n->nchild;
1629: if (nchild > 0) {
1630: print_word("The");
1631:
1632: for (n = n->child; n; n = n->next) {
1633: font_push('B');
1634: print_word(n->string);
1635: font_pop();
1636:
1637: outflags &= ~MMAN_spc;
1638: print_word("()");
1639:
1640: if (n->next == NULL)
1641: continue;
1642:
1643: if (nchild > 2) {
1644: outflags &= ~MMAN_spc;
1645: print_word(",");
1646: }
1647: if (n->next->next == NULL)
1648: print_word("and");
1649: }
1650:
1651: if (nchild > 1)
1652: print_word("functions return");
1653: else
1654: print_word("function returns");
1655:
1656: print_word("the value\\~0 if successful;");
1657: } else
1658: print_word("Upon successful completion, "
1659: "the value\\~0 is returned;");
1660:
1661: print_word("otherwise the value\\~\\-1 is returned"
1662: " and the global variable");
1663:
1664: font_push('I');
1665: print_word("errno");
1666: font_pop();
1667:
1668: print_word("is set to indicate the error.");
1669: outflags |= MMAN_nl;
1.75 ! schwarze 1670: return(0);
! 1671: }
! 1672:
! 1673: static int
! 1674: pre_skip(DECL_ARGS)
! 1675: {
! 1676:
1.67 schwarze 1677: return(0);
1.12 schwarze 1678: }
1679:
1680: static int
1681: pre_sm(DECL_ARGS)
1682: {
1683:
1.65 schwarze 1684: if (NULL == n->child)
1685: outflags ^= MMAN_Sm;
1686: else if (0 == strcmp("on", n->child->string))
1687: outflags |= MMAN_Sm;
1.12 schwarze 1688: else
1.20 schwarze 1689: outflags &= ~MMAN_Sm;
1.65 schwarze 1690:
1691: if (MMAN_Sm & outflags)
1692: outflags |= MMAN_spc;
1693:
1.12 schwarze 1694: return(0);
1.1 schwarze 1695: }
1696:
1697: static int
1.3 schwarze 1698: pre_sp(DECL_ARGS)
1.1 schwarze 1699: {
1700:
1.41 schwarze 1701: if (MMAN_PP & outflags) {
1702: outflags &= ~MMAN_PP;
1.40 schwarze 1703: print_line(".PP", 0);
1.41 schwarze 1704: } else
1.40 schwarze 1705: print_line(".sp", 0);
1.1 schwarze 1706: return(1);
1707: }
1708:
1709: static void
1.3 schwarze 1710: post_sp(DECL_ARGS)
1.1 schwarze 1711: {
1712:
1.20 schwarze 1713: outflags |= MMAN_nl;
1.18 schwarze 1714: }
1715:
1716: static int
1.26 schwarze 1717: pre_sy(DECL_ARGS)
1718: {
1719:
1720: font_push('B');
1721: return(1);
1722: }
1723:
1724: static int
1.18 schwarze 1725: pre_vt(DECL_ARGS)
1726: {
1727:
1728: if (MDOC_SYNPRETTY & n->flags) {
1729: switch (n->type) {
1.62 schwarze 1730: case MDOC_BLOCK:
1.23 schwarze 1731: pre_syn(n);
1.18 schwarze 1732: return(1);
1.62 schwarze 1733: case MDOC_BODY:
1.18 schwarze 1734: break;
1735: default:
1736: return(0);
1737: }
1738: }
1.26 schwarze 1739: font_push('I');
1.18 schwarze 1740: return(1);
1741: }
1742:
1743: static void
1744: post_vt(DECL_ARGS)
1745: {
1746:
1.19 schwarze 1747: if (MDOC_SYNPRETTY & n->flags && MDOC_BODY != n->type)
1.18 schwarze 1748: return;
1.26 schwarze 1749: font_pop();
1.1 schwarze 1750: }
1751:
1752: static int
1753: pre_xr(DECL_ARGS)
1754: {
1755:
1756: n = n->child;
1757: if (NULL == n)
1758: return(0);
1.42 schwarze 1759: print_node(meta, n);
1.1 schwarze 1760: n = n->next;
1761: if (NULL == n)
1762: return(0);
1.20 schwarze 1763: outflags &= ~MMAN_spc;
1764: print_word("(");
1.42 schwarze 1765: print_node(meta, n);
1.20 schwarze 1766: print_word(")");
1.1 schwarze 1767: return(0);
1.8 schwarze 1768: }
1769:
1770: static int
1771: pre_ux(DECL_ARGS)
1772: {
1773:
1.20 schwarze 1774: print_word(manacts[n->tok].prefix);
1.8 schwarze 1775: if (NULL == n->child)
1776: return(0);
1.20 schwarze 1777: outflags &= ~MMAN_spc;
1.45 schwarze 1778: print_word("\\ ");
1.20 schwarze 1779: outflags &= ~MMAN_spc;
1.8 schwarze 1780: return(1);
1.1 schwarze 1781: }
CVSweb