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