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