Annotation of mandoc/mdoc_man.c, Revision 1.23
1.23 ! schwarze 1: /* $Id: mdoc_man.c,v 1.22 2012/07/08 16:52:20 schwarze Exp $ */
1.1 schwarze 2: /*
1.11 schwarze 3: * Copyright (c) 2011, 2012 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: #ifdef HAVE_CONFIG_H
18: #include "config.h"
19: #endif
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.11 schwarze 26: #include "out.h"
1.4 kristaps 27: #include "man.h"
1.1 schwarze 28: #include "mdoc.h"
29: #include "main.h"
30:
1.5 kristaps 31: #define DECL_ARGS const struct mdoc_meta *m, \
1.20 schwarze 32: const struct mdoc_node *n
1.1 schwarze 33:
34: struct manact {
1.5 kristaps 35: int (*cond)(DECL_ARGS); /* DON'T run actions */
36: int (*pre)(DECL_ARGS); /* pre-node action */
37: void (*post)(DECL_ARGS); /* post-node action */
38: const char *prefix; /* pre-node string constant */
39: const char *suffix; /* post-node string constant */
1.1 schwarze 40: };
41:
1.5 kristaps 42: static int cond_body(DECL_ARGS);
1.1 schwarze 43: static int cond_head(DECL_ARGS);
1.5 kristaps 44: static void post_bd(DECL_ARGS);
1.13 schwarze 45: static void post_bk(DECL_ARGS);
1.5 kristaps 46: static void post_dl(DECL_ARGS);
1.1 schwarze 47: static void post_enc(DECL_ARGS);
1.17 schwarze 48: static void post_fa(DECL_ARGS);
1.16 schwarze 49: static void post_fn(DECL_ARGS);
1.17 schwarze 50: static void post_fo(DECL_ARGS);
1.15 schwarze 51: static void post_in(DECL_ARGS);
1.14 schwarze 52: static void post_lb(DECL_ARGS);
1.5 kristaps 53: static void post_nm(DECL_ARGS);
1.1 schwarze 54: static void post_percent(DECL_ARGS);
1.5 kristaps 55: static void post_pf(DECL_ARGS);
1.3 schwarze 56: static void post_sect(DECL_ARGS);
1.5 kristaps 57: static void post_sp(DECL_ARGS);
1.18 schwarze 58: static void post_vt(DECL_ARGS);
1.22 schwarze 59: static int pre_an(DECL_ARGS);
1.3 schwarze 60: static int pre_ap(DECL_ARGS);
61: static int pre_bd(DECL_ARGS);
1.13 schwarze 62: static int pre_bk(DECL_ARGS);
1.3 schwarze 63: static int pre_br(DECL_ARGS);
1.8 schwarze 64: static int pre_bx(DECL_ARGS);
1.1 schwarze 65: static int pre_dl(DECL_ARGS);
1.5 kristaps 66: static int pre_enc(DECL_ARGS);
1.17 schwarze 67: static int pre_fa(DECL_ARGS);
1.16 schwarze 68: static int pre_fn(DECL_ARGS);
1.17 schwarze 69: static int pre_fo(DECL_ARGS);
1.23 ! schwarze 70: static int pre_ft(DECL_ARGS);
1.15 schwarze 71: static int pre_in(DECL_ARGS);
1.1 schwarze 72: static int pre_it(DECL_ARGS);
73: static int pre_nm(DECL_ARGS);
74: static int pre_ns(DECL_ARGS);
75: static int pre_pp(DECL_ARGS);
1.12 schwarze 76: static int pre_sm(DECL_ARGS);
1.3 schwarze 77: static int pre_sp(DECL_ARGS);
1.5 kristaps 78: static int pre_sect(DECL_ARGS);
1.23 ! schwarze 79: static void pre_syn(const struct mdoc_node *);
1.18 schwarze 80: static int pre_vt(DECL_ARGS);
1.8 schwarze 81: static int pre_ux(DECL_ARGS);
1.1 schwarze 82: static int pre_xr(DECL_ARGS);
1.20 schwarze 83: static void print_word(const char *);
84: static void print_offs(const char *);
1.5 kristaps 85: static void print_node(DECL_ARGS);
1.1 schwarze 86:
1.3 schwarze 87: static const struct manact manacts[MDOC_MAX + 1] = {
88: { NULL, pre_ap, NULL, NULL, NULL }, /* Ap */
89: { NULL, NULL, NULL, NULL, NULL }, /* Dd */
90: { NULL, NULL, NULL, NULL, NULL }, /* Dt */
1.8 schwarze 91: { NULL, NULL, NULL, NULL, NULL }, /* Os */
1.3 schwarze 92: { NULL, pre_sect, post_sect, ".SH", NULL }, /* Sh */
93: { NULL, pre_sect, post_sect, ".SS", NULL }, /* Ss */
1.1 schwarze 94: { NULL, pre_pp, NULL, NULL, NULL }, /* Pp */
1.3 schwarze 95: { cond_body, pre_dl, post_dl, NULL, NULL }, /* D1 */
1.1 schwarze 96: { cond_body, pre_dl, post_dl, NULL, NULL }, /* Dl */
1.3 schwarze 97: { cond_body, pre_bd, post_bd, NULL, NULL }, /* Bd */
98: { NULL, NULL, NULL, NULL, NULL }, /* Ed */
99: { NULL, NULL, NULL, NULL, NULL }, /* Bl */
100: { NULL, NULL, NULL, NULL, NULL }, /* El */
1.1 schwarze 101: { NULL, pre_it, NULL, NULL, NULL }, /* _It */
1.9 schwarze 102: { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Ad */
1.22 schwarze 103: { NULL, pre_an, NULL, NULL, NULL }, /* An */
1.1 schwarze 104: { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Ar */
1.9 schwarze 105: { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Cd */
1.1 schwarze 106: { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Cm */
1.9 schwarze 107: { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Dv */
108: { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Er */
109: { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Ev */
1.1 schwarze 110: { NULL, pre_enc, post_enc, "The \\fB",
111: "\\fP\nutility exits 0 on success, and >0 if an error occurs."
112: }, /* Ex */
1.17 schwarze 113: { NULL, pre_fa, post_fa, NULL, NULL }, /* Fa */
1.1 schwarze 114: { NULL, NULL, NULL, NULL, NULL }, /* _Fd */
115: { NULL, pre_enc, post_enc, "\\fB-", "\\fP" }, /* Fl */
1.16 schwarze 116: { NULL, pre_fn, post_fn, NULL, NULL }, /* Fn */
1.23 ! schwarze 117: { NULL, pre_ft, post_enc, NULL, "\\fP" }, /* Ft */
1.3 schwarze 118: { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Ic */
1.15 schwarze 119: { NULL, pre_in, post_in, NULL, NULL }, /* In */
1.9 schwarze 120: { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Li */
1.1 schwarze 121: { cond_head, pre_enc, NULL, "\\- ", NULL }, /* Nd */
122: { NULL, pre_nm, post_nm, NULL, NULL }, /* Nm */
123: { cond_body, pre_enc, post_enc, "[", "]" }, /* Op */
1.8 schwarze 124: { NULL, NULL, NULL, NULL, NULL }, /* Ot */
125: { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Pa */
1.6 kristaps 126: { NULL, pre_enc, post_enc, "The \\fB",
127: "\\fP\nfunction returns the value 0 if successful;\n"
128: "otherwise the value -1 is returned and the global\n"
129: "variable \\fIerrno\\fP is set to indicate the error."
130: }, /* Rv */
1.8 schwarze 131: { NULL, NULL, NULL, NULL, NULL }, /* St */
1.19 schwarze 132: { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Va */
1.18 schwarze 133: { NULL, pre_vt, post_vt, NULL, NULL }, /* Vt */
1.8 schwarze 134: { NULL, pre_xr, NULL, NULL, NULL }, /* Xr */
1.1 schwarze 135: { NULL, NULL, post_percent, NULL, NULL }, /* _%A */
136: { NULL, NULL, NULL, NULL, NULL }, /* _%B */
137: { NULL, NULL, post_percent, NULL, NULL }, /* _%D */
138: { NULL, NULL, NULL, NULL, NULL }, /* _%I */
139: { NULL, pre_enc, post_percent, "\\fI", "\\fP" }, /* %J */
140: { NULL, NULL, NULL, NULL, NULL }, /* _%N */
141: { NULL, NULL, NULL, NULL, NULL }, /* _%O */
142: { NULL, NULL, NULL, NULL, NULL }, /* _%P */
143: { NULL, NULL, NULL, NULL, NULL }, /* _%R */
144: { NULL, pre_enc, post_percent, "\"", "\"" }, /* %T */
145: { NULL, NULL, NULL, NULL, NULL }, /* _%V */
1.9 schwarze 146: { NULL, NULL, NULL, NULL, NULL }, /* Ac */
147: { cond_body, pre_enc, post_enc, "<", ">" }, /* Ao */
1.1 schwarze 148: { cond_body, pre_enc, post_enc, "<", ">" }, /* Aq */
1.8 schwarze 149: { NULL, NULL, NULL, NULL, NULL }, /* At */
1.3 schwarze 150: { NULL, NULL, NULL, NULL, NULL }, /* Bc */
1.1 schwarze 151: { NULL, NULL, NULL, NULL, NULL }, /* _Bf */
1.3 schwarze 152: { cond_body, pre_enc, post_enc, "[", "]" }, /* Bo */
153: { cond_body, pre_enc, post_enc, "[", "]" }, /* Bq */
1.8 schwarze 154: { NULL, pre_ux, NULL, "BSD/OS", NULL }, /* Bsx */
155: { NULL, pre_bx, NULL, NULL, NULL }, /* Bx */
156: { NULL, NULL, NULL, NULL, NULL }, /* Db */
1.9 schwarze 157: { NULL, NULL, NULL, NULL, NULL }, /* Dc */
158: { cond_body, pre_enc, post_enc, "``", "''" }, /* Do */
1.1 schwarze 159: { cond_body, pre_enc, post_enc, "``", "''" }, /* Dq */
160: { NULL, NULL, NULL, NULL, NULL }, /* _Ec */
161: { NULL, NULL, NULL, NULL, NULL }, /* _Ef */
1.3 schwarze 162: { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Em */
1.1 schwarze 163: { NULL, NULL, NULL, NULL, NULL }, /* _Eo */
1.8 schwarze 164: { NULL, pre_ux, NULL, "FreeBSD", NULL }, /* Fx */
1.9 schwarze 165: { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Ms */
166: { NULL, NULL, NULL, NULL, NULL }, /* No */
1.1 schwarze 167: { NULL, pre_ns, NULL, NULL, NULL }, /* Ns */
1.8 schwarze 168: { NULL, pre_ux, NULL, "NetBSD", NULL }, /* Nx */
169: { NULL, pre_ux, NULL, "OpenBSD", NULL }, /* Ox */
1.3 schwarze 170: { NULL, NULL, NULL, NULL, NULL }, /* Pc */
171: { NULL, NULL, post_pf, NULL, NULL }, /* Pf */
172: { cond_body, pre_enc, post_enc, "(", ")" }, /* Po */
173: { cond_body, pre_enc, post_enc, "(", ")" }, /* Pq */
1.9 schwarze 174: { NULL, NULL, NULL, NULL, NULL }, /* Qc */
1.1 schwarze 175: { cond_body, pre_enc, post_enc, "`", "'" }, /* Ql */
1.9 schwarze 176: { cond_body, pre_enc, post_enc, "\"", "\"" }, /* Qo */
177: { cond_body, pre_enc, post_enc, "\"", "\"" }, /* Qq */
178: { NULL, NULL, NULL, NULL, NULL }, /* Re */
1.1 schwarze 179: { cond_body, pre_pp, NULL, NULL, NULL }, /* Rs */
1.9 schwarze 180: { NULL, NULL, NULL, NULL, NULL }, /* Sc */
181: { cond_body, pre_enc, post_enc, "`", "'" }, /* So */
1.1 schwarze 182: { cond_body, pre_enc, post_enc, "`", "'" }, /* Sq */
1.12 schwarze 183: { NULL, pre_sm, NULL, NULL, NULL }, /* Sm */
1.3 schwarze 184: { NULL, pre_enc, post_enc, "\\fI", "\\fP" }, /* Sx */
185: { NULL, pre_enc, post_enc, "\\fB", "\\fP" }, /* Sy */
1.9 schwarze 186: { NULL, pre_enc, post_enc, "\\fR", "\\fP" }, /* Tn */
1.8 schwarze 187: { NULL, pre_ux, NULL, "UNIX", NULL }, /* Ux */
1.1 schwarze 188: { NULL, NULL, NULL, NULL, NULL }, /* _Xc */
189: { NULL, NULL, NULL, NULL, NULL }, /* _Xo */
1.17 schwarze 190: { NULL, pre_fo, post_fo, NULL, NULL }, /* Fo */
191: { NULL, NULL, NULL, NULL, NULL }, /* Fc */
1.3 schwarze 192: { cond_body, pre_enc, post_enc, "[", "]" }, /* Oo */
1.9 schwarze 193: { NULL, NULL, NULL, NULL, NULL }, /* Oc */
1.13 schwarze 194: { NULL, pre_bk, post_bk, NULL, NULL }, /* Bk */
195: { NULL, NULL, NULL, NULL, NULL }, /* Ek */
1.8 schwarze 196: { NULL, pre_ux, NULL, "is currently in beta test.", NULL }, /* Bt */
197: { NULL, NULL, NULL, NULL, NULL }, /* Hf */
198: { NULL, NULL, NULL, NULL, NULL }, /* Fr */
199: { NULL, pre_ux, NULL, "currently under development.", NULL }, /* Ud */
1.14 schwarze 200: { NULL, NULL, post_lb, NULL, NULL }, /* Lb */
1.3 schwarze 201: { NULL, pre_pp, NULL, NULL, NULL }, /* Lp */
1.1 schwarze 202: { NULL, NULL, NULL, NULL, NULL }, /* _Lk */
203: { NULL, NULL, NULL, NULL, NULL }, /* _Mt */
1.9 schwarze 204: { cond_body, pre_enc, post_enc, "{", "}" }, /* Brq */
205: { cond_body, pre_enc, post_enc, "{", "}" }, /* Bro */
206: { NULL, NULL, NULL, NULL, NULL }, /* Brc */
1.1 schwarze 207: { NULL, NULL, NULL, NULL, NULL }, /* _%C */
208: { NULL, NULL, NULL, NULL, NULL }, /* _Es */
209: { NULL, NULL, NULL, NULL, NULL }, /* _En */
1.8 schwarze 210: { NULL, pre_ux, NULL, "DragonFly", NULL }, /* Dx */
1.1 schwarze 211: { NULL, NULL, NULL, NULL, NULL }, /* _%Q */
1.3 schwarze 212: { NULL, pre_br, NULL, NULL, NULL }, /* br */
213: { NULL, pre_sp, post_sp, NULL, NULL }, /* sp */
1.1 schwarze 214: { NULL, NULL, NULL, NULL, NULL }, /* _%U */
215: { NULL, NULL, NULL, NULL, NULL }, /* _Ta */
1.3 schwarze 216: { NULL, NULL, NULL, NULL, NULL }, /* ROOT */
1.1 schwarze 217: };
218:
1.20 schwarze 219: static int outflags;
220: #define MMAN_spc (1 << 0)
221: #define MMAN_nl (1 << 1)
1.21 schwarze 222: #define MMAN_br (1 << 2)
223: #define MMAN_sp (1 << 3)
224: #define MMAN_Sm (1 << 4)
225: #define MMAN_Bk (1 << 5)
1.22 schwarze 226: #define MMAN_An_split (1 << 6)
227: #define MMAN_An_nosplit (1 << 7)
1.20 schwarze 228:
1.1 schwarze 229: static void
1.20 schwarze 230: print_word(const char *s)
1.1 schwarze 231: {
1.5 kristaps 232:
1.21 schwarze 233: if ((MMAN_sp | MMAN_br | MMAN_nl) & outflags) {
1.5 kristaps 234: /*
235: * If we need a newline, print it now and start afresh.
236: */
1.21 schwarze 237: if (MMAN_sp & outflags)
238: printf("\n.sp\n");
239: else if (MMAN_br & outflags)
240: printf("\n.br\n");
241: else if (MMAN_nl & outflags)
242: putchar('\n');
243: outflags &= ~(MMAN_sp|MMAN_br|MMAN_nl|MMAN_spc);
1.20 schwarze 244: } else if (MMAN_spc & outflags && '\0' != s[0])
1.5 kristaps 245: /*
246: * If we need a space, only print it before
247: * (1) a nonzero length word;
248: * (2) a word that is non-punctuation; and
249: * (3) if punctuation, non-terminating puncutation.
250: */
1.13 schwarze 251: if (NULL == strchr(".,:;)]?!", s[0]) || '\0' != s[1]) {
1.20 schwarze 252: if (MMAN_Bk & outflags) {
1.13 schwarze 253: putchar('\\');
254: putchar('~');
255: } else
256: putchar(' ');
257: }
1.5 kristaps 258:
259: /*
260: * Reassign needing space if we're not following opening
261: * punctuation.
262: */
1.20 schwarze 263: if (MMAN_Sm & outflags &&
264: (('(' != s[0] && '[' != s[0]) || '\0' != s[1]))
265: outflags |= MMAN_spc;
266: else
267: outflags &= ~MMAN_spc;
1.5 kristaps 268:
1.1 schwarze 269: for ( ; *s; s++) {
270: switch (*s) {
271: case (ASCII_NBRSP):
272: printf("\\~");
273: break;
274: case (ASCII_HYPH):
275: putchar('-');
276: break;
277: default:
1.5 kristaps 278: putchar((unsigned char)*s);
1.1 schwarze 279: break;
280: }
281: }
1.4 kristaps 282: }
283:
1.11 schwarze 284: static void
1.20 schwarze 285: print_offs(const char *v)
1.11 schwarze 286: {
287: char buf[24];
288: struct roffsu su;
289: size_t sz;
290:
291: if (NULL == v || '\0' == *v || 0 == strcmp(v, "left"))
292: sz = 0;
293: else if (0 == strcmp(v, "indent"))
294: sz = 6;
295: else if (0 == strcmp(v, "indent-two"))
296: sz = 12;
297: else if (a2roffsu(v, &su, SCALE_MAX)) {
1.20 schwarze 298: print_word(v);
1.11 schwarze 299: return;
300: } else
301: sz = strlen(v);
302:
303: snprintf(buf, sizeof(buf), "%ldn", sz);
1.20 schwarze 304: print_word(buf);
1.11 schwarze 305: }
306:
1.4 kristaps 307: void
308: man_man(void *arg, const struct man *man)
309: {
310:
1.5 kristaps 311: /*
312: * Dump the keep buffer.
313: * We're guaranteed by now that this exists (is non-NULL).
314: * Flush stdout afterward, just in case.
315: */
1.4 kristaps 316: fputs(mparse_getkeep(man_mparse(man)), stdout);
1.5 kristaps 317: fflush(stdout);
1.1 schwarze 318: }
319:
320: void
321: man_mdoc(void *arg, const struct mdoc *mdoc)
322: {
323: const struct mdoc_meta *m;
324: const struct mdoc_node *n;
325:
326: m = mdoc_meta(mdoc);
327: n = mdoc_node(mdoc);
328:
1.3 schwarze 329: printf(".TH \"%s\" \"%s\" \"%s\" \"%s\" \"%s\"",
1.5 kristaps 330: m->title, m->msec, m->date, m->os, m->vol);
1.1 schwarze 331:
1.20 schwarze 332: outflags = MMAN_nl | MMAN_Sm;
333: print_node(m, n);
1.3 schwarze 334: putchar('\n');
1.1 schwarze 335: }
336:
337: static void
338: print_node(DECL_ARGS)
339: {
340: const struct mdoc_node *prev, *sub;
1.5 kristaps 341: const struct manact *act;
1.1 schwarze 342: int cond, do_sub;
1.5 kristaps 343:
344: /*
345: * Break the line if we were parsed subsequent the current node.
346: * This makes the page structure be more consistent.
347: */
1.1 schwarze 348: prev = n->prev ? n->prev : n->parent;
1.17 schwarze 349: if (prev && prev->line < n->line &&
350: MDOC_Fo != prev->tok && MDOC_Ns != prev->tok)
1.20 schwarze 351: outflags |= MMAN_nl;
1.1 schwarze 352:
1.5 kristaps 353: act = NULL;
1.1 schwarze 354: cond = 0;
355: do_sub = 1;
1.5 kristaps 356:
1.1 schwarze 357: if (MDOC_TEXT == n->type) {
1.5 kristaps 358: /*
359: * Make sure that we don't happen to start with a
360: * control character at the start of a line.
361: */
1.20 schwarze 362: if (MMAN_nl & outflags && ('.' == *n->string ||
1.5 kristaps 363: '\'' == *n->string)) {
1.20 schwarze 364: print_word("\\&");
365: outflags &= ~MMAN_spc;
1.3 schwarze 366: }
1.20 schwarze 367: print_word(n->string);
1.1 schwarze 368: } else {
1.5 kristaps 369: /*
370: * Conditionally run the pre-node action handler for a
371: * node.
372: */
1.1 schwarze 373: act = manacts + n->tok;
1.20 schwarze 374: cond = NULL == act->cond || (*act->cond)(m, n);
1.1 schwarze 375: if (cond && act->pre)
1.20 schwarze 376: do_sub = (*act->pre)(m, n);
1.1 schwarze 377: }
378:
1.5 kristaps 379: /*
380: * Conditionally run all child nodes.
381: * Note that this iterates over children instead of using
382: * recursion. This prevents unnecessary depth in the stack.
383: */
1.1 schwarze 384: if (do_sub)
385: for (sub = n->child; sub; sub = sub->next)
1.20 schwarze 386: print_node(m, sub);
1.1 schwarze 387:
1.5 kristaps 388: /*
389: * Lastly, conditionally run the post-node handler.
390: */
1.1 schwarze 391: if (cond && act->post)
1.20 schwarze 392: (*act->post)(m, n);
1.1 schwarze 393: }
394:
395: static int
396: cond_head(DECL_ARGS)
397: {
1.5 kristaps 398:
1.1 schwarze 399: return(MDOC_HEAD == n->type);
400: }
401:
402: static int
403: cond_body(DECL_ARGS)
404: {
1.5 kristaps 405:
1.1 schwarze 406: return(MDOC_BODY == n->type);
407: }
408:
1.5 kristaps 409: /*
410: * Output a font encoding before a node, e.g., \fR.
411: * This obviously has no trailing space.
412: */
1.1 schwarze 413: static int
414: pre_enc(DECL_ARGS)
415: {
1.5 kristaps 416: const char *prefix;
1.1 schwarze 417:
418: prefix = manacts[n->tok].prefix;
419: if (NULL == prefix)
420: return(1);
1.20 schwarze 421: print_word(prefix);
422: outflags &= ~MMAN_spc;
1.1 schwarze 423: return(1);
424: }
425:
1.5 kristaps 426: /*
427: * Output a font encoding subsequent a node, e.g., \fP.
428: */
1.1 schwarze 429: static void
430: post_enc(DECL_ARGS)
431: {
432: const char *suffix;
433:
434: suffix = manacts[n->tok].suffix;
435: if (NULL == suffix)
436: return;
1.20 schwarze 437: outflags &= ~MMAN_spc;
438: print_word(suffix);
1.10 schwarze 439: if (MDOC_Fl == n->tok && 0 == n->nchild)
1.20 schwarze 440: outflags &= ~MMAN_spc;
1.1 schwarze 441: }
442:
1.5 kristaps 443: /*
444: * Used in listings (percent = %A, e.g.).
445: * FIXME: this is incomplete.
446: * It doesn't print a nice ", and" for lists.
447: */
1.1 schwarze 448: static void
449: post_percent(DECL_ARGS)
450: {
451:
1.20 schwarze 452: post_enc(m, n);
1.1 schwarze 453: if (n->next)
1.20 schwarze 454: print_word(",");
1.1 schwarze 455: else {
1.20 schwarze 456: print_word(".");
457: outflags |= MMAN_nl;
1.1 schwarze 458: }
459: }
460:
1.5 kristaps 461: /*
462: * Print before a section header.
463: */
1.1 schwarze 464: static int
1.3 schwarze 465: pre_sect(DECL_ARGS)
466: {
467:
468: if (MDOC_HEAD != n->type)
469: return(1);
1.20 schwarze 470: outflags |= MMAN_nl;
471: print_word(manacts[n->tok].prefix);
472: print_word("\"");
473: outflags &= ~MMAN_spc;
1.3 schwarze 474: return(1);
475: }
476:
1.5 kristaps 477: /*
478: * Print subsequent a section header.
479: */
1.3 schwarze 480: static void
481: post_sect(DECL_ARGS)
482: {
483:
484: if (MDOC_HEAD != n->type)
485: return;
1.20 schwarze 486: outflags &= ~MMAN_spc;
487: print_word("\"");
488: outflags |= MMAN_nl;
1.22 schwarze 489: if (MDOC_Sh == n->tok && SEC_AUTHORS == n->sec)
490: outflags &= ~(MMAN_An_split | MMAN_An_nosplit);
491: }
492:
1.23 ! schwarze 493: /* See mdoc_term.c, synopsis_pre() for comments. */
! 494: static void
! 495: pre_syn(const struct mdoc_node *n)
! 496: {
! 497:
! 498: if (NULL == n->prev || ! (MDOC_SYNPRETTY & n->flags))
! 499: return;
! 500:
! 501: if (n->prev->tok == n->tok &&
! 502: MDOC_Ft != n->tok &&
! 503: MDOC_Fo != n->tok &&
! 504: MDOC_Fn != n->tok) {
! 505: outflags |= MMAN_br;
! 506: return;
! 507: }
! 508:
! 509: switch (n->prev->tok) {
! 510: case (MDOC_Fd):
! 511: /* FALLTHROUGH */
! 512: case (MDOC_Fn):
! 513: /* FALLTHROUGH */
! 514: case (MDOC_Fo):
! 515: /* FALLTHROUGH */
! 516: case (MDOC_In):
! 517: /* FALLTHROUGH */
! 518: case (MDOC_Vt):
! 519: outflags |= MMAN_sp;
! 520: break;
! 521: case (MDOC_Ft):
! 522: if (MDOC_Fn != n->tok && MDOC_Fo != n->tok) {
! 523: outflags |= MMAN_sp;
! 524: break;
! 525: }
! 526: /* FALLTHROUGH */
! 527: default:
! 528: outflags |= MMAN_br;
! 529: break;
! 530: }
! 531: }
! 532:
1.22 schwarze 533: static int
534: pre_an(DECL_ARGS)
535: {
536:
537: switch (n->norm->An.auth) {
538: case (AUTH_split):
539: outflags &= ~MMAN_An_nosplit;
540: outflags |= MMAN_An_split;
541: return(0);
542: case (AUTH_nosplit):
543: outflags &= ~MMAN_An_split;
544: outflags |= MMAN_An_nosplit;
545: return(0);
546: default:
547: if (MMAN_An_split & outflags)
548: outflags |= MMAN_br;
549: else if (SEC_AUTHORS == n->sec &&
550: ! (MMAN_An_nosplit & outflags))
551: outflags |= MMAN_An_split;
552: return(1);
553: }
1.3 schwarze 554: }
555:
556: static int
557: pre_ap(DECL_ARGS)
558: {
559:
1.20 schwarze 560: outflags &= ~MMAN_spc;
561: print_word("'");
562: outflags &= ~MMAN_spc;
1.3 schwarze 563: return(0);
564: }
565:
566: static int
567: pre_bd(DECL_ARGS)
568: {
569:
1.21 schwarze 570: if (0 == n->norm->Bd.comp)
571: outflags |= MMAN_sp;
1.3 schwarze 572: if (DISP_unfilled == n->norm->Bd.type ||
573: DISP_literal == n->norm->Bd.type) {
1.20 schwarze 574: outflags |= MMAN_nl;
575: print_word(".nf");
1.3 schwarze 576: }
1.20 schwarze 577: outflags |= MMAN_nl;
578: print_word(".RS");
579: print_offs(n->norm->Bd.offs);
580: outflags |= MMAN_nl;
1.3 schwarze 581: return(1);
582: }
583:
584: static void
585: post_bd(DECL_ARGS)
586: {
587:
1.20 schwarze 588: outflags |= MMAN_nl;
589: print_word(".RE");
1.3 schwarze 590: if (DISP_unfilled == n->norm->Bd.type ||
591: DISP_literal == n->norm->Bd.type) {
1.20 schwarze 592: outflags |= MMAN_nl;
593: print_word(".fi");
1.3 schwarze 594: }
1.20 schwarze 595: outflags |= MMAN_nl;
1.13 schwarze 596: }
597:
598: static int
599: pre_bk(DECL_ARGS)
600: {
601:
602: switch (n->type) {
603: case (MDOC_BLOCK):
604: return(1);
605: case (MDOC_BODY):
1.20 schwarze 606: outflags |= MMAN_Bk;
1.13 schwarze 607: return(1);
608: default:
609: return(0);
610: }
611: }
612:
613: static void
614: post_bk(DECL_ARGS)
615: {
616:
617: if (MDOC_BODY == n->type)
1.20 schwarze 618: outflags &= ~MMAN_Bk;
1.3 schwarze 619: }
620:
621: static int
622: pre_br(DECL_ARGS)
623: {
624:
1.21 schwarze 625: outflags |= MMAN_br;
1.3 schwarze 626: return(0);
627: }
628:
629: static int
1.8 schwarze 630: pre_bx(DECL_ARGS)
631: {
632:
633: n = n->child;
634: if (n) {
1.20 schwarze 635: print_word(n->string);
636: outflags &= ~MMAN_spc;
1.8 schwarze 637: n = n->next;
638: }
1.20 schwarze 639: print_word("BSD");
1.8 schwarze 640: if (NULL == n)
641: return(0);
1.20 schwarze 642: outflags &= ~MMAN_spc;
643: print_word("-");
644: outflags &= ~MMAN_spc;
645: print_word(n->string);
1.8 schwarze 646: return(0);
647: }
648:
649: static int
1.1 schwarze 650: pre_dl(DECL_ARGS)
651: {
652:
1.20 schwarze 653: outflags |= MMAN_nl;
654: print_word(".RS 6n");
655: outflags |= MMAN_nl;
1.1 schwarze 656: return(1);
657: }
658:
659: static void
660: post_dl(DECL_ARGS)
661: {
662:
1.20 schwarze 663: outflags |= MMAN_nl;
664: print_word(".RE");
665: outflags |= MMAN_nl;
1.16 schwarze 666: }
667:
668: static int
1.17 schwarze 669: pre_fa(DECL_ARGS)
670: {
671:
672: if (MDOC_Fa == n->tok)
673: n = n->child;
674:
675: while (NULL != n) {
1.20 schwarze 676: print_word("\\fI");
677: outflags &= ~MMAN_spc;
678: print_node(m, n);
679: outflags &= ~MMAN_spc;
680: print_word("\\fP");
1.17 schwarze 681: if (NULL != (n = n->next))
1.20 schwarze 682: print_word(",");
1.17 schwarze 683: }
684: return(0);
685: }
686:
687: static void
688: post_fa(DECL_ARGS)
689: {
690:
691: if (NULL != n->next && MDOC_Fa == n->next->tok)
1.20 schwarze 692: print_word(",");
1.17 schwarze 693: }
694:
695: static int
1.16 schwarze 696: pre_fn(DECL_ARGS)
697: {
698:
1.23 ! schwarze 699: pre_syn(n);
! 700:
1.16 schwarze 701: n = n->child;
702: if (NULL == n)
703: return(0);
704:
1.20 schwarze 705: print_word("\\fB");
706: outflags &= ~MMAN_spc;
707: print_node(m, n);
708: outflags &= ~MMAN_spc;
709: print_word("\\fP(");
710: outflags &= ~MMAN_spc;
711: return(pre_fa(m, n->next));
1.16 schwarze 712: }
713:
714: static void
715: post_fn(DECL_ARGS)
716: {
717:
1.20 schwarze 718: print_word(")");
1.16 schwarze 719: if (MDOC_SYNPRETTY & n->flags) {
1.20 schwarze 720: print_word(";");
1.21 schwarze 721: outflags |= MMAN_br;
1.17 schwarze 722: }
723: }
724:
725: static int
726: pre_fo(DECL_ARGS)
727: {
728:
729: switch (n->type) {
1.23 ! schwarze 730: case (MDOC_BLOCK):
! 731: pre_syn(n);
! 732: break;
1.17 schwarze 733: case (MDOC_HEAD):
1.20 schwarze 734: print_word("\\fB");
735: outflags &= ~MMAN_spc;
1.17 schwarze 736: break;
737: case (MDOC_BODY):
1.20 schwarze 738: outflags &= ~MMAN_spc;
739: print_word("(");
740: outflags &= ~MMAN_spc;
1.17 schwarze 741: break;
742: default:
743: break;
744: }
745: return(1);
746: }
747:
748: static void
749: post_fo(DECL_ARGS)
750: {
751:
752: switch (n->type) {
753: case (MDOC_HEAD):
1.20 schwarze 754: outflags &= ~MMAN_spc;
755: print_word("\\fP");
1.17 schwarze 756: break;
757: case (MDOC_BODY):
1.20 schwarze 758: post_fn(m, n);
1.17 schwarze 759: break;
760: default:
761: break;
1.16 schwarze 762: }
1.15 schwarze 763: }
764:
765: static int
1.23 ! schwarze 766: pre_ft(DECL_ARGS)
! 767: {
! 768:
! 769: pre_syn(n);
! 770: print_word("\\fI");
! 771: outflags &= ~MMAN_spc;
! 772: return(1);
! 773: }
! 774:
! 775: static int
1.15 schwarze 776: pre_in(DECL_ARGS)
777: {
778:
779: if (MDOC_SYNPRETTY & n->flags) {
1.23 ! schwarze 780: pre_syn(n);
1.20 schwarze 781: print_word("\\fB#include <");
1.15 schwarze 782: } else
1.20 schwarze 783: print_word("<\\fI");
784: outflags &= ~MMAN_spc;
1.15 schwarze 785: return(1);
786: }
787:
788: static void
789: post_in(DECL_ARGS)
790: {
791:
1.20 schwarze 792: outflags &= ~MMAN_spc;
1.15 schwarze 793: if (MDOC_SYNPRETTY & n->flags) {
1.20 schwarze 794: print_word(">\\fP");
1.21 schwarze 795: outflags |= MMAN_br;
1.15 schwarze 796: } else
1.20 schwarze 797: print_word("\\fP>");
1.1 schwarze 798: }
799:
800: static int
801: pre_it(DECL_ARGS)
802: {
803: const struct mdoc_node *bln;
804:
805: if (MDOC_HEAD == n->type) {
1.20 schwarze 806: outflags |= MMAN_nl;
807: print_word(".TP");
1.1 schwarze 808: bln = n->parent->parent->prev;
1.3 schwarze 809: switch (bln->norm->Bl.type) {
810: case (LIST_bullet):
1.20 schwarze 811: print_word("4n");
812: outflags |= MMAN_nl;
813: print_word("\\fBo\\fP");
1.3 schwarze 814: break;
815: default:
816: if (bln->norm->Bl.width)
1.20 schwarze 817: print_word(bln->norm->Bl.width);
1.3 schwarze 818: break;
819: }
1.20 schwarze 820: outflags |= MMAN_nl;
1.1 schwarze 821: }
822: return(1);
1.14 schwarze 823: }
824:
825: static void
826: post_lb(DECL_ARGS)
827: {
828:
1.21 schwarze 829: if (SEC_LIBRARY == n->sec)
830: outflags |= MMAN_br;
1.1 schwarze 831: }
832:
833: static int
834: pre_nm(DECL_ARGS)
835: {
836:
1.23 ! schwarze 837: if (MDOC_BLOCK == n->type)
! 838: pre_syn(n);
1.1 schwarze 839: if (MDOC_ELEM != n->type && MDOC_HEAD != n->type)
840: return(1);
1.23 ! schwarze 841: if (NULL == n->child && NULL == m->name)
! 842: return(0);
1.20 schwarze 843: print_word("\\fB");
844: outflags &= ~MMAN_spc;
1.1 schwarze 845: if (NULL == n->child)
1.20 schwarze 846: print_word(m->name);
1.1 schwarze 847: return(1);
848: }
849:
850: static void
851: post_nm(DECL_ARGS)
852: {
853:
854: if (MDOC_ELEM != n->type && MDOC_HEAD != n->type)
855: return;
1.20 schwarze 856: outflags &= ~MMAN_spc;
857: print_word("\\fP");
1.1 schwarze 858: }
859:
860: static int
861: pre_ns(DECL_ARGS)
862: {
863:
1.20 schwarze 864: outflags &= ~MMAN_spc;
1.1 schwarze 865: return(0);
866: }
867:
1.3 schwarze 868: static void
869: post_pf(DECL_ARGS)
870: {
871:
1.20 schwarze 872: outflags &= ~MMAN_spc;
1.3 schwarze 873: }
874:
1.1 schwarze 875: static int
876: pre_pp(DECL_ARGS)
877: {
878:
1.20 schwarze 879: outflags |= MMAN_nl;
1.1 schwarze 880: if (MDOC_It == n->parent->tok)
1.20 schwarze 881: print_word(".sp");
1.1 schwarze 882: else
1.20 schwarze 883: print_word(".PP");
884: outflags |= MMAN_nl;
1.10 schwarze 885: return(MDOC_Rs == n->tok);
1.12 schwarze 886: }
887:
888: static int
889: pre_sm(DECL_ARGS)
890: {
891:
892: assert(n->child && MDOC_TEXT == n->child->type);
893: if (0 == strcmp("on", n->child->string))
1.20 schwarze 894: outflags |= MMAN_Sm;
1.12 schwarze 895: else
1.20 schwarze 896: outflags &= ~MMAN_Sm;
1.12 schwarze 897: return(0);
1.1 schwarze 898: }
899:
900: static int
1.3 schwarze 901: pre_sp(DECL_ARGS)
1.1 schwarze 902: {
903:
1.20 schwarze 904: outflags |= MMAN_nl;
905: print_word(".sp");
1.1 schwarze 906: return(1);
907: }
908:
909: static void
1.3 schwarze 910: post_sp(DECL_ARGS)
1.1 schwarze 911: {
912:
1.20 schwarze 913: outflags |= MMAN_nl;
1.18 schwarze 914: }
915:
916: static int
917: pre_vt(DECL_ARGS)
918: {
919:
920: if (MDOC_SYNPRETTY & n->flags) {
921: switch (n->type) {
922: case (MDOC_BLOCK):
1.23 ! schwarze 923: pre_syn(n);
1.18 schwarze 924: return(1);
925: case (MDOC_BODY):
926: break;
927: default:
928: return(0);
929: }
930: }
1.20 schwarze 931: print_word("\\fI");
932: outflags &= ~MMAN_spc;
1.18 schwarze 933: return(1);
934: }
935:
936: static void
937: post_vt(DECL_ARGS)
938: {
939:
1.19 schwarze 940: if (MDOC_SYNPRETTY & n->flags && MDOC_BODY != n->type)
1.18 schwarze 941: return;
942:
1.20 schwarze 943: outflags &= ~MMAN_spc;
944: print_word("\\fP");
1.1 schwarze 945: }
946:
947: static int
948: pre_xr(DECL_ARGS)
949: {
950:
951: n = n->child;
952: if (NULL == n)
953: return(0);
1.20 schwarze 954: print_node(m, n);
1.1 schwarze 955: n = n->next;
956: if (NULL == n)
957: return(0);
1.20 schwarze 958: outflags &= ~MMAN_spc;
959: print_word("(");
960: print_node(m, n);
961: print_word(")");
1.1 schwarze 962: return(0);
1.8 schwarze 963: }
964:
965: static int
966: pre_ux(DECL_ARGS)
967: {
968:
1.20 schwarze 969: print_word(manacts[n->tok].prefix);
1.8 schwarze 970: if (NULL == n->child)
971: return(0);
1.20 schwarze 972: outflags &= ~MMAN_spc;
973: print_word("\\~");
974: outflags &= ~MMAN_spc;
1.8 schwarze 975: return(1);
1.1 schwarze 976: }
CVSweb