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