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