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