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